lambda-image-colors

An example AWS Lambda written in GoLang to tag a picture with its prominent colors

About

This repository implements an AWS Lambda using Go that allows you to tag JPEG images in an S3 bucket with their prominent colors from a given palette.

The goal of this project is to act as a tutorial to learn how to build, test and deploy AWS Lambdas written in Go.

This work is kindly sponsored by Buddy.works.

Getting started

Requirements

In order to run this example you need:

• Go (1.12+)
• Terraform (0.11+)
• Docker (18.09+)
• Docker-compose (1.23+)
• GNU make
• An AWS account (with AWS cli installed and configured)

Folders

• Lambda source code can be found in cmd/image-colors-lambda
• Terraform code for stack definition can be found in stack
• Integration tests (using docker-compose) can be found in tests

Test and build

To test the application you can run:

make test

This will run:

• Linting checks
• Unit tests
• Integration tests

Deployment

In order to deploy this solution to your default AWS account you can run:

make deploy

Read the full tutorial

Yet to be published, stay tuned!

Contributing

Everyone is very welcome to contribute to this project. You can contribute just by submitting bugs or suggesting improvements by opening an issue on GitHub.

License

Licensed under MIT License. © Luciano Mammino.