CircleCI Orbsで ECR/ECS にデプロイ

CircleCI Orbsを使った自動デプロイ環境を試してみたので、一通りの手順（AWSの設定からCircleCIの設定まで）を残しておこうと思います。
AWSやCircleCIにあまり慣れていない方にも参考になるように、最後までやりきれば動く環境ができるはずです。

ちなみに私自身はあまりAWSやCircleCIに詳しくないため間違っている部分があるかもしれません。その際はご指摘いただけると嬉しいです。

1. プロジェクト作成

適当なディレクトリを作成し、Dockerfileを作成します。

mkdir circleci-obrs-sample
touch Dockerfile

内容は以下のサイトのサンプルをそのまま利用させていただきます。
Docker Basics for Amazon ECS - Amazon Elastic Container Service

FROM ubuntu:16.04

# Install dependencies
RUN apt-get update
RUN apt-get -y install apache2

# Install apache and write hello world message
RUN echo 'Hello World!' > /var/www/html/index.html

# Configure apache
RUN echo '. /etc/apache2/envvars' > /root/run_apache.sh
RUN echo 'mkdir -p /var/run/apache2' >> /root/run_apache.sh
RUN echo 'mkdir -p /var/lock/apache2' >> /root/run_apache.sh
RUN echo '/usr/sbin/apache2 -D FOREGROUND' >> /root/run_apache.sh
RUN chmod 755 /root/run_apache.sh

EXPOSE 80

CMD /root/run_apache.sh

ECRリポジトリ作成

AWSにログインしECRの画面で「リポジトリ作成」ボタンを押します。

リポジトリ名の入力が促されるので、任意の名前（ここでは、circleci-orbs-sample とする）を入力して保存します。

ECRリポジトリにイメージをプッシュ

作成したリポジトリを開き「プッシュコマンドの表示」ボタンを押下します。

表示されたコマンドを一つづつ実行していけば問題ないはずです。
最初のコマンドは以下のようなログインコマンドを取得するコマンドです。

$(aws ecr get-login --no-include-email --region <region-name>)

上記のコマンドを実行するとECRログインのためのコマンド（docker login -u AWS -p xxxxxxx）が表示されるので、それをコピペして実行します。

ログインがSuccessしたらのこりのコマンドを実行していきます。

# Dockerイメージ構築
docker build -t circleci-orbs-sample .

# イメージにタグをつける
docker tag circleci-orbs-sample:latest <アカウントID>.dkr.ecr.<リージョン名>.amazonaws.com/circleci-orbs-sample:latest

# ECRにプッシュ
docker push <アカウントID>.dkr.ecr.<リージョン名>.amazonaws.com/circleci-orbs-sample:latest

一連のコマンドでECRリポジトリへのプッシュが完了します。
ECRリポジトリにアクセスすると 「latest」というタグが表示されると思います。

タスク定義

次にECSクラスターで利用するタスク定義を作成します。

新しいタスク定義の作成を押すと、FARGATEかEC2かをまず選びます。ここではEC2を選びます。

最低限の設定として、タスク定義名とコンテナの定義を行います。
タスク定義名は任意の名前を入れてください（ここでは、「circleci-orbs-task」とします）

「コンテナの追加」ボタンを押します。

コンテナの追加では、

• コンテナ名（ここでは、circleci-orbs-container）
• イメージ（ECRリポジトリに表示されているのをコピーする）
• メモリ制限（ここでは200）
• ポートマッピング「（ホスト80、コンテナ80）
• CPUユニット数（ここでは１）

を入力します。

これで右下の「作成」ボタンを押してタスク定義は完了です。

クラスター作成

次にECSクラスターを作成します。

ここでは「EC2 Linux + ネットワーキング」を選びます。

最低限の変更箇所として、
クラスター名（ここでは、circleci-orb-cluster）

EC2インスタンスタイプ（無料枠お使いであればt2.microに変えた方がよいかなと）、インスタンス数（ここでは２）

VPC、サブネット、セキュリティグループは適宜既存のものなどを割り当ててください。

右下の「作成」を押してクラスター作成は完了です。

ALB作成

のちのサービス作成で必要になるので先に作成しておきます。
EC2ダッシュボードから、ロードバランサー作成を押します。

Application Load Blancer　を選択します。

設定画面では以下を設定します。

• 名前（ここでは、「alb-for-circleci-orbs-service」）
• ポート（デフォルトで、プロトコルがHTTP、ポートが80の設定があるはずなのでそのままでokです）
• VPC、アベイラビリティーゾーンは、クラスターと同じで。
• ターゲットグループ（ここでは、「tg-for-circleci-orbs」と命名。ターゲットグループへのインスタンス追加は不要です。）

