项目作者: devteds

项目描述 :
Docker on Amazon ECS with AWS Fargate using CloudFormation. https://devteds.com/episodes/9-docker-on-amazon-ecs-using-cloudformation
高级语言: Shell
项目地址: git://github.com/devteds/e9-cloudformation-docker-ecs.git
创建时间: 2018-08-04T00:32:44Z
项目社区:https://github.com/devteds/e9-cloudformation-docker-ecs

开源协议:

下载


Docker on Amazon ECS using AWS CloudFormation & CLI

Devteds Episode #9

Create and run docker container on Amazon ECS using CloudFormation and CLI.

  • Containerize a simple REST API application
  • Use AWS CLI to create Amazon ECR repository
  • Build docker image and push to ECR
  • CloudFormation stack to create VPC, Subnets, InternetGateway etc
  • CloudFormation stack to create IAM role
  • CloudFormation stack to create ECS Cluster, Loadbalancer & Listener, Security groups etc
  • CloudFormation stack to deploy docker container

Episode video link

Episode Video Link

Visit https://devteds.com to watch all the episodes

Announcement: Course on Kubernetes

If you’re want to start deploying your containers to Kubernetes, especially on AWS EKS, check this course on Kubernetes that walkthrough creating Kubernetes cluster on AWS EKS using Terraform and deploying multiple related containers applications to Kubernetes and more. https://courses.devteds.com/kubernetes-get-started

Terminal Window Logs

Code

  1. mkdir ~/projs
  2. git clone https://github.com/devteds/e9-cloudformation-docker-ecs.git docker-on-ecs
  3. cd docker-on-ecs

Dockerize a simple app

  1. # Run on local
  2. docker build -t books-api ./app/
  3. docker run -it -p 4567:4567 --rm books-api:latest
  4. open http://localhost:4567/
  5. open http://localhost:4567/stat
  6. open http://localhost:4567/api/books

Push Docker Image to ECR

  1. aws ecr create-repository --repository-name books-api
  2. aws ecr get-login --no-include-email | sh
  3. IMAGE_REPO=$(aws ecr describe-repositories --repository-names books-api --query 'repositories[0].repositoryUri' --output text)
  4. docker tag books-api:latest $IMAGE_REPO:v1
  5. docker push $IMAGE_REPO:v1

Create CloudFormation Stacks

  1. aws cloudformation create-stack --template-body file://$PWD/infra/vpc.yml --stack-name vpc
  2. aws cloudformation create-stack --template-body file://$PWD/infra/iam.yml --stack-name iam --capabilities CAPABILITY_IAM
  3. aws cloudformation create-stack --template-body file://$PWD/infra/app-cluster.yml --stack-name app-cluster
  4. # Edit the api.yml to update Image tag/URL under Task > ContainerDefinitions and,
  5. aws cloudformation create-stack --template-body file://$PWD/infra/api.yml --stack-name api

Copy the BooksApiEndpoint value from api stack output on AWS Management Console. Make a request to that URL on browser or any REST client.

Need to deploy app changes?

There isn’t a cleaner way to deploy application changes (container) with CloudFormation, especially if you prefer the same image tag (eg: latest, green, prod etc). There are a few different options,

  • Use new image tag and pass that as parameter to CF stack (api.yml) to update-stack or deploy. Many don’t prefer using new revision number for as tag.
  • With CloudFormation, some prefer create-stack & delete-stack to manage zero-downtime blue-green deployments, not specifically for ECS. ECS does part of this but this is an option
  • Use ECS-CLI if you like Docker Compose structure to define container services. This is interesting but I am not sure this is really useful.
  • A little hack to register a new task definition revision and update the service using CLI. Refer the ./deploy_app.sh script.
  1. # ./deploy_app.sh <CLUSTER NAME> <SERVICE NAME> <TASK FAMILY>
  2. ./deploy_app.sh bookstore books-service apis
  3. # One executed, ECS Service update will take a few minutes for the new task / container go live

References

Find the resources and references on https://devteds.com/episodes/9-docker-on-amazon-ecs-using-cloudformation