

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

# Amazon ECR でのイメージのアーカイブ
<a name="archive_restore_image"></a>

## ECR アーカイブストレージクラスとは
<a name="archive-what-is"></a>

Amazon ECR アーカイブストレージクラスは、コンテナイメージの低コストで長期的なストレージを提供する新しいストレージクラスです。Amazon ECR には 2 つのストレージクラスがあります。
+ **ECR 標準ストレージクラス** – 定期的にアクセスされるアクティブなイメージのデフォルトのストレージクラス。
+ **ECR アーカイブストレージクラス** – アクセスはまれですが、コンプライアンスまたは長期参照のために保持する必要があるイメージの低コストストレージクラス。アーカイブストレージクラスは、長期イメージ保持のための標準ストレージクラスと比較して、大量のイメージのコスト削減を実現します。料金の詳細については、[「Amazon ECR の料金](https://aws.amazon.com/ecr/pricing/)」を参照してください。

イメージをアーカイブするには、2 つのオプションがあります。まず、以下に基づいてイメージを自動的にアーカイブするようにライフサイクルルールを設定できます。
+ イメージがプッシュされてからの時間
+ イメージが最後にプルされてからの時間
+ リポジトリ内のイメージの数

指定した期間にアーカイブされたイメージを完全に削除するように設定することもできます。詳細については、「[Amazon ECR でのライフサイクルポリシーを使用したイメージのクリーンアップの自動化](LifecyclePolicies.md)」を参照してください。

Amazon ECR コンソールまたは を使用してイメージをアーカイブすることもできます AWS CLI。詳細については、「[イメージのアーカイブ](archive-image.md)」を参照してください。

アーカイブされたイメージを再度使用する必要がある場合は、ECR Standard ストレージクラスに復元できます。ECR は 20 分以内にイメージを復元します。復元されたイメージは、新しくプッシュされたイメージのように動作し、復元が完了するとすぐに使用できます。復元されたイメージには、スキャン、レプリケーション、リポジトリのライフサイクルポリシーが適用されます。詳細については、「[イメージの復元](restore-image.md)」を参照してください。

# イメージのアーカイブ
<a name="archive-image"></a>

Amazon ECR コンソールを使用して手動でイメージをアーカイブすることも AWS CLI、ライフサイクルポリシーを使用して自動的にアーカイブすることもできます。イメージがアーカイブされている場合:
+ イメージはアーカイブストレージクラスに移動されます。
+ アーカイブされたイメージはプルできません。アーカイブされたイメージのプルリクエストは 404 エラーで失敗します。
+ イメージはプルできませんが、 ** describe-images** コマンドを使用して記述することも、 **list-images** コマンドを使用してリストすることもできます。イメージのステータスは として表示されます`ARCHIVED`。
+ アーカイブされたイメージの最小ストレージ期間は 90 日間です。アーカイブに 90 日未満のイメージを削除するライフサイクルポリシーを設定することはできません。アーカイブ期間が 90 日未満のイメージを削除する必要がある場合は、 **batch-delete-image** API を使用する必要がありますが、90 日間の最小ストレージ期間に対して課金されます。
+ イメージは、リポジトリビューの**アーカイブ済みイメージ**タブに表示されます (このタブは、少なくとも 1 つのイメージがリポジトリにアーカイブされている場合にのみ表示されます）。
+ イメージは、復元するイメージを手動で選択するか、リポジトリにイメージを再プッシュすることで、アクティブなイメージとして復元できます。
+ アーカイブの時間などの基準でイメージを削除するライフサイクルポリシーがリポジトリにある場合、イメージは削除されます。

------
#### [ AWS マネジメントコンソール ]

**イメージをアーカイブするには**

1. [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories) で Amazon ECR コンソールを開きます。

1. ナビゲーションバーから、アーカイブするイメージを含むリポジトリを含むリージョンを選択します。

1. ナビゲーションペインで、[**Repositories**] を選択します。

1. **リポジトリ**ページで、アーカイブするイメージを含むリポジトリを選択します。

1. アーカイブするイメージを選択します。イメージの詳細が表示されます。

1. イメージをアーカイブするには、**アーカイブ**ボタンを選択し、プロンプトが表示されたら**確認**を選択します。

1. これがリポジトリ内の最初のアーカイブイメージである場合、新しい**アーカイブイメージ**タブに新しくアーカイブされたイメージが表示されます。アーカイブされたイメージが他にもある場合、このイメージはそのタブに追加されます。

------
#### [ AWS CLI ]

**イメージをアーカイブするには**
+ **update-image-storage-class** コマンドを使用して、ストレージクラスを に更新してイメージをアーカイブします`ARCHIVE`。

  ```
  aws ecr update-image-storage-class \
      --repository-name my-repository \
      --image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
      --target-storage-class ARCHIVE
  ```

------

**ライフサイクルポリシーを使用してイメージをアーカイブするには**
+ ライフサイクルポリシーを使用してリポジトリのアーカイブルールを設定し、イメージを自動的にアーカイブできます。ライフサイクルポリシーを使用すると、次のような基準に基づいてイメージを自動的にアーカイブできます。
  + イメージがプッシュされてからの時間
  + イメージが最後にプルされてからの時間
  + アクティブにしておくイメージの最大数

  指定した期間アーカイブされたイメージを完全に削除するようにライフサイクルポリシーを設定することもできます。アーカイブアクションを含むライフサイクルポリシーの詳細と例については、「」を参照してください[Amazon ECR でのライフサイクルポリシーを使用したイメージのクリーンアップの自動化](LifecyclePolicies.md)。
**注記**  
アーカイブされたイメージの最小ストレージ期間は 90 日間です。アーカイブに 90 日未満のイメージを削除するライフサイクルポリシーを設定することはできません。アーカイブ期間が 90 日未満のイメージを削除する必要がある場合は、 **batch-delete-image** API を使用する必要がありますが、90 日間の最小ストレージ期間に対して課金されます。

**describe-images** コマンドを使用してイメージを記述すると、アーカイブされたイメージの は `image-status`になります`ARCHIVED`。でイメージ`image-status`をフィルタリングして、アーカイブされたイメージのみまたはアクティブなイメージのみを表示できます。

# イメージの復元
<a name="restore-image"></a>

アーカイブされたイメージを復元すると、ECR Archive ストレージクラスから ECR Standard ストレージクラスに戻ります。復元されたイメージは、標準のストレージレートで課金されます。復元プロセスは、新しいイメージが作成されたときに発生する同様のアクションを実行します。
+ 復元が完了すると、イメージをプルできるようになります。復元には通常最大 20 分かかりますが、完了が速くなる場合があります。
+ プッシュ時のスキャンがリポジトリに対して有効になっている場合、復元されたイメージがスキャンされます。イメージがアーカイブされる前の以前のスキャン結果は使用できないことに注意してください。
+ リポジトリにレプリケーションが設定されている場合、復元時にレプリケーションが有効になっていると、復元されたイメージがレプリケートされます。
+ 復元されたイメージがアクティブなイメージリストに表示されます。

イメージの復元には通常最大 20 分かかりますが、完了が速くなる場合があります。復元プロセス中、イメージはアーカイブされた状態のままであり、復元が完了するまでプルできません。

------
#### [ AWS マネジメントコンソール ]

**アーカイブされたイメージを復元するには**

1. [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories) で Amazon ECR コンソールを開きます。

1. ナビゲーションバーから、復元するアーカイブイメージを含むリポジトリを含むリージョンを選択します。

1. ナビゲーションペインで、[**Repositories**] を選択します。

1. **リポジトリ**ページで、アーカイブされたイメージを含むリポジトリを選択します。

1. **アーカイブされたイメージ**タブを選択します。

1. 復元するアーカイブ済みイメージを選択します。

1. **復元** を選択し、復元アクションを確認します。

1. 復元が完了するまで待ちます。復元が完了すると、イメージがアクティブなイメージリストに表示されます。

------
#### [ AWS CLI ]

**アーカイブされたイメージを復元するには**
+ **update-image-storage-class** コマンドを使用して、ストレージクラスを に更新してアーカイブされたイメージを復元します`STANDARD`。

  ```
  aws ecr update-image-storage-class \
      --repository-name my-repository \
      --image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
      --target-storage-class STANDARD
  ```

------

**describe-images** コマンドを使用してイメージを記述すると、復元されるイメージの は `image-status`になります`ACTIVATING`。値`image-status`でイメージをフィルタリング`ACTIVATING`して、現在復元中のイメージを表示できます。

アーカイブされたイメージを復元するもう 1 つの方法は、イメージをリポジトリに再プッシュすることです。現在アーカイブされているイメージをプッシュすると、そのイメージはすぐに復元され、アーカイブから削除されます。