Chapter 5. Red Hat Quay repository overview

Procedure

1. Click Repositories on the navigation pane.
2. Click Create Repository.

3. Select a namespace, for example, quayadmin, and then enter a Repository name, for example, testrepo.

   Important

   Do not use the following words in your repository name: * build * trigger * tag * notification

   When these words are used for repository names, users are unable access the repository, and are unable to permanently delete the repository. Attempting to delete these repositories returns the following error: Failed to delete repository <repository_name>, HTTP404 - Not Found.

4. Click Create.

   Now, your example repository should populate under the Repositories page.

5. Optional. Click Settings Repository visibility Make private to set the repository to private.

Procedure

1. Pull a sample page from an example registry. For example:

   $ sudo podman pull busybox

   Example output

   Trying to pull docker.io/library/busybox...
   Getting image source signatures
   Copying blob 4c892f00285e done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

2. Tag the image on your local system with the new repository and image name. For example:

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

3. Push the image to the registry. Following this step, you can use your browser to see the tagged image in your repository.

   $ sudo podman push --tls-verify=false quay-server.example.com/quayadmin/busybox:test

   Example output

   Getting image source signatures
   Copying blob 6b245f040973 done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures

Procedure

1. Enter the following command to create a repository using the POST /api/v1/repository endpoint:

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -d '{
       "repository": "<new_repository_name>",
       "visibility": "<private>",
       "description": "<This is a description of the new repository>."
     }' \
     "https://quay-server.example.com/api/v1/repository"

   Example output

   {"namespace": "quayadmin", "name": "<new_repository_name>", "kind": "image"}

Procedure

1. On the Repositories page of the v2 UI, check the box of the repository that you want to delete, for example, quayadmin/busybox.
2. Click the Actions drop-down menu.
3. Click Delete.

4. Type confirm in the box, and then click Delete.

   After deletion, you are returned to the Repositories page.

Procedure

1. Enter the following command to delete a repository using the DELETE /api/v1/repository/{repository} endpoint:

   $ curl -X DELETE   -H "Authorization: Bearer <bearer_token>" "<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>"

2. The CLI does not return information when deleting a repository from the CLI. To confirm deletion, you can check the Red Hat Quay UI, or you can enter the following GET /api/v1/repository/{repository} command to see if details are returned for the deleted repository:

   $ curl -X GET -H "Authorization: Bearer <bearer_token>" "<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>"

   Example output

   {"detail": "Not Found", "error_message": "Not Found", "error_type": "not_found", "title": "not_found", "type": "http://quay-server.example.com/api/v1/error/not_found", "status": 404}