Chapter 5. Using Red Hat Quay
Chapter 5. Using Red Hat Quay The following steps show you how to use the interface to create new organizations and repositories, and to search and browse existing repositories. Following step 3, you can use the command line interface to interact with the registry and to push and pull images. Procedure Use your browser to access the user interface for the Red Hat Quay registry at http://quay-server.example.com , assuming you have configured quay-server.example.com as your hostname in your /etc/hosts file and in your config.yaml file. Click Create Account and add a user, for example, quayadmin with a password password . From the command line, log in to the registry: USD sudo podman login --tls-verify=false quay-server.example.com Example output Username: quayadmin Password: password Login Succeeded! 5.1. Pushing and pulling images on Red Hat Quay Use the following procedure to push and pull images to your Red Hat Quay registry. Procedure To test pushing and pulling images from the Red Hat Quay registry, first pull a sample image from an external registry: USD 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 Enter the following command to see the local copy of the image: USD sudo podman images Example output REPOSITORY TAG IMAGE ID CREATED SIZE docker.io/library/busybox latest 22667f53682a 14 hours ago 1.45 MB Enter the following command to tag this image, which prepares the image for pushing it to the registry: USD sudo podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test Push the image to your registry. Following this step, you can use your browser to see the tagged image in your repository. USD 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 To test access to the image from the command line, first delete the local copy of the image: USD sudo podman rmi quay-server.example.com/quayadmin/busybox:test Example output Untagged: quay-server.example.com/quayadmin/busybox:test Pull the image again, this time from your Red Hat Quay registry: USD sudo podman pull --tls-verify=false quay-server.example.com/quayadmin/busybox:test Example output Trying to pull quay-server.example.com/quayadmin/busybox:test... Getting image source signatures Copying blob 6ef22a7134ba [--------------------------------------] 0.0b / 0.0b Copying config 22667f5368 done Writing manifest to image destination Storing signatures 22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9 5.2. Accessing the superuser admin panel If you added a superuser to your config.yaml file, you can access the Superuser Admin Panel on the Red Hat Quay UI by using the following procedure. Prerequisites You have configured a superuser. Procedure Access the Superuser Admin Panel on the Red Hat Quay UI by clicking on the current user's name or avatar in the navigation pane of the UI. Then, click Superuser Admin Panel . On this page, you can manage users, your organization, service keys, view change logs, view usage logs, and create global messages for your organization.
sudo podman login --tls-verify=false quay-server.example.com Username: quayadmin Password: password Login Succeeded! sudo podman pull busybox 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 sudo podman images REPOSITORY TAG IMAGE ID CREATED SIZE docker.io/library/busybox latest 22667f53682a 14 hours ago 1.45 MB sudo podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test sudo podman push --tls-verify=false quay-server.example.com/quayadmin/busybox:test Getting image source signatures Copying blob 6b245f040973 done Copying config 22667f5368 done Writing manifest to image destination Storing signatures sudo podman rmi quay-server.example.com/quayadmin/busybox:test Untagged: quay-server.example.com/quayadmin/busybox:test sudo podman pull --tls-verify=false quay-server.example.com/quayadmin/busybox:test Trying to pull quay-server.example.com/quayadmin/busybox:test Getting image source signatures Copying blob 6ef22a7134ba [--------------------------------------] 0.0b / 0.0b Copying config 22667f5368 done Writing manifest to image destination Storing signatures 22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9