翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon ECR プライベートリポジトリからローカル環境へのイメージのプル
<a name="docker-pull-ecr-image"></a>

Amazon ECR で利用可能な Docker イメージを実行する場合、**docker pull** コマンドを使用してローカル環境にプルします。これは、デフォルトのレジストリまたは別の AWS アカウントに関連付けられたレジストリから実行できます。

Amazon ECS タスク定義で Amazon ECR イメージを使用する場合は、「[Amazon ECS での Amazon ECR イメージの使用](ECR_on_ECS.md)」を参照してください。

**重要**  
アーカイブされたイメージをプルすることはできません。アーカイブされたイメージは、プルする前に復元する必要があります。イメージのアーカイブと復元の詳細については、「」を参照してください[Amazon ECR でのイメージのアーカイブ](archive_restore_image.md)。

**重要**  
Amazon ECR では、ユーザーがレジストリへの認証を行って、Amazon ECR リポジトリに対するイメージのプッシュまたはプルを行う前に、IAM ポリシーを介して `ecr:GetAuthorizationToken` API への呼び出しを行う許可が必要です。Amazon ECR には、さまざまなレベルでユーザーアクセスを制御するための AWS 管理ポリシーがいくつか用意されています。Amazon ECR の AWS マネージドポリシーの詳細については、「」を参照してください[AWS Amazon Elastic Container Registry の マネージドポリシー](security-iam-awsmanpol.md)。

**Amazon ECR リポジトリから Docker イメージをプルするには**

1. イメージのプル元になる Amazon ECR レジストリに対して Docker クライアントを認証します。認証トークンは、使用するレジストリごとに取得する必要があり、トークンは 12 時間有効です。詳細については、「[Amazon ECR でのプライベートレジストリ認証](registry_auth.md)」を参照してください。

1. (オプション) プルするイメージを識別します。
   + レジストリ内のリポジトリは、**aws ecr describe-repositories** コマンドを使用してリストできます。

     ```
     aws ecr describe-repositories
     ```

     上記のレジストリの例には、 `amazonlinux` というリポジトリがあります。
   + リポジトリ内のイメージは、**aws ecr describe-images** コマンドで記述することができます。

     ```
     aws ecr describe-images --repository-name amazonlinux
     ```

     上記のリポジトリ例には、`latest` および `2016.09` というタグが付けられたイメージが、イメージダイジェスト ` sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807` とともにあります。

1. **docker pull** コマンドを使用してイメージをプルします。イメージ名の形式は、タグを使用してプルする場合は `registry/repository [:tag]`、ダイジェストを使用してプルする場合は `registry /repository[@digest]` とします。

   ```
   docker pull aws_account_id.dkr.ecr.us-west-2.amazonaws.com/amazonlinux:latest
   ```
**重要**  
`repository-url not found: does not exist or no pull access` エラーが表示された場合は、Amazon ECR で Docker クライアントを認証する必要があります。詳細については、「[Amazon ECR でのプライベートレジストリ認証](registry_auth.md)」を参照してください。