#ecs-deploy Deploy container images to Amazon EC2 Container Service (ECS).

Configuration

Unless indicated, the following environment variables are required:

Environment Variable	Description
AWS_ACCESS_KEY_ID	AWS credentials
AWS_SECRET_ACCESS_KEY	AWS credentials
AWS_SESSION_TOKEN	(Optional) AWS credentials
REGION	The AWS region
CLUSTER	The name of the target ECS cluster
SERVICE	The name of the target ECS service
CONTAINER	The name of the target ECS container
IMAGE	The image repository (e.g. some-user/some-app)
IMAGE_TAG	The tag to be deployed
WAIT	Wait until the service has reached a stable state (defaults to false)

Example Usage

npm install --global ecs-deploy
REGION=us-west-1 CLUSTER=my-cluster SERVICE=my-service CONTAINER=my-container IMAGE=my-user/my-repo IMAGE_TAG=latest WAIT=true ecs-deploy

Alternate Usage

Install from the command line:

npm install --save-dev ecs-deploy

Add a deploy script to your package.json:

{
  "scripts": {
    "deploy": "REGION=us-west-1 CLUSTER=my-cluster SERVICE=my-service CONTAINER=my-container IMAGE=my-user/my-repo ecs-deploy"
  }
}

When you're ready to deploy, make sure your image has been pushed to the registry. Then from the command line:

IMAGE_TAG=latest npm run deploy