https://github.com/lmammino/lambda-image-colors

An example AWS Lambda written in GoLang to tag a picture with its prominent colors
https://github.com/lmammino/lambda-image-colors

aws-lambda aws-lambda-golang go golang image image-processing lambda s3 tutorial

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/lmammino/lambda-image-colors
• Owner: lmammino
• License: mit
• Created: 2019-04-08T20:52:13.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-02-24T18:18:27.000Z (almost 2 years ago)
• Last Synced: 2024-10-04T15:42:14.039Z (3 months ago)
• Topics: aws-lambda, aws-lambda-golang, go, golang, image, image-processing, lambda, s3, tutorial
• Language: Python
• Homepage:
• Size: 1.93 MB
• Stars: 7
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# lambda-image-colors

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

[![buddy pipeline](https://app.buddy.works/lucianomammino/lambda-image-colors/pipelines/pipeline/184112/badge.svg?token=c36f5f6c44fbf89b0e46f07e81533fc6015dd8a58c666de0e8c2c7c9e4bc73c3 "buddy pipeline")](https://app.buddy.works/lucianomammino/lambda-image-colors/pipelines/pipeline/184112)

## 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.

![Lambda trigger schema](/images/lambda-trigger.png)

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](https://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`](/cmd/image-colors-lambda)

- Terraform code for stack definition can be found in [`stack`](/stack)

- Integration tests (using `docker-compose`) can be found in [`tests`](/tests)

## Test and build

To test the application you can run:

```bash

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:

```bash

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](https://github.com/lmammino/lambda-image-colors/issues).

## License

Licensed under [MIT License](LICENSE). © Luciano Mammino.