[Introduction to Docker x ECS] ECS deployment with docker compose up

Docker's ECS Plugin has been released, and it seems that it also supports the stable version of Docker for Mac, so I tried it.

There are official documents and commentary sites, but there were some stumbling blocks, so (Unknowingly, the docker ecs compose command has been integrated into docker compose ...) I summarized it as a memo for ECS beginners.

Verification environment

Version 2 is required for AWS CLI. We recommend that you update both Docker and AWS CLI to the latest version.

Reference link: AWS CLI Settings Installing, updating, and uninstalling AWS CLI version 2 on macOS

Docker image preparation

This time, I will use Docker official sample. First, check the operation locally. It is almost written in Official Doc, but as a memo for myself, it is a Docker official sample. I will explain the procedure of.

--Pull Docker official sample

$ git clone https://github.com/docker/ecs-plugin.git
$ cd ecs-plugin/example/

--Tag with the name example and build the app directory

$ docker build app -t example

--Specify a tag and confirm that the image has been created

$ docker images --filter reference=example
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
example             latest              33e46b7030e0        4 minutes ago       52.3MB

--Local operation check

$ docker run -t -i -p 5000:5000 example
Running on (Press CTRL+C to quit)

Try accessing Because redis is not running redis.exceptions.ConnectionError Should occur. Exit with CTRL + C.

Setup with Amazon ECR

Amazon ECR is like Docker Hub. Push the created Docker image to ECR and pull it when using docker-compose.


$ docker context use default
$ docker context ls

IAM user preparation

This also creates an IAM user according to Official Doc .. Follow the steps to create it with the name "Administrator". When you sign in as the IAM user you created, "Administrator @ aws_account_id" is displayed in the navigation bar. ex. [email protected]

Make a note of the credentials as you will use them later. aws_account_id aws_access_key_id aws_secret_access_key

Authenticate to the default registry from the console

In my case, I use the Tokyo region (ap-northeast-1). Enter the aws_account_id confirmed in the navigation bar in [aws_account_id] without hyphens. ex. 1234-5678-9012 => 123456789012

$ aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin [aws_account_id].dkr.ecr.ap-northeast-1.amazonaws.com
Login Succeeded

Create repository

Now that you have an image to push to Amazon ECR, create a repository to hold it. Create a repository called example: latest and push the example image you just created.

--Create a repository

$ aws ecr create-repository \
		--repository-name example \
		--image-scanning-configuration scanOnPush=true \
		--region ap-northeast-1 

--Tagging images to push to the repository

$ docker tag example:latest [aws_account_id].dkr.ecr.ap-northeast-1.amazonaws.com/example:latest

--Push the image

$ docker push [aws_account_id].dkr.ecr.ap-northeast-1.amazonaws.com/example:latest
$ aws ecr list-images --repository-name example

docker-compose Local operation check

