Chapter 14. Red Hat Quay namespace auto-pruning overview

Procedure

1. Tag four sample images, for example, busybox, that will be pushed to the repository with auto-pruning enabled. For example:

   $ 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. Push the four sample images, for example, busybox, to the repository with auto-pruning enabled by entering the following commands:

   $ 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. Check that there are four tags in your repository.
4. On the Red Hat Quay UI v2, click Organizations in the navigation pane.
5. Select the name of an organization that you will apply the auto-pruning feature to, for example, test_organization.
6. Click Settings.

7. Click Auto-Prune Policies. For example:

   

8. Click the drop down menu and select the desired policy, for example, By number of tags.
9. Select the desired number of tags to keep. By default, this is set at 20 tags. For this example, the number of tags to keep is set at 3.

Procedure

1. Enter the following POST command create a new policy that limits the number of tags allowed in an organization:

   $ 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/<quayadmin>/autoprunepolicy/

   Alternatively, you can can set tags to expire for a specified time after their creation date:

   $ 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/<quayadmin>/autoprunepolicy/

   Example output

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

   Attempting to create multiple policies returns the following error:

   {"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. Check your auto-prune policy by entering the following command:

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

   Example output

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

3. You can delete the auto-prune policy by entering the following command:

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

Procedure

1. Enter the following POST command create a new policy that limits the number of tags for the current user:

   $ 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/

   Example output

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

2. Check your auto-prune policy by entering the following command:

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

   Alternatively, you can include the UUID:

   $ curl -X GET -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", "method": "number_of_tags", "value": 10}

   Example output

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

3. You can delete the auto-prune policy by entering the following command. Note that deleting the policy require the UUID.

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

   Example output

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