チュートリアル: ECS CLI を使用して EC2 タスクのクラスターを作成するを参考に学習をしてみた。自分なりに解釈を加えたので、間違っている場合もありますのでその際は、ご指摘下さい。

ECSの概要

こちらの図を拝借して・・・

ECS Getting Start

Cluster: ECSを束ねるもの、よくあるサーバ群の普通のClusterを想像すれば良い

Service: ECSのタスク定義(Task definition)で指定した数のインスタンスを起動させ同時に実行、更に維持させる。例えばTaskが落ちた際にはServiceで指定した数より小さくなるため自動で一つタスクが自動起動する

Task definition: DockerイメージやCPUメモリ、linkなどを定義するもの

事前作業

予め以下の2つを作っておく
・VPCを1つ
-今回は 10.0.0.0/16 で作った

・作成したVPC内にサブネットを2つ(別のAZで)

ap-northeast-1a に 10.0.0.0/24と ap-northeast-1c に 10.0.1.0/24 を作成した。

Amazon ECS クラスター名を設定

まずは、Amazon ECS CLI で使用する Amazon ECS クラスター名を設定。この情報はローカル環境(今回はMAC)の ~./ecs/config に保存される

$ ecs-cli configure --cluster ClusterA --region ap-northeast-1 --default-launch-type EC2 --config-name clustername

--config-name は clustername は後で使用するので覚えておくこと。忘れたら ~./ecs/config の内容を見る

クラスタの作成

【前提条件】
・keypairは「webkey.pem」(これは予めaws consoleで作成しておくこと)
・2台のt2.mediumを作成する。

$ ecs-cli up --keypair webkey.pem \
--capability-iam \
--size 2 \
--instance-type t2.medium \
--cluster-config clustername \
--vpc vpc-0fcXXXXXXXXXXXXXX \
--subnets subnet-0eef76fXXXXXXXXX,subnet-07a826YYYYYYYYYY 


INFO[0000] Using recommended Amazon Linux AMI with ECS Agent 1.20.1 and Docker version 18.03.1-ce
INFO[0000] Created cluster                               cluster=ClusterA region=ap-northeast-1
INFO[0001] Waiting for your cluster resources to be created...
INFO[0001] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0062] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0122] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
Security Group created: sg-0a599d11111111111
Cluster creation succeeded.

これはCloudformationで作成される。

ちなみに上記は1台で作ったが4台にしたい場合は、 scale オプションで変更を行う。
scale を使って変更できる内容は ECS Scale を参照

$ ecs-cli scale --size 4 --capability-iam

のように scale をつける。この場合、最初に作成したEC2インスタンスはダウンすることなく追加2台で合計4台となる

docker-compose.yml を作成

ここでDockerのコンテナを作成する、 docker-compose.yml を作成する。
これはDockerでお馴染みのファイルである。これと Dockerfile を組み合わせて次回はやってみようと思う。

version: '3'
services:
  wordpress:
    image: wordpress
    ports:
      - "80:80"
    links:
      - mysql
    logging:
      driver: awslogs
      options: 
        awslogs-group: kumonavi-wordpress
        awslogs-region: ap-northeast-1
        awslogs-stream-prefix: wordpress
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: password
    logging:
      driver: awslogs
      options: 
        awslogs-group: kumonavi-mysql
        awslogs-region: ap-northeast-1
        awslogs-stream-prefix: mysql

次に ecs-param.yml を作成する。これはCPUやメモリの情報を記したもので docker-compose.yml が Version3の場合は作成する必要がある。

version: 1
task_definition:
  services:
    wordpress:
      cpu_shares: 100
      mem_limit: 524288000
    mysql:
      cpu_shares: 100
      mem_limit: 524288000

サービスを作成する。

今回は docker-compose.yml に記載したwordpressのWEB+DBを作成する。

下記の up コマンドは create と start の合わせ技です。 create でサービスの定義を作成し、 start でタスク定義から 1 つの Amazon ECS タスクを開始します。

$ ecs-cli compose service  up  --cluster-config kumonavicluster

INFO[0000] Using ECS task definition                     TaskDefinition="ecs:2"
INFO[0000] Created an ECS service                        service=ecs taskDefinition="ecs:2"
INFO[0000] Updated ECS service successfully              desiredCount=1 serviceName=ecs
INFO[0015] (service ecs) has started 1 tasks: (task AAAA-22222ー333333
-1111111111).  timestamp="2018-08-15 00:52:25 +0000 UTC"
INFO[0090] Service status                                desiredCount=1 runningCount=1 serviceName=ecs
INFO[0090] (service ecs) has reached a steady state.     timestamp="2018-08-15 00:53:42 +0000 UTC"
INFO[0090] ECS Service has reached a stable state        desiredCount=1 runningCount=1 serviceName=ecs

サービスを2つにする

$ ecs-cli compose service scale 2

確認作業

$ ecs-cli ps
Name                                            State                Ports                     TaskDefinition
485cb1ed-1e40-11111-2222-a5e47aw31253a/mysql      RUNNING                                        ecs:3
485cb1ed-1e40-11111-2222-a5e47a22223a/wordpress  RUNNING              1.1.2.2:80->80/tcp  ecs:3
4f4d1431-df3d-11111-2222-69f432222268/mysql      RUNNING                                        ecs:3
4f4d1431-df3d-4616-a9a8-69f43b22228/wordpress  RUNNING              1.1.3.3:80->80/tcp   ecs:3

お掃除

最後はきれいにします。

まずはサービスを削除します。

ecs-cli compose service rm --cluster-config cluster-name

次にクラスターを削除します。

ecs-cli down --force --cluster-config cluster-name