15.2. Red Hat Quay UI を使用した自動プルーニングポリシーの管理

手順

1. config.yaml ファイルを更新して、DEFAULT_NAMESPACE_AUTOPRUNE_POLICY 設定フィールドを追加します。

   1. 指定したタグの数まで作成日順に最も古いタグを削除するポリシーメソッドを設定するには、number_of_tags メソッドを使用します。

      # ...
      DEFAULT_NAMESPACE_AUTOPRUNE_POLICY:
        method: number_of_tags
        value: 2 1
      # ...

      1

      この場合、2 つのタグが残ります。

   2. 指定した期間 (たとえば 5d) よりも作成日が古いタグを削除するポリシーメソッドを設定するには、creation_date メソッドを使用します。

      DEFAULT_NAMESPACE_AUTOPRUNE_POLICY:
        method: creation_date
        value: 5d

2. Red Hat Quay デプロイメントを再起動します。

3. オプション: この機能をテストするためにイメージにタグを付けてプッシュする必要がある場合、以下を実行します。

   1. Red Hat Quay レジストリーにプッシュする 4 つのサンプルイメージにタグを付けます。以下に例を示します。

      $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test

      $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test2

      $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test3

      $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test4

   2. 次のコマンドを入力して、自動プルーニングを有効にした状態で 4 つのサンプルイメージをレジストリーにプッシュします。

      $ podman push <quay-server.example.com>/quayadmin/busybox:test

      $ podman push <quay-server.example.com>/<quayadmin>/busybox:test2

      $ podman push <quay-server.example.com>/<quayadmin>/busybox:test3

      $ podman push <quay-server.example.com>/<quayadmin>/busybox:test4

4. イメージのプッシュ先のレジストリーで 4 つのタグがあることを確認します。
5. デフォルトでは、レジストリーレベルの自動プルーナーワーカーが 24 時間ごとに実行されます。この手順を実行した場合、24 時間後に最も古い 2 つのイメージタグが削除され、test3 タグと test4 タグが残ります。Red Hat Quay 組織をチェックして、最も古い 2 つのタグが削除されていることを確認します。

手順

1. 自動プルーニングが有効なリポジトリーにプッシュする 4 つのサンプルイメージ (busybox など) にタグを付けます。以下に例を示します。

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test2

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test3

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<quayadmin>/busybox:test4

2. 次のコマンドを入力して、4 つのサンプルイメージ (busybox など) を自動プルーニングが有効なリポジトリーにプッシュします。

   $ podman push <quay-server.example.com>/quayadmin/busybox:test

   $ podman push <quay-server.example.com>/<quayadmin>/busybox:test2

   $ podman push <quay-server.example.com>/<quayadmin>/busybox:test3

   $ podman push <quay-server.example.com>/<quayadmin>/busybox:test4

3. リポジトリーに 4 つのタグがあることを確認します。
4. Red Hat Quay v2 UI で、ナビゲーションペインの Organizations をクリックします。
5. 自動プルーニング機能を適用する組織の名前を選択します (例: test_organization)。
6. Settings をクリックします。

7. Auto-Prune Policies をクリックします。以下に例を示します。

   

8. ドロップダウンメニューをクリックして、目的のポリシー (By number of tags など) を選択します。
9. 保持するタグの数を選択します。デフォルトでは、これは 20 タグに設定されています。この例では、保持するタグの数は 3 に設定されています。
10. Save をクリックします。自動プルーニングポリシーが更新されたという通知が表示されます。

手順

1. 次の POST コマンドを入力して、組織内で許可するタグの数を制限する新しいポリシーを作成します。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{"method": "number_of_tags", "value": 10}' http://<quay-server.example.com>/api/v1/organization/<organization_name>/autoprunepolicy/

   または、タグの作成日から指定期間が経過すると期限切れになるようにタグを設定することもできます。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{
   "method": "creation_date", "value": "7d"}' http://<quay-server.example.com>/api/v1/organization/<organization_name>/autoprunepolicy/

   出力例

   {"uuid": "73d64f05-d587-42d9-af6d-e726a4a80d6e"}

   重複したポリシーを作成しようとすると、次のエラーが返されます。

   {"detail": "Policy for this namespace already exists, delete existing to create new policy", "error_message": "Policy for this namespace already exists, delete existing to create new policy", "error_type": "invalid_request", "title": "invalid_request", "type": "http://<quay-server.example.com>/api/v1/error/invalid_request", "status": 400}

2. 次のコマンドを入力して、自動プルーニングポリシーを確認します。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/organization/<organization_name>/autoprunepolicy/

   出力例

   {"policies": [{"uuid": "73d64f05-d587-42d9-af6d-e726a4a80d6e", "method": "creation_date", "value": "7d"}]}

3. 次のコマンドを入力すると、自動プルーニングポリシーを削除できます。ポリシーを削除するには UUID が必要であることに注意してください。

   $ curl -X DELETE -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/organization/<organization_name>/autoprunepolicy/73d64f05-d587-42d9-af6d-e726a4a80d6e

手順

1. 次の POST コマンドを入力して、現在のユーザーのタグ数を制限する新しいポリシーを作成します。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{"method": "number_of_tags", "value": 10}' http://<quay-server.example.com>/api/v1/<user>/autoprunepolicy/

   出力例

   {"uuid": "8c03f995-ca6f-4928-b98d-d75ed8c14859"}

2. 次のコマンドを入力して、自動プルーニングポリシーを確認します。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/<user>/autoprunepolicy/8c03f995-ca6f-4928-b98d-d75ed8c14859

   または、UUID を含めることもできます。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/<user>/autoprunepolicy/

   出力例

   {"policies": [{"uuid": "8c03f995-ca6f-4928-b98d-d75ed8c14859", "method": "number_of_tags", "value": 10}]}

