3.3. Searching for container images
Using the podman search command you can search selected container registries for images. You can also search for images in the Red Hat Container Catalog. The Red Hat Container Registry includes the image description, contents, health index, and other information.
The podman search command is not a reliable way to determine the presence or existence of an image. The podman search behavior of the v1 and v2 Docker distribution API is specific to the implementation of each registry. Some registries may not support searching at all. Searching without a search term only works for registries that implement the v2 API. The same holds for the docker search command.
To search for the postgresql-10 images in the quay.io registry, follow the steps.
Prerequisites
-
The
container-toolsmeta-package is installed. - The registry is configured.
Procedure
Authenticate to the registry:
# podman login quay.ioSearch for the image:
To search for a particular image on a specific registry, enter:
# podman search quay.io/postgresql-10 INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED redhat.io registry.redhat.io/rhel10/postgresql-10 This container image ... 0 redhat.io registry.redhat.io/rhscl/postgresql-10-rhel7 PostgreSQL is an ... 0Alternatively, to display all images provided by a particular registry, enter:
# podman search quay.io/To search for the image name in all registries, enter:
# podman search postgresql-10To display the full descriptions, pass the
--no-truncoption to the command.For more information, see the
podman-search(1)man page on your system.