8.7. タグの有効期限を設定する

手順

1. Red Hat Quay v2 UI ダッシュボードのナビゲーションペインで Repositories をクリックします。
2. イメージタグのあるリポジトリーの名前をクリックします。
3. イメージの縦の省略記号メニューをクリックし、Change expiration を選択します。
4. オプション: または、複数のタグのボックスをクリックし、Actions Set expiration を選択して有効期限を一括追加することもできます。
5. Change Tags Expiration ウィンドウで、曜日、月、日、年を指定して有効期限を設定します。たとえば、Wednesday, November 15, 2023 に設定します。または、カレンダーボタンをクリックして日付を手動で選択することもできます。
6. 時刻を 2:30 PM などに設定します。
7. Change Expiration をクリックして日付と時刻を確認します。Successfully set expiration for tag test to Nov 15, 2023, 2:26 PM という通知が返されます。

8. Red Hat Quay v2 UI の Tags ページで、タグの有効期限の設定を確認できます。以下に例を示します。

   

手順

1. 目的のイメージタグにアノテーションを追加するには、次の oras push --annotation コマンドを入力します。アノテーションは、設定された時間にタグが期限切れになることを示すために quay.expires-after=<value> の形式にする必要があります。以下に例を示します。

   $ oras push --annotation quay.expires-after=<value> \
     <quay-server.example.com>/<organization>/<repository>:<tag> \
     <file_path>:<media_type>

   Copy to Clipboard Toggle word wrap

   出力例

   ✓ Uploaded  hello.txt                                                                                                       12/12  B 100.00%  321ms
     └─ sha256:74b9e308133afb3bceae961097cb2aa481483869d695ce1414cd2bc7f046027c
   ✓ Uploaded  application/vnd.oci.empty.v1+json                                                                                 2/2  B 100.00%  328ms
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                                                                    620/620  B 100.00%     0s
     └─ sha256:c370e931b5eca44fd753bd92e6991ed3be70008e8df15078083359409111f8c3
   Pushed [registry] quay-server.example.com/fortestuser/busybox:test2
   ArtifactType: application/vnd.unknown.artifact.v1

   Copy to Clipboard Toggle word wrap

2. Red Hat Quay UI を確認するか、次のコマンドを入力して、有効期限が適用されていることを確認します。

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/?specificTag=<tag>" \

   Copy to Clipboard Toggle word wrap

   出力例

   {"tags": [{"name": "test2", "reversion": false, "start_ts": 1743706344, "end_ts": 1743778344, "manifest_digest": "sha256:c370e931b5eca44fd753bd92e6991ed3be70008e8df15078083359409111f8c3", "is_manifest_list": false, "size": 12, "last_modified": "Thu, 03 Apr 2025 18:52:24 -0000", "expiration": "Fri, 04 Apr 2025 14:52:24 -0000"}, {"name": "test2", "reversion": false, "start_ts": 1742493776, "end_ts": 1743706344, "manifest_digest": "sha256:d80aa3d7f5f5388cfae543b990d3cd3d47ff51c48ef29ff66102427bf7bc0a88", "is_manifest_list": false, "size": 2266046, "last_modified": "Thu, 20 Mar 2025 18:02:56 -0000", "expiration": "Thu, 03 Apr 2025 18:52:24 -0000"}], "page": 1, "has_additional": false}

   Copy to Clipboard Toggle word wrap

手順

1. 目的のイメージタグへのアノテーションを削除するには、次の oras push --annotation コマンドを入力します。アノテーションは quay.expires-after=never 形式にする必要があります。以下に例を示します。

   $ oras push --annotation quay.expires-after=never \
     <quay-server.example.com>/<organization>/<repository>:<tag> \
     <file_path>:<media_type>

   Copy to Clipboard Toggle word wrap

   出力例

   ✓ Uploaded  hello.txt                                                                                                       12/12  B 100.00%  321ms
     └─ sha256:74b9e308133afb3bceae961097cb2aa481483869d695ce1414cd2bc7f046027c
   ✓ Uploaded  application/vnd.oci.empty.v1+json                                                                                 2/2  B 100.00%  328ms
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                                                                    620/620  B 100.00%     0s
     └─ sha256:c370e931b5eca44fd753bd92e6991ed3be70008e8df15078083359409111f8c3
   Pushed [registry] quay-server.example.com/fortestuser/busybox:test2
   ArtifactType: application/vnd.unknown.artifact.v1

   Copy to Clipboard Toggle word wrap

2. 最新のマニフェストには有効期限がなくなります。Red Hat Quay UI を確認するか、次のコマンドを入力して、有効期限が削除されたことを確認します。

   {"tags": [{"name": "test2", "reversion": false, "start_ts": 1743708135, "manifest_digest": "sha256:19e3a3501b4125cce9cb6bb26ac9207c325259bef94dc66490b999f93c4c83a9", "is_manifest_list": false, "size": 12, "last_modified": "Thu, 03 Apr 2025 19:22:15 -0000"}, {"name": "test2", "reversion": false, "start_ts": 1743706344, "end_ts": 1743708135}]}

   Copy to Clipboard Toggle word wrap

   有効期限は記載されていないことに注意してください。