Amazon でのプルスルーキャッシュの問題のトラブルシューティング ECR

プルスルーキャッシュルールを使用してアップストリームイメージをプルする際に、最もよく発生する可能性のある一般的なエラーは次のとおりです。

リポジトリが存在しません

リポジトリが存在しないことを示すエラーは、ほとんどの場合、リポジトリが Amazon ECRプライベートレジストリに存在しないか、アップストリームイメージをプルするIAMプリンシパルにアクセスecr:CreateRepository許可が付与されていないことが原因です。このエラーを解決するには、プルコマンドURIのリポジトリが正しいこと、アップストリームイメージをプルするIAMプリンシパルに必要なIAMアクセス許可が付与されていること、またはアップストリームイメージのプルを実行する前に、プッシュ先のアップストリームイメージのリポジトリが Amazon ECRプライベートレジストリに作成されていることを確認する必要があります。必要なIAMアクセス許可の詳細については、「」を参照してください。 IAM アップストリームレジストリと Amazon ECRプライベートレジストリを同期するために必要な アクセス許可

このエラーの例を以下に示します。

Error response from daemon: repository 111122223333.dkr.ecr.us-east-1.amazonaws.com/ecr-public/amazonlinux/amazonlinux not found: name unknown: The repository with name 'ecr-public/amazonlinux/amazonlinux' does not exist in the registry with id '111122223333'

リクエストされたイメージが見つかりません

イメージが見つからないことを示すエラーは、ほとんどの場合、アップストリームレジストリにイメージが存在しないか、アップストリームイメージをプルするIAMプリンシパルにアクセスecr:BatchImportUpstreamImage許可が付与されていないが、リポジトリが Amazon ECRプライベートレジストリに既に作成されていることが原因です。このエラーを解決するには、アップストリームイメージとイメージタグ名が正しく、それが存在し、アップストリームイメージをプルするIAMプリンシパルに必要なIAMアクセス許可が付与されていることを確認する必要があります。必要なIAMアクセス許可の詳細については、「」を参照してくださいIAM アップストリームレジストリと Amazon ECRプライベートレジストリを同期するために必要な アクセス許可。

このエラーの例を以下に示します。

Error response from daemon: manifest for 111122223333.dkr.ecr.us-east-1.amazonaws.com/ecr-public/amazonlinux/amazonlinux:latest not found: manifest unknown: Requested image not found

Docker Hub リポジトリからプルする場合の 403 Forbidden

Docker 公式イメージ としてタグ付けされた Docker Hub リポジトリからプルする場合は、URI使用する /library/に を含める必要があります。例えば、aws_account_id.dkr.ecr.region.amazonaws.com/docker-hub/library/image_name:tag と指定します。Docker Hub Official イメージの /library/ を省略した場合、プルスルーキャッシュルールを使用してイメージをプルしようとすると 403 Forbidden エラーが返されます。詳細については、「Amazon でのプルスルーキャッシュルールを使用したイメージのプル ECR」を参照してください。

このエラーの例を以下に示します。

Error response from daemon: failed to resolve reference "111122223333.dkr.ecr.us-west-2.amazonaws.com/docker-hub/amazonlinux:2023": pulling from host 111122223333.dkr.ecr.us-west-2.amazonaws.com failed with status code [manifests 2023]: 403 Forbidden