はじめに
先日、2018年8月に書いた「LaravelアプリケーションをローカルでもAWSでもDockerで動かす」という記事が100 LGTMに到達しました。
2021年2月現在、私が書いた記事の中では、もっともLGTMされている記事でして、今年に入ってからもLGTMされていることから関心の高い内容なのかなと思っています。
とはいえ、3年近く経過している記事ではありますので、構築方法も含めアップデートしたいと思います。
この記事では、CloudFormationを使って、いくつかコマンドを叩くことで、短いステップでECS環境を構築していきます。
構築をはじめる前にやっておくこと
構築をはじめる前にやっておくことを以下に示します。
-
AWS CLIのインストール -
aws configure --profile=$(profile)による認証情報の設定 -
Dockerのインストール- Get Started with Docker | Docker
-
ECRにDockerイメージをプッシュする際に必要になります
-
Windowsの場合、Makeコマンドを使えるようにしておく -
githubのpersonal access tokenを作成- 個人アクセストークンを使用する - GitHub Docs
-
repoとadmin:repo_hook権限を選択しておきます -
CodePipelineによるデプロイで必要になります
いざ、構築
あらかじめ、CloudFormationのテンプレートと簡単なアプリケーションをimunew/ecs-blue-green-demoにて用意しています。
リポジトリをforkし、git cloneしておきます。
$ git clone git@github.com:{forkしたアカウント}/ecs-blue-green-demo.git
$ cd ecs-blue-green-demo
以下、imunew/ecs-blue-green-demoを使って構築していきます。
1. VPC、Subnet、...LoadBalancerの構築
以下のように、makeコマンドを実行していきます。
$ make deploy-vpc-subnet profile=$(profile)
$ make deploy-nat-instance profile=$(profile)
$ make deploy-network profile=$(profile)
$ make deploy-security-group profile=$(profile)
$ make deploy-load-balancer profile=$(profile)
2. ECRリポジトリの作成、およびDockerイメージのプッシュ
まずは、ECRリポジトリを作成します。
$ make deploy-ecs-ecr profile=$(profile)
次に、Dockerイメージをビルドし、ECRにプッシュします。
$ make push-docker-images profile=$(profile)
3. ECSクラスターとサービスの構築
ECSクラスターとサービスを構築します。
$ make deploy-ecs-cluster profile=$(profile)
$ make deploy-ecs-service profile=$(profile)
ECSサービスが正常に構築できていれば、その時点でLoadBalancerのDNSからエンドポイントにアクセス可能となるはずです。
（phpinfo()してるページが表示されるはずです。）
4. GitHubプライベートアクセストークンをSecrets Managerに登録する
access-tokenには、事前に作成しておいたプライベートアクセストークンを指定します。
$ make deploy-secrets-github profile=$(profile) access-token=$(access-token)
5. CodeDeployアプリケーションとデプロイグループの作成
CodeDeployアプリケーションとデプロイグループを作成します。
$ make deploy-code-deploy profile=$(profile)
6. CodePipelineの作成
CodePipelineを作成します。
$ make deploy-code-pipeline profile=$(profile)
Blue/Green デプロイ
フォークしたリポジトリに、コードをプッシュすると、下記のように、CodePipelineが動き出します。
Deployステージの詳細リンクをクリックすると、Blue/Greenデプロイの詳細を下記のように確認できます。
おわりに
ECS環境の構築はできたでしょうか？
フォークしたリポジトリを色々カスタマイズしたりして、自分なりのテンプレートを作ってみてください。
何か詰まったところがあったり、ご意見などありましたら、この記事にコメントいただくか、imunew/ecs-blue-green-demoにissueかpull-requestください。
ではでは。