Engineering Design Startup Education Event

Amazon ECSで環境変数を簡単に設定できると聞いたので試してみる

2018.12.30

Amazon ECSでDockerコンテナを動かしたい

EC2で動いているサービスをDocker化したい。そのために必要なこととしては、環境ごとに異なるDBの接続先やパスワードなどをどうやってコンテナに渡すかを考えることがある。

以前調べたところ、AWS CLIコマンドをコンテナ起動時に実行してキーを読み込んで復号化するという手の込んだ感じの方法ばかり見つかってしまい、なかなか導入に踏み切れていなかった。

たまたま目にした以下の記事で、Amazon ECSでの環境変数の扱いが便利になったと知ったので重い腰を上げて試してみた。

開発環境

macOS Mojave 10.14.1
Docker Desktop Community 2.0.0.0-mac81 (29211)
Docker Engine 18.09.0

試すためのDockerイメージを定義したDockerfileを作成する

$ mkdir ecs_env
$ cd ecs_env
$ touch Dockerfile
$ touch phpinfo.php

Dockerfileには以下の内容を入力して保存する。

# 「php」というイメージの「7-apache」というタグがついたイメージをベースにする
FROM php:7-apache

# Macにあるphpinfo.phpをコンテナの/var/www/htmlにコピーする
COPY phpinfo.php /var/www/html

phpinfo.phpには以下の内容を入力して保存する。

<?php phpinfo();

これで準備完了。DockerfileのビルドはAmazon ECRにプッシュする段階で行う。

Amazon ECRにプッシュする

Amazon ECRにリポジトリを作成する

マネジメントコンソールのAmazon ECSの管理画面を開いて、サイドメニューの「Amazon ECR」の下の「リポジトリ」をクリックする。
「リポジトリの作成」をクリックする。

リポジトリ名を入力して「リポジトリの作成」をクリックする。

リポジトリができたら、できたリポジトリをクリックして開いた画面で「プッシュコマンドの表示」をクリックする。

表示されたプッシュコマンドを一つずつ実行して、ビルドしたイメージをECRにプッシュする。

ログインするコマンドだけ、AWS CLIのプロファイル機能を使っているので以下のように置き換えて実行した。ecr_sampleというプロファイルにはECRを操作できるポリシーが割り当ててある。

# Before
$(aws ecr get-login --no-include-email --region ap-northeast-1)

# After
$(aws ecr get-login --no-include-email --region ap-northeast-1  --profile=ecr_sample)

Systems Managerを使って環境変数を登録する

Systems Managerの管理画面を開いて、左メニューの「パラメータストア」を選択する。
「パラメータの作成」をクリックする。

パラメータの名前と説明と値を入力して作成する。今回は暗号化しない単なる値を試してみようと思うので「文字列」を選択した。

環境変数と言えば、KEY=VALUEという形式だと思うが、パラメータの名前はこのキーに相当するわけではないらしい。ECSでタスク定義を作成するときに任意のキーに対してこのパラメータを割り当てる形になる模様。

今回はサービス中でHTTPリクエストのエンドポイントを指定するようなユースケースをイメージしてURLを値として設定してみた。（自分のブログ）

作成できると一覧に表示された。

ECSのタスクがSystems Managerで作成したパラメータにアクセスできるようにIAMロールを作成する

IAMの管理画面を開いて、「ロールの作成」をクリックする。
以下のように選択して次へ進む。完全に初見だが、どれを選べば良さそうか丁寧に書かれていて迷わなかった。

ポリシーは自分で作成する。JSON形式で以下のように入力した。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ssm:GetParameters"
      ],
      "Resource": "*"
    }
  ]
}