ecs-cli チュートリアル（2）～ ECR のコンテナイメージを利用する～

ども、かっぱです。

tl;dr

以前から気になっていた ecs-cli から ECR のコンテナイメージをどうやって使うのか。実際にやってみたら難しくなかったけど念のためにメモっておきます。

memo

試した環境

構築した環境

20160227160757

ecs-cli を叩く環境

i$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=14.04
DISTRIB_CODENAME=trusty
DISTRIB_DESCRIPTION="Ubuntu 14.04.2 LTS"

$ ecs-cli --version
ecs-cli version 0.2.1 (e7b6965)

教材

inokappa/oreno-pm25-api

Contribute to oreno-pm25-api development by creating an account on GitHub.

GitHub

github.com

拙作の pm25.test.inokara.com で提供されている JSON データを S3 から取得してクライアントに返すだけの API サーバーっぽいの。

ECR にコンテナイメージを push するまで

#
# docker-compose build でコンテナイメージをビルドする
#
$ docker-compose build

#
# aws cli で ECR にログインする為のパスワードを取得
#
$ aws --region us-east-1 ecr get-login

#
# docker login でログイン
#
$ docker login -u AWS -p xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -e none https://xxxxxxxxxxxxxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com

#
# aws cli でリポジトリを作成
#
$ aws --region us-east-1 ecr create-repository --repository-name oreno-pm25-api

#
# ビルドしたイメージにタグを付与
#
$ docker tag orenopm25api_web_1 xxxxxxxxxxxxxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/oreno-pm25-api

#
# タグを付与したイメージを ECR に push
#
$ docker push xxxxxxxxxxxxxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/oreno-pm25-api

以上。

docker-compose.yml

ECS 用に docker-compose.yml を作成する。

redis:
  image: redis
  cpu_shares: 100
  mem_limit: 67108864
  ports:
    - "6379"

web:
  image: xxxxxxxxxxxxxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/oreno-pm25-api
  cpu_shares: 100
  mem_limit: 268435456
  volumes:
    - /tmp/nginx/:/var/log/nginx
  ports:
    - "80:80"
    - "4567:4567"
  links:
    - redis
  environment:
    - REDIS_HOST=redis

redis コンテナは Docker オフィシャルの Redis イメージを利用する。web コンテナは先ほど ECR に push したイメージを利用する。この YAML ファイルを ecs.yml という名前で保存しておく。（ファイル名は任意で OK 牧場）

ecs-cli でクラスタ作成、ECS インスタンスの起動

#
# クラスタの初期設定
#
$ ecs-cli configure --region ap-northeast-1 --cluster oreno-pm25-api

#
# 実行すると以下のようなファイルが生成される
#
$ cat ~/.ecs/config
[ecs]
cluster = oreno-pm25-api
aws_profile =
region = ap-northeast-1
aws_access_key_id =
aws_secret_access_key =

#
# ECS インスタンスの起動
#
$ ecs-cli up --keypair xxxxxxxxxxxxxxxxxxx 
  --capability-iam 
  --size 1 
  --vpc vpc-xxxxxxxx 
  --instance-type t2.micro 
  --subnets subnet-xxxxxxxx,subnet-zzzzzzzz 
  --azs ap-northeast-1a,ap-northeast-1c

（以下のように出力される）

INFO[0000] Created cluster                               cluster=oreno-pm25-api
INFO[0001] Waiting for your cluster resources to be created
INFO[0002] 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
INFO[0183] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0243] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0304] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS

ecs-cli compose up

準備は整ったのでコンテナを起動する。

$ ecs-cli compose -f ecs.yml up

（以下のように出力される）

ERRO[0000] Error describing task definition              error=ClientException: Unable to describe task definition.
        status code: 400, request id: 6c010388-dd17-11e5-bb49-531dd1d03f3f taskDefinitionName=ecscompose-oreno-pm25-api
INFO[0000] Using ECS task definition                     TaskDefinition=ecscompose-oreno-pm25-api:1
INFO[0000] Starting container...                         container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/redis
INFO[0000] Starting container...                         container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/web
INFO[0000] Describe ECS container status                 container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/redis desiredStatus=RUNNING lastStatus=PENDING taskDefinition=ecscompose-oreno-pm25-api:1
INFO[0000] Describe ECS container status                 container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/web desiredStatus=RUNNING lastStatus=PENDING taskDefinition=ecscompose-oreno-pm25-api:1
snip...
INFO[0097] Started container...                          container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/redis desiredStatus=RUNNING lastStatus=RUNNING taskDefinition=ecscompose-oreno-pm25-api:1
INFO[0097] Started container...                          container=xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/web desiredStatus=RUNNING lastStatus=RUNNING taskDefinition=ecscompose-oreno-pm25-api:1

それぞれのコンテナが起動したようだ。

ecs-cli compose ps

コンテナの状態を確認してみる。

