NAME

Podman-搜索-搜索注册表中的图像

SYNOPSIS

podman search [options] term

DESCRIPTION

podman search 在注册表或注册表列表中搜索匹配的图像。用户可以通过在搜索项中添加注册表前缀来指定要搜索哪个注册表(例如， registry.fedoraproject.org/fedora )。默认情况下，所有未限定搜索注册表 containers-registries.conf(5) 都是用过的。

默认结果数为25。属性可以限制结果的数量。 --limit 旗帜。如果搜索多个注册表，则该限制将应用于每个注册表。可以使用 --filter 旗帜。要获取注册表中没有特定搜索词的所有可用图像，用户只需输入注册表名称，并在名称后面加上“/”(例如 registry.fedoraproject.org/ )。

请注意 podman search 不是确定是否存在图像的可靠方法。V1和v2 Docker分发API的搜索行为特定于每个注册表的实现。有些注册表可能根本不支持搜索。进一步注意，不带搜索词的搜索只适用于实现v2API的注册中心。

[podman [GLOBAL OPTIONS]]

[podman search [GLOBAL OPTIONS]]

[podman search [OPTIONS] TERM]

OPTIONS

--authfile = path

身份验证文件的路径。缺省值为 ${XDG_RUNTIME_DIR}/containers/auth.json 在Linux上，以及 $HOME/.config/containers/auth.json 在Windows/MacOS上。该文件由创建 podman login 。如果在那里找不到授权状态， $HOME/.docker/config.json 被选中，它是使用 docker login 。

注意：还可以通过设置 REGISTRY_AUTH_FILE 环境变量这可以通过以下方式完成 export REGISTRY_AUTH_FILE=path 。

--cert-dir = path

在以下位置使用证书 path (\ *.crt, * .cert，\ *.key) to connect to the registry. (Default: /etc/containers/certs.d) For details, see * containers-certs.d(5) *。(此选项不适用于远程Podman客户端，包括Mac和Windows(不包括WSL2)计算机)

--compatible

在名字和描述之后，还会像Docker一样显示星星、官方和自动描述符。默认情况下，Podman不会显示这些描述符，因为大多数公共容器注册中心都不支持它们。

--creds = [[用户名[：密码]]]

这个 [username[:password] ]如有需要，可用于向登记处进行认证。如果未提供其中一个或两个值，则会出现命令行提示符并可以输入值。输入密码时没有回显。

请注意，指定的凭据仅用于针对目标注册表进行身份验证。它们不用于镜像或在重写注册表时(请参见 containers-registries.conf(5) )；要针对那些考虑使用 containers-auth.json(5) 文件。

--filter ， -f = 过滤

根据提供的条件过滤输出(默认[])

支持的筛选器包括：

  • Starts(Int)-图像显示所需的最小星数

  • IS-Automated(布尔值-TRUE|FALSE)-镜像是否自动

  • Is-官方(Boolean-True|False)-形象是官方的还是非官方的

--format = 格式化

将输出格式更改为GO模板

下面列出了GO模板的有效占位符：

Placeholder

Description

.自动化

“ [OK] “如果图像是自动的

.描述

图像描述

.索引

登记处

.name

图像名称

.官方

“ [OK] “如果形象是官方的

.星星

图像星数

.标签

存储库标签

注意：仅当设置了--list-tag时才使用.Tag。

--help ， -h

打印用法报表

--limit = 限制

限制结果数(默认为25)。注意：每个注册表的结果仅限于此值。例如，如果Limit为10，并且搜索两个注册表，则结果总数为20，每个注册表中有10个(如果每个注册表中至少有10个匹配项)。搜索结果的顺序是API端点返回结果的顺序。

--list-tags

列出存储库中指定映像的可用标记。 注： --list-tag要求搜索词是完全指定的图像名称。结果包含图像名称及其标记，与图像关联的每个标记占一行。

--no-trunc

不截断输出(默认 错误 )。

--tls-verify

联系注册处时要求HTTPS并验证证书(默认： true )。如果显式设置为 true ，使用TLS验证。如果设置为 false ，不使用TLS验证。如果未指定，则使用TLS验证，除非目标注册表在 containers-registries.conf(5)

EXAMPLES

搜索包含指定名称的图像，返回每个已定义注册表中的前三个图像。

$ podman search --limit 3 fedora
NAME                                     DESCRIPTION
NAME                                           DESCRIPTION
registry.fedoraproject.org/f29/fedora-toolbox
registry.fedoraproject.org/f30/fedora-toolbox
registry.fedoraproject.org/f31/fedora-toolbox
docker.io/library/fedora                       Official Docker builds of Fedora
docker.io/kasmweb/fedora-37-desktop            Fedora 37 desktop for Kasm Workspaces
docker.io/kasmweb/fedora-38-desktop            Fedora 38 desktop for Kasm Workspaces
quay.io/fedora/fedora
quay.io/containerdisks/fedora                  # Fedora Containerdisk Images  <img src="htt...
quay.io/fedora/fedora-minimal

请注意，星形描述符、官方描述符和自动描述符仅在Docker Hub上可用，因此默认情况下不显示。

$ podman search --format "{{.Name}}\t{{.Stars}}\t{{.Official}}" alpine --limit 3
docker.io/library/alpine       7956        [OK]
docker.io/alpine/git           192
docker.io/anapsix/alpine-java  474
quay.io/libpod/alpine          0
quay.io/vqcomms/alpine-tools   0
quay.io/wire/alpine-deps       0

搜索并列出指定图像的标记，返回每个已定义注册表中的前四个图像。

$ podman search --list-tags registry.access.redhat.com/ubi8 --limit 4
NAME                             TAG
registry.access.redhat.com/ubi8  8.4-211
registry.access.redhat.com/ubi8  8.4-206.1626828523-source
registry.access.redhat.com/ubi8  8.4-199
registry.access.redhat.com/ubi8  8.4-211-source

注意：这只适用于实现v2API的注册表。如果尝试使用v1注册表，则会返回错误。

FILES

registries.conf (/etc/containers/registries.conf)

Registries.conf是一个配置文件，它指定在完成不包括注册表或域部分的镜像名称时参考哪些容器注册表。

另请参阅

[podman(1)] ， [containers-registries(5)]

HISTORY

2018年1月，最初由Urvashi Mohnaniumohnani@redhat.com汇编