AWS ECS Deployment Tool
Latest commit 44315ac Nov 13, 2018

README.md

UFO - ECS Deployment Tool

CircleCI Join the chat at https://gitter.im/tongueroo/ufo Support

Ufo is a tool that builds Docker images and deploys them to AWS ECS. The main command is ufo ship. Here's summary of what it does:

  1. Builds a docker image. 
  2. Generates and registers the ECS template definition. 
  3. Deploys the ECS template definition to the ECS service.

Ufo deploys a task definition that is written in a templating language that is easily and fully controllable.

See ufoships.com for full documentation.

Important

If you are on version 3, you can run ufo upgrade v3to4 within your project to upgrade it to version 4. Refer to the CHANGELOG and the Upgrade 4 Docs.

Installation

gem install ufo

Full installation instructions are at Install Ufo.

Quick Start

To quickly demonstrate how simple it is to use ufo we will use an example app from tongueroo/demo-ufo. The app is a barebones sinatra app. Here are the steps:

gem install ufo
git clone https:///github.com/tongueroo/demo-ufo.git demo
cd demo
ufo init --image=tongueroo/demo-ufo
ufo ship demo-web

Congratulations, you have successfully used ufo to deploy to an ECS service.

Load Balancer Support

Ufo can also create a load balancer as part of creating the ECS service if you wish. Underneath the hood, ufo uses CloudFormation to create the load balancer. More information can be found at the load balancer support docs.

Articles

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/tongueroo/ufo/issues.

QA Checklist

QA Checklist is a good list of things to check.