コンテナイメージのPush

baseモジュールでECRリポジトリが作成されたので、APIアプリケーションのコンテナイメージをビルドしてPushします。

1. ECRへのログイン

以下のコマンドで、AWS CLI がインストールされていることを確認します。

aws --version

以下のように AWS CLI のバージョンが表示されれば、インストールは確認できています。

aws-cli/2.x.x Python/3.x.x Darwin/xx.x.x source/arm64

バージョンが表示されない場合は、AWS CLIのインストール を先に実施してください。

続いて、以下のコマンドで、Docker がインストールされていることを確認します。

docker --version

以下のように Docker のバージョンが表示されれば、インストールは確認できています。

Docker version 27.x.x, build xxxxxxx

バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。

インストールが確認できたら、ECRにログインします。<アカウントID>の部分はご自身のAWSアカウントIDに置き換えてください。

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com

以下のような実行結果が表示されます。

Login Succeeded

2. イメージのビルドとPush

app/api/api/ディレクトリ(Dockerfileがある場所)に移動し、イメージをビルドしてPushします。前の手順でenvironments/test/ディレクトリにいるため、まずプロジェクトルートに戻ります。

cd ../..

Dockerfileがあるディレクトリに移動します。

cd app/api/api

イメージをビルドします。<アカウントID>の部分はご自身のAWSアカウントIDに置き換えてください。--platform linux/amd64を指定することで、Fargateで動作するx86_64アーキテクチャのイメージをビルドします。

docker build --platform linux/amd64 -t <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/test-noteapp-api:latest .

以下のような実行結果が表示されます。

Successfully built xxxxxxxxxx
Successfully tagged <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/test-noteapp-api:latest

イメージをPushします。

docker push <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/test-noteapp-api:latest

以下のような実行結果が表示されます。

The push refers to repository [<アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/test-noteapp-api]
latest: digest: sha256:xxxxxxxx size: xxxx

ECRのコンソールで、リポジトリにイメージがPushされていることを確認してください。test-noteapp-apiリポジトリを開き、latestタグのイメージが表示されていれば完了です。

💡 ポイント
本セクションの初回は、このあと作成するapiモジュールの terraform apply 時にECSタスクが初めて起動してこのイメージを取得するため、特別な操作は不要です。

一方、APIのコードを修正してECRに再Pushした場合、タスク定義のイメージURL(latestタグ)自体は変わらないため、ECSは新しいイメージに自動で切り替わりません。この場合は以下のコマンドで ECSサービスを強制的に新しいデプロイに切り替える 必要があります。

aws ecs update-service --cluster test-noteapp-cluster --service test-noteapp-api --force-new-deployment --region ap-northeast-1

ポートフォリオでCI/CDを組むときは、この --force-new-deployment をパイプラインの最後に入れるのが定番パターンです。