サービス作成

次にクラスター（circleci-orbs-cluster）のサービスを作成します。

サービスの設定画面では以下を設定します。

• 起動タイプ（ここではEC2）
• タスク定義（ここでは「circleci-orbs-task」）
• クラスター（ここでは「circleci-orbs-cluster」）
• サービス名（ここでは「circleci-orbs-service」と命名）
• タスクの数（ここでは１。クラスターのインスタンスタイプより１少なくしておく。同じだと自動デプロイ時にサービスが自動でタスクを最新化してくれない(はず)）
  

ネットワーク構成の画面では

• ELBタイプ（ここでは、Application Load Blancer）
• ELB名（ここでは、alb-for-circleci-orbs-service）
• 負荷分散用のコンテナ（ここでは、circleci-orbs-container）

負荷分散用のコンテナの横の「ELBへの追加」ボタンを押すと以下のような画面が開くので、先ほどALB作成時に作成したターゲットグループ（ここでは、tg-for-circleci-orbs）を設定します。

次の AutoScalingのページはそのまま。

これでサービスの作成は終わりです。

Route53の設定

作成したALBに対してAレコードを作成します。
ここまでうまくできていれば、アクセスすると「Hello World!」と表示されるはずです。

CircleCIの設定

ここからやっとCircleCIの設定です。

(CircleCI)プロジェクト追加

「ADD PROJECT」から一番はじめに作成したプロジェクトを追加してください。

(CircleCI)環境変数追加

Environment Variables から以下設定してください。
AWS_ACCESS_KEY_IDとSECRET_ACCESS_KEYには、IAMでCircleCI用にユーザーを作成してください。アクセス権限はAmazonEC2ContainerRegistryFullAccessとAmazonEC2ContainerServiceFullAccessを与えてください。

• AWS_ACCESS_KEY_ID・・・IAMユーザーより
• AWS_SECRET_ACCESS_KEY・・・IAMユーザーより
• AWS_ACCOUNT_ID・・・アカウントID（「<アカウントID>.dkr.ecr.<リージョン>.amazonaws.com」のアカウントID）
• AWS_ECR_ACCOUNT_URL・・・ECRアカウントURL（「<アカウントID>.dkr.ecr.<リージョン>.amazonaws.com」をすべて）
• AWS_REGION・・・リージョン（「<アカウントID>.dkr.ecr.<リージョン>.amazonaws.com」のリージョン）
• MY_APP_PREFIX・・・プレフィックス（ここでは、circleci-orbs）

CircleCIの設定ファイル追加

mkdir .circleci
touch .circleci/config.yml

.circleci/config.ymlの中身は以下です。
表題にある通り Orbs を利用しています。
利用しているOrbsの詳細ついては以下リファレンスをご確認ください。

CircleCI Orb Registry - circleci/aws-ecr
https://circleci.com/orbs/registry/orb/circleci/aws-ecr
CircleCI Orb Registry - circleci/aws-ecs
https://circleci.com/orbs/registry/orb/circleci/aws-ecs#commands-update-task-definition

version: 2.1

orbs:
  aws-ecr: circleci/aws-ecr@6.0.0
  aws-ecs: circleci/aws-ecs@0.0.8

workflows:
  build_and_push_image:
    jobs:
      - aws-ecr/build-and-push-image:
          region: AWS_REGION
          account-url: AWS_ECR_ACCOUNT_URL
          repo: '${MY_APP_PREFIX}-sample'
          tag: "${CIRCLE_SHA1}"
      - aws-ecs/deploy-service-update:
          requires:
            - aws-ecr/build-and-push-image
          family: '${MY_APP_PREFIX}-task'
          cluster-name: '${MY_APP_PREFIX}-cluster'
          service-name: '${MY_APP_PREFIX}-service'
          container-image-name-updates: 'container=${MY_APP_PREFIX}-container,tag=${CIRCLE_SHA1}'

これでプッシュしてCircleCIがうまく通れば自動デプロイできているはずです。

動作確認

• Dockerfile内の「Hello World」を書き換えてプッシュして自動で反映されていれば想定通り動いています

• （下画像）サービスのタスク定義のリビジョン番号が増えていること（circleci-orbs-task:4 の　4）

• （下画像）「タスク」の「タスク定義」の列に新しいリビジョン番号のタスクができていること（一時的に新しい４と古い３が同居しますが古い方はそのうち消えるはず）
  

以上で自動デプロイの設定は一通り終わりです。
CircleCIのOrbsが本当に便利！