ECRへのプッシュ

続いて、ECRのリポジトリを作成し、イメージをプッシュしていきます。

1. リポジトリの作成

まずはECRのリポジトリを作成していきます。

AWSマネジメントコンソールの左上の検索ボックスで「ECR」を検索し、表示されるメニューの中からElastic Container Registryを選択します。

左側のメニューからリポジトリを選択し、右上のリポジトリを作成をクリックします。

リポジトリ名の部分は、今回のアプリケーション名であるecs-simple-handsonを入力します。

それ以外の項目はデフォルトで構いませんが、それぞれの内容を簡単に説明します。

イメージタグのイミュータビリティは、同じタグ名での上書きを許可するかどうかの設定です。「Mutable(変更可能)」にすると同じタグで何度でもプッシュできますが、「Immutable(変更不可)」にすると一度使ったタグは上書きできなくなります。今回はデフォルトの「Mutable」のままで問題ありません。

暗号化設定は、保存されるイメージの暗号化方式の設定です。デフォルトではAWSが管理するAES-256暗号化が適用されるため、特別な要件がなければそのままで問題ありません。

イメージスキャンの設定は、プッシュされたイメージに対してセキュリティ上の脆弱性がないかを自動でスキャンする機能です。今回のハンズオンではデフォルトのままにしておきます。

入力が終わったら作成をクリックします。

無事にecs-simple-handsonのリポジトリが作成されれば、ここまでは成功です。

2. イメージの準備

今回コンテナを起動するために使うDockerfileと、コンテナで表示するindex.htmlを用意します。

2.1 作業フォルダの作成

任意の場所にecs-simple-handsonフォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成したecs-simple-handsonフォルダを開きます。

ecs-simple-handson  ← このフォルダを作成

2.2 Dockerfileの作成

Dockerfileを作成します。Visual Studio Codeのエクスプローラーでecs-simple-handsonフォルダを右クリックし、「新しいファイル」を選択してDockerfileという名前で作成してください。

ecs-simple-handson
└── Dockerfile  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

FROM nginx:alpine

COPY index.html /usr/share/nginx/html/index.html

CMD ["nginx", "-g", "daemon off;"]

なお、このDockerfileの説明については過去のハンズオンで行っているため、ここでは割愛します。

2.3 index.htmlの作成

index.htmlファイルを作成します。Visual Studio Codeのエクスプローラーでecs-simple-handsonフォルダを右クリックし、「新しいファイル」を選択してindex.htmlという名前で作成してください。

ecs-simple-handson
├── Dockerfile
└── index.html  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>ECS Hands-on</title>
</head>
<body>
    <h1>Hello from ECS/Fargate!</h1>
    <p>This container is running on AWS Fargate.</p>
</body>
</html>

index.htmlのファイルの内容の説明についても、ここでは割愛しています。

3. プッシュコマンドの取得

続いて、ローカルからECRリポジトリにイメージをプッシュするためのコマンドを取得します。

作成したリポジトリを選択し、「プッシュコマンドの表示」をクリックします。

そうすると、使用するOSごとに、プッシュコマンドが表示されます。

例えばMacの場合は以下のコマンドです。アカウントIDの部分はご自身のIDが設定されていると思います。

基本的にはそのまま順番に実行すればよいのですが、各コマンドの内容を解説します。

3.1 ECRへのログイン

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin 125605020607.dkr.ecr.ap-northeast-1.amazonaws.com

aws ecr get-login-passwordでECRの認証トークンを取得し、それをdocker loginにパイプで渡してログインしています。これにより、ローカルのDockerクライアントがECRにイメージをプッシュできるようになります。「Login Succeeded」と表示されれば成功です。

3.2 イメージのビルド

docker build -t ecs-simple-handson .

Dockerイメージをビルドするコマンドです。

Apple SiliconのMac(M1、M2、M3、M4など)を使用している場合は、上記の代わりに以下のコマンドを実行してください。--platform linux/amd64 オプションを付けることで、Fargateで動作するx86_64アーキテクチャのイメージをビルドできます。Apple Siliconではデフォルトでarm64アーキテクチャのイメージがビルドされますが、今回のタスク定義では Linux/X86_64 を指定しているため、このオプションがないとFargateでの起動時に exec format error が発生します。

docker build --platform linux/amd64 -t ecs-simple-handson .

3.3 タグの付与

docker tag ecs-simple-handson:latest 125605020607.dkr.ecr.ap-northeast-1.amazonaws.com/ecs-simple-handson:latest

ローカルのイメージに、ECRリポジトリのURIをタグとして付与するコマンドです。Dockerは、タグに含まれるURIを見てプッシュ先を判断するため、この手順が必要になります。ここが間違えていると正しくプッシュされません。

3.4 ECRリポジトリへのプッシュ

docker push 125605020607.dkr.ecr.ap-northeast-1.amazonaws.com/ecs-simple-handson:latest

タグ付けしたイメージをECRリポジトリにプッシュするコマンドです。プッシュが完了すると、ECRコンソール上でイメージを確認できるようになります。

4. プッシュの実施

以下のコマンドで、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のインストール を先に実施してください。

インストールが確認できたら、実際にプッシュを行っていきます。

「プッシュコマンドの表示」で取得したコマンドを順番に、Visual Studio Codeのターミナルで実行してみてください。

その後、ECRリポジトリの詳細画面を開くと、以下のようにlatestというイメージタグがついたイメージが、無事にプッシュされていることがわかります。

ここまでで、ECRリポジトリへのイメージのプッシュが完了です。