9.4. 设置标签过期

流程

1. 在 Red Hat Quay v2 UI 仪表板上，单击导航窗格中的 Repositories。
2. 单击具有镜像标签的存储库的名称。
3. 点镜像菜单 kebab 并选择 Change expiration。
4. 可选。或者，您可以通过点多个标签框来批量添加过期日期，然后选择 Actions Set expiration。
5. 在 Change Tags Expiration 窗口中，设置一个到期日期，指定星期几、月份、月份和年份。例如，2023 年 11 月 15 日星期三。或者，您可以点击日历按钮并手动选择日期。
6. 设置时间，例如 2:30 PM。
7. 单击 Change Expiration 以确认日期和时间。返回以下通知：成功将 标签测试的过期时间设置为 2023 年 11 月 15 日，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

   请注意，没有列出过期时间。