ecs-local

Run ECS task definitions locally.

What is ecs-local?

How it works

1. Logs into AWS ECS and retrieves the task definition, image, and port mappings
2. Logs into docker and pulls the image
3. Parses the task definition to extract the entry point, command, volume mounts, and environment variables
4. Set the docker argument for the: entry point
5. Set the docker argument for the: command
6. Set the docker arguments for the: volume mounts
7. Set the docker arguments for the: environment variables
8. Runs the docker command with the set docker arguments to start the container

Use Cases

Usage

ecs-local -e SOME_VAR=FOO-t stage-accounts -m src:dest -c ecs-local-config.yaml -a '/bin/bash'

Installation

macOS

brew tap fullscreen/tap
brew install ecs-local

Caveats

Network Access

This utility creates docker containers on your local machine based off of task definitions in ECS.
As a result the spawned task may not have the same network access as the remote ECS task.

Assuming Roles

ecs-local will attempt to assume the role of the specified task.
If it is unable to do so it will fail silently and a warning message will be printed if the verbose flag is passed.

Releases

This repository makes use of GoReleaser for building and pushing the Homebrew formula to the Homebrew Tap at: https://github.com/Fullscreen/homebrew-tap

References

• Homebrew Documentation

Terminology

Homebrew