クリーンアップ ポリシーの概要

Artifact Registry のクリーンアップ ポリシーでは、不要になったアーティファクト バージョンを自動的に削除する、または無期限に保存するアーティファクトを保持するための条件を定義します。

クリーンアップ ポリシーは、アーティファクトの多くのバージョンを保存するが、本番環境にリリースする特定のバージョンのみを保持する必要がある場合に便利です。アーティファクトを削除する条件で削除ポリシーを定義し、アーティファクトを保持する条件で保持ポリシーを定義できます。

アーティファクト バージョンが削除ポリシーと保持ポリシーの両方の条件と一致する場合、Artifact Registry は保持ポリシーを適用します。

削除ポリシーによってトリガーされる削除は、Artifact Registry のプロジェクトごとの削除リクエストの割り当てに対してカウントされ、1 日あたりのリポジトリごとに 300,000 件の削除に制限されます。

クリーンアップ ポリシーの種類

削除ポリシーでは、アーティファクトの削除の最小期間または最大期間を定義します。追加のフィルタリング条件を使用して、ポリシーを特定のアーティファクトに限定できます。削除ポリシーが有効になっている場合は、Artifact Registry が特定のアーティファクトを保持するように、さまざまな種類の保持ポリシーを構成することもできます。

  • 条件付き保持ポリシー: アーティファクトを保持する条件を定義します。条件付き保持ポリシーを構成して、削除ポリシーで削除されるアーティファクトを保持できます。アーティファクトが削除ポリシーと保持ポリシーの両方の条件と一致する場合、アーティファクトは保持されます。
  • 最新のバージョンを保持: 特定の範囲のアーティファクト バージョンを保持するための条件を定義します。条件付き保持と最新バージョンを保持の条件を、同じクリーンアップ ポリシーで使用することはできません。

ポリシーの適用順序

リポジトリに複数のクリーンアップ ポリシーがある場合、Artifact Registry は、保持ポリシーが削除ポリシーと同じイメージと一致しない限り、ポリシーを順番に適用します。たとえば、リポジトリに次の条件のクリーンアップ ポリシーがあるとします。

  1. 100 日以上経過した画像を削除します。
  2. バージョン接頭辞が 2.0.6 のイメージを保持します。
  3. default タグが付いたイメージを削除します。

リポジトリには、次の属性を持つイメージが含まれています。

画像 年齢 タグ バージョン
画像 A 120 日 default 2.0.1
画像 B 150 日 default 2.0.6
画像 C 20 日 patch 1.9.2

この例では、画像 A が削除され、画像 C が保持されます。イメージ B は、最初のポリシーと 3 番目のポリシーの削除条件にも一致しますが、イメージ バージョンに一致する保持ポリシーがあるため、保持されます。

ポリシーの適用スケジュール

Artifact Registry は、定期的に実行されるバックグラウンド ジョブを使用して、クリーンアップ ポリシーのドライランとアクティブ実行を行います。変更は約 1 日以内に有効になります。

リポジトリあたりのクリーンアップ ポリシーの最大数

リポジトリには最大 10 個のクリーンアップ ポリシーを適用できます。

サポートされているファイル形式

すべてのリポジトリ形式について、標準リポジトリとリモート リポジトリにクリーンアップ ポリシーを設定できます。

次のステップ