2.7. Búsqueda de imágenes de contenedores
El comando podman search
le permite buscar imágenes en los registros de contenedores seleccionados.
También puede buscar imágenes en el Red Hat Container Registry. El Registro de Contenedores de Red Hat incluye la descripción de la imagen, el contenido, el índice de salud y otra información.
Puede encontrar la lista de registros en el archivo de configuración registries.conf
:
[registries.search] registries = ['registry.access.redhat.com', 'registry.redhat.io', 'docker.io'] [registries.insecure] registries = [] [registries.block] registries = []
-
Por defecto, el comando
podman search
busca imágenes de contenedores en los registros listados en la sección[registries.search]
en el orden dado. En este caso, el comandopodman search
busca la imagen solicitada en registry.access.redhat.com, registry.redhat.io y docker.io en este orden. -
La sección
[registries.insecure]
añade los registros que no utilizan TLS (un registro inseguro). -
La sección
[registries.block]
impide el acceso al registro desde su sistema local.
Como usuario root, puedes editar el archivo /etc/containers/registries.conf
para cambiar la configuración de búsqueda por defecto en todo el sistema.
Como usuario normal (sin raíz) de podman
, puede crear su propio archivo registries.conf
en su directorio personal ($HOME/.config/containers/registries.conf
) para anular la configuración de todo el sistema.
Asegúrese de seguir las condiciones al configurar los registros de los contenedores:
- Cada registro debe ir rodeado de comillas simples.
-
Si hay varios registros configurados para el
registries = value
, debe separar esos registros con comas. - Puede identificar los registros por su dirección IP o por su nombre de host.
- Si el registro utiliza un puerto no estándar, distinto de los puertos TCP 443 para el seguro y 80 para el inseguro, introduzca ese número de puerto con el nombre del registro. Por ejemplo: host.example.com:9999.
-
El sistema busca los registros en el orden en que aparecen en la lista
registries.search
del archivoregistries.conf
.
A continuación, algunos ejemplos de comandos de podman search
. El primer ejemplo ilustra la búsqueda infructuosa de todas las imágenes de quay.io. La barra diagonal al final significa buscar en todo el registro todas las imágenes accesibles para usted:
# podman search quay.io/ ERRO[0000] error searching registry "quay.io": couldn't search registry "quay.io": unable to retrieve auth token: invalid username/password
Para buscar en el registro de quay.io, inicie sesión primero:
# podman login quay.io Username: johndoe Password: *********** Login Succeeded! # podman search quay.io/ INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED quay.io quay.io/test/myquay 0 quay.io quay.io/test/redistest 0 quay.io quay.io/johndoe/websrv21 0 quay.io quay.io/johndoe/mydbtest 0 quay.io quay.io/johndoe/newbuild-10 0
Buscar en todos los registros disponibles las imágenes de postgresql
(se han encontrado más de 40 imágenes):
# podman search postgresql-10 INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED redhat.io registry.redhat.io/rhel8/postgresql-10 This container image ... 0 redhat.io registry.redhat.io/rhscl/postgresql-10-rhel7 PostgreSQL is an advanced ... 0 quay.io quay.io/mettle/postgresql-database-provisioning docker.io docker.io/centos/postgresql-10-centos7 PostgreSQL is an advanced ... 13 ...
Para limitar la búsqueda de postgresql
a las imágenes de registry.redhat.io, escriba el siguiente comando. Tenga en cuenta que al introducir el registro y el nombre de la imagen, se puede hacer coincidir cualquier repositorio del registro:
# podman search registry.redhat.io/postgresql-10 INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED redhat.io registry.redhat.io/rhel8/postgresql-10 This container image ... 0 redhat.io registry.redhat.io/rhscl/postgresql-10-rhel7 PostgreSQL is an ... 0
Para obtener descripciones más largas para cada imagen de contenedor, añada --no-trunc
al comando:
# podman search --no-trunc registry.redhat.io/rhel8/postgresql-10 INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED redhat.io registry.redhat.io/rhel8/postgresql-10 This container image provides a containerized packaging of the PostgreSQL postgres daemon and client application. The postgres server daemon accepts connections from clients and provides access to content from PostgreSQL databases on behalf of the clients. 0
Para acceder a registros inseguros, añada el nombre completo del registro en la sección [registries.insecure]
del archivo /etc/containers/registries.conf
. Por ejemplo:
[registries.search] registries = ['myregistry.example.com'] [registries.insecure] registries = ['myregistry.example.com']
A continuación, busque las imágenes de myimage
:
# podman search myregistry.example.com/myimage INDEX NAME DESCRIPTION STARS OFFICIAL AUTOMATED example.com myregistry.example.com/myimage The myimage container executes the ... 0
Ahora puedes sacar la imagen de myimage
:
# podman pull myimage.example.com/myimage