9.4.4. Removing tag expiration using annotations

Procedure

1. Enter the following oras push --annotation command to remove an annotation to the desired image tag. The annotation should be in the format quay.expires-after=never. For example:

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

   Example output

   ✓ 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

2. The latest manifest will no longer have an expiration time. Confirm that the expiration date has been removed by checking the Red Hat Quay UI, or by entering the following command:

   {"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}]}

   Note that no expiration time is listed.