みなさん、こんにちは！
AWS ECR は、コンテナイメージを管理するリポジトリです。
Gitリポジトリと同じように、イメージをpullしてローカル環境で利用したり、ローカル環境のイメージをpushしてECS等で利用することができます。
本記事では、AWS ECR のプライベートレジストリとローカル環境の間でコンテナイメージをpull＆pushする方法についてご紹介します。
準備
AWS ECR とローカル環境で通信するにあたり、AWS CLI のインストールと認証情報の設定を行う必要があります。
AWS CLI のインストールと認証情報の設定については、通常の場合と IAM Identity Center の場合で方法が異なります。以下を参考に設定を行ってください。
通常の場合
IAM Identity Center の場合
AWS CLIをAWS IAM Identity Center(SSO)で認証させるには? | DevelopersIO
また、Dockerコマンドを使うのでDockerのインストールも必要です。
レジストリ認証
認証情報の設定まで完了したら、以下のコマンドでプライベートレジストリ認証を行います。
aws ecr get-login-password --region <region> | docker login --username AWS --password-stdin <account_id>.dkr.ecr.<region>.amazonaws.com
account_idとregionはご自身のものに置き換えてください。
以下のような表示が出れば成功です。
WARNING! Your password will be stored unencrypted in /home/tani/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credentials-store
Login Succeeded
イメージのpull
ECR からローカル環境にイメージをpullする場合、以下のコマンドを実行します。
docker pull <account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>
repositoryは対象リポジトリ名、tagには対象イメージのタグを指定します。
以下のようにpullが実行され、ローカル環境にイメージがダウンロードされます。
dev-km_loader: Pulling from reqgpt-repo
...
417f18bbb763: Pull complete
eb6b2be00db9: Pull complete
Digest: sha256:a1f15e15504ca3c31f5b45feebc8c45534b279807aab94303af48b86372563ef
Status: Downloaded newer image for xxxxxxxxxxxx.dkr.ecr.ap-northeast-1.amazonaws.com/reqgpt-repo:dev-km_loader
xxxxxxxxxxxx.dkr.ecr.ap-northeast-1.amazonaws.com/reqgpt-repo:dev-km_loader
pullしたイメージは下記コマンドで確認できます。
docker images
イメージからコンテナを起動する場合、以下のように通常通り起動すればOKです。
docker run <image_id>
イメージのpush
ローカル環境から ECR にイメージをpushする場合、以下のコマンドを実行します。
docker tag <image_id> <account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>
docker push <account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>
docker tagで対象のイメージにタグ（push先のリポジトリとタグの組み合わせ）を付け、それをdocker pushでpushします。一発でpushする方法はないので、タグを付けてpush、という二段階の操作が必要になります。
実行例：
$ docker tag 6ca355ce0951 xxxxxxxxxxxx.dkr.ecr.ap-northeast-1.amazonaws.com/reqgpt-repo:test_loader
$ docker push xxxxxxxxxxxx.dkr.ecr.ap-northeast-1.amazonaws.com/reqgpt-repo:test_loader
さいごに
いざ ECR のプライベートリポジトリとローカル環境でイメージを受け渡ししようと思ったとき、やり方に少しクセがあって詰まってしまいました。
本記事が同じような方の参考になれば幸いです。