$ ecs-cli compose -f ecs.yml ps
Name                                        State    Ports                                                 TaskDefinition
xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/redis  RUNNING  xx.xxx.x.xxx:32768->6379/tcp                          ecscompose-oreno-pm25-api:1
xxxxxxxx-0a0a-4871-a644-zzzzzzzzzz/web    RUNNING  xx.xxx.x.xxx:4567->4567/tcp, xx.xxx.x.xxx:80->80/tcp  ecscompose-oreno-pm25-api:1

おけ。どうやらコンテナは正常に起動している。

アプリケーションの確認

デプロイ済みのなんちゃってアプリケーションの動作確認。

$ curl -s 'xx.xxx.x.xxx/json?date=20160224&station_code=40202010' | jq .
{
  "time_series": {
    "24": 3,
    "23": 3,
    "22": 1,
    "21": 7,
    "20": 9,
    "19": 15,
    "18": 13,
    "17": 17,
    "08": 13,
    "07": 21,
    "06": 20,
    "05": 18,
    "04": 15,
    "03": 17,
    "02": 21,
    "01": 20,
    "09": 11,
    "10": 14,
    "11": 17,
    "12": 21,
    "13": 24,
    "14": 23,
    "15": 22,
    "16": 19
  },
  "check_date": "20160224",
  "check_station_code": "40202010",
  "check_station": "国設大牟田"
}

一応、それっぽい JSON のレスポンスが得られた。

後片付け

$ ecs-cli down --force
INFO[0001] Waiting for your cluster resources to be deleted
INFO[0001] Cloudformation stack status                   stackStatus=DELETE_IN_PROGRESS
INFO[0062] Cloudformation stack status                   stackStatus=DELETE_IN_PROGRESS
INFO[0122] Deleted cluster                               cluster=oreno-pm25-api

ecs-cli down --force で一発。

以上

ecs-cli から ECR が使えたのはなんでだろう

ECS インスタンスの起動時に --capability-iam を付与することで以下の IAM ポリシーがコンテナインスタンスに付与されている為に利用できるのかしら。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:CreateCluster",
        "ecs:DeregisterContainerInstance",
        "ecs:DiscoverPollEndpoint",
        "ecs:Poll",
        "ecs:RegisterContainerInstance",
        "ecs:StartTelemetrySession",
        "ecs:Submit*",
        "ecr:GetAuthorizationToken",
        "ecr:BatchCheckLayerAvailability",
        "ecr:GetDownloadUrlForLayer",
        "ecr:BatchGetImage"
      ],
      "Resource": "*"
    }
  ]
}

なるほど。

ちなみに、上記のポリシーは Managed Policy の AmazonEC2ContainerServiceforEC2Roleで適用される。

思ったより簡単だったけど…

ECR は東京リージョンにいつくるだんろう…
pm25.test.inokara.com をちゃんと作り直したい

元記事はこちら

「ecs-cli チュートリアル（2）～ ECR のコンテナイメージを利用する～」

ecs-cli チュートリアル（2）～ ECR のコンテナイメージを利用する～

tl;dr

memo

試した環境

教材

ECR にコンテナイメージを push するまで

docker-compose.yml

ecs-cli でクラスタ作成、ECS インスタンスの起動

ecs-cli compose up

ecs-cli compose ps

アプリケーションの確認

後片付け

以上

ecs-cli から ECR が使えたのはなんでだろう

思ったより簡単だったけど…

元記事はこちら

【AWS re:Invent 2024】Amazon Linux AL2023 and beyond

cron の代わりに systemd timer を使ってみた

Oracle のロックされているテーブルのセッションを知りたい [cloudpack OSAKA blog]

PagerDutyとAmazon Q Businessの連携を試してみた

AWSの生成AI活用事例集GenUを使い倒す

ecs-cli チュートリアル（2）～ ECR のコンテナイメージを利用する ～

tl;dr

memo

試した環境

教材

ECR にコンテナイメージを push するまで

docker-compose.yml

ecs-cli でクラスタ作成、ECS インスタンスの起動

ecs-cli compose up

ecs-cli compose ps

アプリケーションの確認

後片付け

以上

ecs-cli から ECR が使えたのはなんでだろう

思ったより簡単だったけど…

元記事はこちら

関連記事Related Articles

（ショロカレ 21 日目）ずっと待ってた Amazon ECR を一瞬、使ってみた

（ショロカレ 23 日目）Amazon ECR をもう一時間使ってみた（aws-cli による操作と ECS との連携を試す）

ECS + ecs-cli + Locust + consul でカヂュアルにスケールする負荷試験を構築する考察

第9回 コンテナ型仮想化の情報交換会＠福岡に参加してお話させて頂いたのでメモ

ECS と ECR をデモをやり易くする為に Rakefile を作ったメモ

ecs-cli チュートリアル（2）～ ECR のコンテナイメージを利用する～

第9回コンテナ型仮想化の情報交換会＠福岡に参加してお話させて頂いたのでメモ