isabella232 / aws-ecs-orb

An orb that simplifies deployment to Amazon's Elastic Container Service (ECS). Supports both EC2 and Fargate launch types.

AWS ECS Orb

A CircleCI Orb to simplify deployments to Amazon Elastic Container Service (ECS). It supports EC2 and Fargate launch type deployments.

CircleCI orbs registry page: https://circleci.com/orbs/registry/orb/circleci/aws-ecs

Features

This orb allows convenient updating of ECS services when only the Docker image name/tag and/or environment variables in a service's container definitions need to be updated. A sample project that demonstrates using the orb is available on this GitHub repository branch: https://github.com/CircleCI-Public/circleci-demo-aws-ecs-ecr

Usage

See the orb registry listing for usage guidelines.

Requirements

• python should be available in PATH. Supported versions are Python 2 version 2.7.1 and above and Python 3 version 3.4.9 and above.
• The aws CLI should be available in PATH. Otherwise, pip is required to be available as the job will then attempt to install aws via pip. The default profile of aws will be used.
• bash to be present in /bin/bash. Otherwise, /bin/sh will be used, but the orb has not been tested for compatibility with other shells.

Example

version: 2.1

orbs:
  aws-cli: circleci/[email protected]
  aws-ecs: circleci/[email protected]

jobs:
  update-tag:
    docker:
      - image: circleci/python:3.7.1
    steps:
      - aws-cli/install
      - aws-cli/configure:
          aws-access-key-id: "$AWS_ACCESS_KEY_ID"
          aws-region: "$AWS_REGION"
      - aws-ecs/update-service:
          family: "${MY_APP_PREFIX}-service"
          cluster-name: "${MY_APP_PREFIX}-cluster"
          container-image-name-updates: "container=${MY_APP_PREFIX}-service,tag=stable"
workflows:
  deploy:
    jobs:
      - update-tag

Contributing

We welcome issues to and pull requests against this repository!

For further questions/comments about this or other orbs, visit CircleCI's orbs discussion forum.