3. 次のコマンドを入力すると、自動プルーニングポリシーを削除できます。ポリシーを削除するには UUID が必要であることに注意してください。

   $ curl -X DELETE -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/<user>/autoprunepolicy/8c03f995-ca6f-4928-b98d-d75ed8c14859

   出力例

   {"uuid": "8c03f995-ca6f-4928-b98d-d75ed8c14859"}

手順

1. 自動プルーニングが有効なリポジトリーにプッシュする 4 つのサンプルイメージ (busybox など) にタグを付けます。以下に例を示します。

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<organization_name>/<repository_name>:test

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<organization_name>/<repository_name>:test2

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<organization_name>/<repository_name>:test3

   $ podman tag docker.io/library/busybox <quay-server.example.com>/<organization_name>/<repository_name>:test4

2. 次のコマンドを入力して、4 つのサンプルイメージ (busybox など) を自動プルーニングが有効なリポジトリーにプッシュします。

   $ podman push <quay-server.example.com>/<organization_name>/<repository_name>:test

   $ podman push <quay-server.example.com>/<organization_name>/<repository_name>:test2

   $ podman push <quay-server.example.com>/<organization_name>/<repository_name>:test3

   $ podman push <quay-server.example.com>/<organization_name>/<repository_name>:test4

3. リポジトリーに 4 つのタグがあることを確認します。
4. Red Hat Quay v2 UI のナビゲーションペインで Repository をクリックします。
5. 自動プルーニング機能を適用する組織の名前を選択します (例: <organization_name>/<repository_name>)。
6. Settings をクリックします。
7. Repository Auto-Prune Policies をクリックします。
8. ドロップダウンメニューをクリックして、目的のポリシー (By number of tags など) を選択します。
9. 保持するタグの数を選択します。デフォルトでは、これは 20 タグに設定されています。この例では、保持するタグの数は 3 に設定されています。
10. Save をクリックします。自動プルーニングポリシーが更新されたという通知が表示されます。

手順

1. 次の POST コマンドを入力して、組織内で許可するタグの数を制限する新しいポリシーを作成します。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{"method": "number_of_tags","value": 2}' http://<quay-server.example.com>/api/v1/repository/<organization_name>/<repository_name>/autoprunepolicy/

   または、タグの作成日から指定期間が経過すると期限切れになるようにタグを設定することもできます。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{"method": "creation_date", "value": "7d"}' http://<quay-server.example.com>/api/v1/repository/<organization_name>/<repository_name>/autoprunepolicy/

   出力例

   {"uuid": "ce2bdcc0-ced2-4a1a-ac36-78a9c1bed8c7"}

   重複したポリシーを作成しようとすると、次のエラーが返されます。

   {"detail": "Policy for this namespace already exists, delete existing to create new policy", "error_message": "Policy for this namespace already exists, delete existing to create new policy", "error_type": "invalid_request", "title": "invalid_request", "type": "http://quay-server.example.com/api/v1/error/invalid_request", "status": 400}

2. 次のコマンドを入力して、自動プルーニングポリシーを確認します。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/repository/<organization_name>/<repository_name>/autoprunepolicy/

   または、UUID を含めることもできます。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/repository/<organization_name>/<repository_name>/autoprunepolicy/ce2bdcc0-ced2-4a1a-ac36-78a9c1bed8c7

   出力例

   {"policies": [{"uuid": "ce2bdcc0-ced2-4a1a-ac36-78a9c1bed8c7", "method": "number_of_tags", "value": 10}]}

3. 次のコマンドを入力すると、自動プルーニングポリシーを削除できます。ポリシーを削除するには UUID が必要であることに注意してください。

   $ curl -X DELETE -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/repository/<organization_name>/<repository_name>/autoprunepolicy/ce2bdcc0-ced2-4a1a-ac36-78a9c1bed8c7

   出力例

   {"uuid": "ce2bdcc0-ced2-4a1a-ac36-78a9c1bed8c7"}

手順

1. 次の POST コマンドを入力して、現在のユーザーのタグ数を制限する新しいポリシーを作成します。

   $ curl -X POST -H "Authorization: Bearer <access_token>" -H "Content-Type: application/json" -d '{"method": "number_of_tags","value": 2}' http://<quay-server.example.com>/api/v1/repository/<user_account>/<user_repository>/autoprunepolicy/

   出力例

   {"uuid": "7726f79c-cbc7-490e-98dd-becdc6fefce7"}

2. 次のコマンドを入力して、自動プルーニングポリシーを確認します。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/repository/<user_account>/<user_repository>/autoprunepolicy/

   または、UUID を含めることもできます。

   $ curl -X GET -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/repository/<user_account>/<user_repository>/autoprunepolicy/7726f79c-cbc7-490e-98dd-becdc6fefce7

   出力例

   {"policies": [{"uuid": "7726f79c-cbc7-490e-98dd-becdc6fefce7", "method": "number_of_tags", "value": 2}]}

3. 次のコマンドを入力すると、自動プルーニングポリシーを削除できます。ポリシーを削除するには UUID が必要であることに注意してください。

   $ curl -X DELETE -H "Authorization: Bearer <access_token>" http://<quay-server.example.com>/api/v1/user/autoprunepolicy/7726f79c-cbc7-490e-98dd-becdc6fefce7

   出力例

   {"uuid": "7726f79c-cbc7-490e-98dd-becdc6fefce7"}