Pull the image pushed to ECR and check the operation locally. Make sure you can push the image to ERC. Open the Amazon ECR console (https://console.aws.amazon.com/ecr/). The example repository should have been created.

スクリーンショット 2020-10-30 13.01.54.png

Copy the URL. Paste it into the image in docker-compose.yml and docker-compose up. comment out x-aws-pull_credentials as they are not needed this time.


version: "3.8"
    build: app
    # x-aws-pull_credentials: <<<your arn for your secret you can get with docker ecs secret list>>>
    image: 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/example:latest
      - "5000:5000"
      - backend
    image: redis:alpine
$ docker-compose up

You can pull the image pushed to ECR, so you can check the operation of the app locally.

スクリーンショット 2020-10-30 13.09.57.png

I was able to confirm the operation of redis.

$ docker-compose down

Deploy to ECS

AWS Context creation

As per docker docs (translation), create it with the name myecscontext. Use the credentials you created in IAM earlier. aws_access_key_id aws_secret_access_key

$ docker context create ecs myecscontext
? Select AWS Profile new profile
? profile name myecscontext
? Region ap-northeast-1
? Enter credentials Yes
? AWS Access Key ID aws_access_key_id
? Enter AWS Secret Access Key aws_secret_access_key
Successfully created ecs context "myecscontext"

Check context

$ docker context ls
NAME                TYPE                DESCRIPTION                               DOCKER ENDPOINT               KUBERNETES ENDPOINT   ORCHESTRATOR
default *           moby                Current DOCKER_HOST based configuration   unix:///var/run/docker.sock                         swarm
myecscontext        ecs                 ap-northeast-1                 

Use myecscontext

$ docker context use myecscontext
this tool requires the "new ARN resource ID format"

It looks like you need to enable the long ARN format. I think it's magic and execute it.

$ aws ecs put-account-setting-default --name awsvpcTrunking --value enabled
$ aws ecs put-account-setting-default --name containerInsights --value enabled
$ aws ecs put-account-setting-default --name containerInstanceLongArnFormat --value enabled
$ aws ecs put-account-setting-default --name serviceLongArnFormat --value enabled
$ aws ecs put-account-setting-default --name taskLongArnFormat --value enabled

Deploy to ECS

It's finally ECS, but it's over in an instant. When docker compose up, resources are automatically created and deployed.

$ docker compose up
WARN[0000] services.build: unsupported attribute        
[+] Running 17/17
 ⠿ example                        CREATE_COMPLETE                                                                                                          204.0s
 ⠿ ExampleLoadBalancer            CREATE_COMPLETE                                                                                                          122.0s
 ⠿ FrontendTCP5000TargetGroup     CREATE_COMPLETE                                                                                                            1.0s
 ⠿ CloudMap                       CREATE_COMPLETE                                                                                                           51.0s
 ⠿ FrontendTaskExecutionRole      CREATE_COMPLETE                                                                                                           22.0s
 ⠿ LogGroup                       CREATE_COMPLETE                                                                                                            3.0s
 ⠿ ExampleDefaultNetwork          CREATE_COMPLETE                                                                                                            8.0s
 ⠿ Cluster                        CREATE_COMPLETE                                                                                                            6.0s
 ⠿ BackendTaskExecutionRole       CREATE_COMPLETE                                                                                                           21.0s
 ⠿ ExampleDefaultNetworkIngress   CREATE_COMPLETE                                                                                                            1.0s
 ⠿ FrontendTaskDefinition         CREATE_COMPLETE                                                                                                            3.0s
 ⠿ BackendTaskDefinition          CREATE_COMPLETE                                                                                                            4.0s
 ⠿ FrontendServiceDiscoveryEntry  CREATE_COMPLETE                                                                                                            3.0s
 ⠿ BackendServiceDiscoveryEntry   CREATE_COMPLETE                                                                                                            1.9s
 ⠿ BackendService                 CREATE_COMPLETE                                                                                                           68.0s
 ⠿ FrontendTCP5000Listener        CREATE_COMPLETE                                                                                                            1.0s
 ⠿ FrontendService                CREATE_COMPLETE                                                                                                           68.0s

Check the deployed app

Check the status of the running container.

$ docker compose ps
ID                                     NAME                REPLICAS            PORTS
example-BackendService-xSDWkSABSvEt    backend             1/1                 
example-FrontendService-0pIz1giwUZg4   frontend            1/1                 ExampleLoadBalancer-29dbd0f98418a861.elb.ap-northeast-1.amazonaws.com:5000->5000/tcp

Try accessing the frontend PORTS. I think you have deployed the sample app. http://ExampleLoadBalancer-29dbd0f98418a861.elb.ap-northeast-1.amazonaws.com:5000/

Delete deployed resources

If you docker compose down, the resource will be deleted automatically.

$ docker compose down
[+] Running 17/17
 ⠿ example                        DELETE_COMPLETE                                                                                                                515.0s
 ⠿ ExampleLoadBalancer            DELETE_COMPLETE                                                                                                                389.0s
 ⠿ FrontendTCP5000TargetGroup     DELETE_COMPLETE                                                                                                                389.0s
 ⠿ CloudMap                       DELETE_COMPLETE                                                                                                                514.0s
 ⠿ FrontendTaskExecutionRole      DELETE_COMPLETE                                                                                                                393.0s
 ⠿ LogGroup                       DELETE_COMPLETE                                                                                                                471.0s
 ⠿ ExampleDefaultNetwork          DELETE_COMPLETE                                                                                                                467.0s
 ⠿ Cluster                        DELETE_COMPLETE                                                                                                                467.0s
 ⠿ BackendTaskExecutionRole       DELETE_COMPLETE                                                                                                                472.0s
 ⠿ ExampleDefaultNetworkIngress   DELETE_COMPLETE                                                                                                                  3.0s
 ⠿ FrontendTaskDefinition         DELETE_COMPLETE                                                                                                                390.0s
 ⠿ BackendTaskDefinition          DELETE_COMPLETE                                                                                                                467.0s
 ⠿ FrontendServiceDiscoveryEntry  DELETE_COMPLETE                                                                                                                389.0s
 ⠿ BackendServiceDiscoveryEntry   DELETE_COMPLETE                                                                                                                467.0s
 ⠿ BackendService                 DELETE_COMPLETE                                                                                                                464.0s
 ⠿ FrontendTCP5000Listener        DELETE_COMPLETE                                                                                                                388.0s
 ⠿ FrontendService                DELETE_COMPLETE                                                                                                                386.0s


Docker official sample Deploying Docker container on ECS How to start Amazon ECR using AWS CLI How to start Amazon ECS with Fargate The docker ecs command was born by collaboration between Docker and AWS, so I tried using it I tried Amazon ECS deployment of Docker Compose

Recommended Posts

[Introduction to Docker x ECS] ECS deployment with docker compose up
[Docker ECS] Detailed settings for docker compose up
[Docker] Introduction to docker compose Basic summary of docker-compose.yml
How to use docker compose with NVIDIA Jetson
[Docker] ECS automatic deployment --Docker edition-
Set up GitLab with docker
I tried to make an introduction to PHP + MySQL with Docker
How to get started with Gatsby (TypeScript) x Netlify x Docker
Node.js environment construction with Docker Compose
Introduction to Linux Container / Docker (Part 1)
Introduction to Spring Boot x OpenAPI ~ OpenAPI made with Generation gap pattern ~
Introduction to algorithms with java-Shakutori method
Build Rails environment with Docker Compose
WordPress with Docker Compose on CentOS 8
Introduction to Linux Container / Docker (Part 2)
Make a C compiler to use with Rust x CLion with Docker
mysql doesn't start up with docker.
[Docker] Operation up to container creation # 2
Update MySQL from 5.7 to 8.0 with Docker
Introduction to Docker (1) Frequently used commands
How to start Camunda with Docker
How to build a Ruby on Rails development environment with Docker (Rails 6.x)
How to build a Ruby on Rails development environment with Docker (Rails 5.x)
How to share files with Docker Toolbox
Introduction to Ruby basic grammar with yakiniku
Create Rails 6 + MySQL environment with Docker compose
[Rails] How to use rails console with docker
Deploy to heroku with Docker (Rails 6, MySQL)
[Now] Let's Redmine with Docker Compose with Let's Encrypt
Introduction to algorithms with java --Search (depth-first search)
Introduced vscode with apt to docker: ubuntu
Introduction to Docker / Kubernetes Practical Container Development
Try using Kong + Konga with Docker Compose.
Sample to start Ubuntu with Deployment with client-go
Install Docker with WSL2 Memo ([Part 2] Docker introduction)
How to run Blazor (C #) with Docker
[Introduction to Docker] Official Tutorial (Japanese translation)
How to build Rails 6 environment with Docker
Introduction to algorithms with java --Search (breadth-first search)
Introduction to Robot Battle with Robocode (Environment Construction)
How to mock each case with Mockito 1x
I tried to verify AdoptOpenJDK 11 (11.0.2) with Docker image
Introduction to algorithms with java --Search (bit full search)
Introduction to algorithms with java-Search (Full search, Binary search)
Introducing Rspec with Ruby on Rails x Docker
Setting to exit from Docker container with VScode
Notes on building Rails6 / PostgreSQL with Docker Compose
Deploy Rails to ECS Fargate with AWS Copilot
How to give your image to someone with docker
How to use nginx-ingress-controller with Docker for Mac
[Rails] How to build an environment with Docker
I can't do docker-compose up -d with docker
Introduction to Robot Battle with Robocode (Beginner Development)
[Introduction to Spring Boot] Authentication function with Spring Security
EC2 ✕ Manual deployment with Docker / docker-compose / Asset compilation
Easy to display hello world with Rails + Docker
[Part 1] How to deploy Docker containers and static files with CircleCI + ECS + ECR + CloudFront