Published
- 4 min read
CloudFormationで、ECSのCI/CD環境を構築した際のハマりどころ 〜CodePipeline,CodeBuild,KMSも添えて〜

Classiアドベントカレンダー4日目です。 本日は、ECSを利用して、AWS上でAWSどっぷりのCI/CD環境を準備したときのお話になります。
今年のre:InventでEKSとFargateがリリースされましたが、東京リージョンに来てなかったり、プレビュー段階だったりで、 まだしばらくは参考になる部分はありそうかなと^^;
1.背景
AWS公式ブログ AWS CodePipeline, AWS CodeBuild, Amazon ECR, AWS CloudFormationを利用したAmazon ECSへの継続的デプロイメント コンテナやサーバレスアプリのデプロイツールとしてのAWS CloudFormation
Developers.io CodePipeline, CodeBuildを使ってAmazon ECSへの継続的デプロイメントを試してみた
などで、AWS公式でもECS環境下のCloudFormation(以下、CFn)を使ったデプロイ方法が紹介されています。 とはいえ、現実の要件でCFnで実装しようとすると、デフォルト設定だと失敗したり、 ドキュメントだけだと、GUIで設定できる部分がCFnでの書き方がわからかったりして、いくつかハマった内容があったので、 3種類ぐらいの特徴を抜粋して書いてみようと思います。
2.TL;DR
ECSを使うなら、
ALBとECSの動的ポート機能を組み合わせる
IAM Role,KMS,SSMパラメータストアを組み合わせる
CodePipelineで複数リポジトリからのコード取得を行う
これらの機能を全部CFnでやろうとすると、一部aws-cliなどを使う必要がありますが、 ひとまずDevとOpsでうまく権限を分担したCI/CD環境を構築できるのではないかなと思います。
3.特徴解説
3-1. ALBとECSの動的ポート機能の組み合わせ

EC2へ割り当てるSecurityGroupは、ECSの動的ポート機能を利用するため、インバウンドのTCPポートを開放しておきます。
ECSの動的ポートを有効にするため、PortMappingsの設定でホストのポートを0に設定します。
注意点
複数のEC2でECSを運用するのであれば、PlacementStrategiesの設定を行っておかないと、 random配置ECSのタスクが一つのホストだけに偏ってしまったりすることがあります。
3-2. DevとOpsで別gitリポジトリを運用しつつ、CodePipelineのデプロイフェーズでCFnのChangeSetを使う

デプロイにCFnを利用することで、デプロイの実行記録の管理やCFnで記載された部分のインフラ部分のテストを行いつつ、デプロイをすることが可能になります。 また、Sourceフェーズで、CFnの内容やEC2のASGやAMI設定の管理を行うOps管轄リポジトリと、Dockerコンテナ化するアプリロジックが含まれているDev管轄リポジトリを分割することで、運用フェーズに入ったときにDevとOpsで独立して、デプロイを行うことができます。
注意点
CodePipelineのキックは、PRがマージされたタイミングなので、(一応、CodePipelineにはTestフェーズもあるが)マージ前のテストなどはCircleCIとかに任せた方がよいかも
ParameterOverridesで上書きするパラメータは、CFnのParametersに設定している項目に応じて設定する
Sourceフェーズで持ってこれるリポジトリは2つまで。コンテナビルドに持ってくるのがもっとある場合、CodeBuild内でこちらの記事のように、githubから引っ張ってきて、ビルドするなどの対応が必要になりそう
3-3. CodeBuildでDockerイメージを作る際、KMSとSSMパラメータストアを利用する

このあたりはAWSの恩恵をフルに受けている部分かなと。 RDSのパスワードや秘密鍵など、gitリポジトリ内で管理したくない情報は、SSMパラメータストアを使って、Dockerイメージを作成するときに環境変数を埋め込みます。
docker buildするときに、--build-argに秘匿情報として環境変数を引き渡し、できあがったイメージをECRにpushする。
実運用する際は、IAM Roleを使う権限も意識して、KMSのKeyを利用するIAM UserやIAM Roleを設定する。
注意点
SSMパラメータにおける、SecureString型の値登録
3-3.でSSMパラメータストアで暗号化する際、SecureString型はCFnに対応していない。
そのため、aws-cliで設定することにした。TerraformはSecureString型に対応しているので、CFn側でも対応して欲しいところ…
4. その他の雑多なハマりどころ
4-1. ECSのAMIのデフォルト設定
EBSのストレージタイプのデフォルトがHDD LaunchConfigurationのBlockDeviceMappingsで、gp2を明示的に指定してあげる。
WillReplace用のシグナルを送るcfn-signalが未インストール UserDataの中で記載しておく。シグナルを送るタイミングは、どこまでAMIに手を入れるかによって変更する。
5.まとめ
もう少しきれいな書き方がありそうだけど、実運用でよくある要件の参考程度になれば幸いです。 EC2のASGまわりの設定は、従来のECSだとこのような形で大分インフラ側を意識しないといけない構成です。 今後、re:Inventで発表されたEKSやFargateなどとも比べながら、本環境をアップデートしていければよいなと思います。