Как найти образ

Как найти образ

Для поиска образов в реестрах используется команда podman search.

$ podman search [опции] <поисковый запрос>

Вывод команды покажет список образов, удовлетворяющих поисковому запросу.

Ниже рассмотрены примеры поиска образа Nginx.

Поиск по всем реестрам⁠

$ podman search nginx

Вывод

NAME                                                            DESCRIPTION
quay.io/redhattraining/hello-world-nginx                        
quay.io/kubernetes-ingress-controller/nginx-ingress-controller  NGINX Ingress controller built around the [K...
quay.io/ukhomeofficedigital/nginx-proxy                         OpenResty Docker Container  [![Build Statu...
quay.io/nginx/nginx-ingress                                     
quay.io/cloud-bulldozer/nginx                                   
docker.io/library/nginx                                         Official build of Nginx.
docker.io/nginx/nginx-ingress                                   NGINX and  NGINX Plus Ingress Controllers fo...
docker.io/nginx/nginx-prometheus-exporter                       NGINX Prometheus Exporter for NGINX and NGIN...
docker.io/nginx/unit                                            This repository is retired, use the Docker o...
docker.io/nginx/nginx-ingress-operator                          NGINX Ingress Operator for NGINX and NGINX P...
...

По умолчанию podman search выполняет поиск образа во всех реестрах файла /etc/containers/registries.conf.

Вывод может оказаться пустым, если в файле /etc/containers/registries.conf не определены реестры, по которым проводится поиск.

Ниже указаны способы настроить реестры по умолчанию для поиска.

Настройка реестров по умолчанию для поиска⁠

В конфиге

1. Откройте файл /etc/containers/registries.conf с помощью редактора.
2. Внесите изменения в секцию [registries.search] — добавьте нужные реестры.

Пример формата TOML с секциями

[registries.search]  # Реестры для поиска образов
registries = [
    'docker.io',
    'quay.io',
    'registry.fedoraproject.org',
    'registry.access.redhat.com',
    'registry.opensuse.org'
]

Командой

Команда ниже добавляет секции [registries.search] с реестрами quay.io и docker.io в файл /etc/containers/registries.conf.

$ echo -e "[registries.search]\nregistries = ['quay.io', 'docker.io']" | sudo tee -a /etc/containers/registries.conf > /dev/null

Если секция [registries.search] уже существует, нужно вручную отредактировать файл /etc/containers/registries.conf.

Поиск по указанному реестру⁠

Для поиска в определенном реестре образов необходимо добавить префикс <имя реестра>/ перед именем образа — например, docker.io/.

$ podman search docker.io/nginx

Вывод

NAME                                              DESCRIPTION
docker.io/library/nginx                           Official build of Nginx.
docker.io/nginx/nginx-ingress                     NGINX and  NGINX Plus Ingress Controllers fo...
docker.io/nginx/nginx-prometheus-exporter         NGINX Prometheus Exporter for NGINX and NGIN...
docker.io/nginx/unit                              This repository is retired, use the Docker o...
docker.io/nginx/nginx-ingress-operator            NGINX Ingress Operator for NGINX and NGINX P...
docker.io/nginx/nginx-quic-qns                    NGINX QUIC interop
docker.io/nginx/nginxaas-loadbalancer-kubernetes  
docker.io/nginx/unit-preview                      Unit preview features
docker.io/bitnami/nginx                           Bitnami container image for NGINX
docker.io/ubuntu/nginx                            Nginx, a high-performance reverse proxy & we...
...

Даже при указании реестра результатов может быть много, потому что реестры позволяют публиковать разные версии одного и того же ПО, отличающиеся настройками, тегами и модификациями.

Ограничение количества результатов⁠

Для того, чтобы ограничить количество результатов, используйте опцию --limit <количество>.

Найти образы Nginx в реестре docker.io и показать первые пять результатов:

$ podman search --limit 5 docker.io/nginx

Вывод

NAME                                              DESCRIPTION
docker.io/library/nginx                           Official build of Nginx.
docker.io/nginx/nginx-ingress                     NGINX and  NGINX Plus Ingress Controllers fo...
docker.io/nginx/nginx-prometheus-exporter         NGINX Prometheus Exporter for NGINX and NGIN...
docker.io/nginx/unit                              This repository is retired, use the Docker o...
docker.io/nginx/nginx-ingress-operator            NGINX Ingress Operator for NGINX and NGINX P...