README.md

🚀 Go Serverless!

An accompanying example project to the Conf42: Golang 2022 presentation by Savas Ziplies.

A scaffold to deploy Golang framework-driven Serverless functions to AWS.

Pre-requisites

• AWS CLI already configured with required permissions
• Docker installed
• Golang
• SAM CLI

Quickstart

To run/test locally:

• Run docker-compose up -d timescaledb-postgis localstack
• (Optional) Create a local queue in localstack for testing: aws --endpoint-url=http://localhost:4566 sqs create-queue --queue-name goserverless-queue-dev
• Copy .env.example to .env
• Run the single commands or deploy

Deploy

• cd .build/aws
• sam build
• sam deploy --guided for a first time deployment

Running

• The "api" cmd: go build github.com/elipzis/go-serverless/api
• The "queue" cmd: go build github.com/elipzis/go-serverless/queue
• The "web" cmd: go build github.com/elipzis/go-serverless/web

Tech Stack

The main tech stack contains of

• AWS SAM
• Golang
• Docker
• Postgres
• AWS SQS
• Fiber
• AWS Lambda
• Chromium

Credits

• elipZis GmbH
• NeA
• All Contributors

Thanks

Thanks to Conf42 for having me :)

• Web - Conf42
• LinkedIn - @conf42
• Twitter - @conf42com

License

The MIT License (MIT). Please see License File for more information.