跳到主要内容

podman -system -connection - 管理 Podman 服务的目标(s)

概述

Podman是一个无守护进程、无根的容器引擎,专为在Linux系统上开发、管理和运行符合OpenContainer Initiative(OCI)标准的容器和容器镜像而设计。它为开发者提供了一个与Docker兼容的命令行前端,使得从Docker迁移到Podman变得简单。

在Podman中,-system-connection 是与连接管理相关的命令行选项。这些选项允许用户查看、添加、删除或修改Podman与远程容器运行时之间的连接设置。

-system 选项通常用于指示Podman对系统级的配置或资源进行操作。这包括连接管理,因为连接设置通常属于系统级别的配置。

-connection 选项则用于指定或操作特定的连接。通过它,用户可以查看当前存在的连接、添加新的连接、删除现有的连接,或者修改连接的配置。这对于需要连接到远程Podman服务或容器运行时的场景特别有用。

例如,使用 podman system connection list 命令可以查看当前系统中所有的Podman连接。如果需要添加一个新的连接,可以使用 podman system connection add 命令并指定相应的参数。

总的来说,Podman的 -system -connection 功能为开发者提供了灵活且强大的容器连接管理能力,使得在不同环境或场景下都能轻松地使用和管理容器。

podman system connection 子命令

描述

管理 Podman 服务的目标。

当用户需要时,系统会提示输入 ssh 登录密码或密钥文件的密码短语。如果 ssh-agent 正在运行,则支持使用它。

Podman 通过写入和读取位于 $XDG_CONFIG_HOME/containers 下的 podman-connections.json 文件来管理系统连接,如果未设置该环境变量,则默认为 $HOME/.config/containers。 或者,可以设置 PODMAN_CONNECTIONS_CONF 环境变量为一个完整的文件路径,Podman 将使用此路径代替。 该文件由 Podman 命令管理,用户不应直接编辑。要手动配置连接,请在 containers.conf 中使用 service_destinations

如果 podman system connection list 输出中的 ReadWrite 列设置为 true,则连接存储在 podman-connections.json 文件中,否则它将存储在 containers.conf 中,因此无法使用 podman system connection 命令进行编辑。

命令

命令手册页描述
addpodman-system-connection-add(1)记录 Podman 服务的目标
defaultpodman-system-connection-default(1)将命名目标设置为 Podman 服务的默认目标
listpodman-system-connection-list(1)列出 Podman 服务的目标
removepodman-system-connection-remove(1)删除命名目标
renamepodman-system-connection-rename(1)重命名 Podman 服务的目标

示例

列出系统连接:

$ podman system connection list
名称 地址 路径 Default ReadWrite
devl ssh://root@example.com/run/podman/podman.sock ~/.ssh/id_rsa true true

Default:这个列指示连接是否是默认连接。如果设置为 true,则该连接将在没有指定其他连接的情况下被默认使用。

ReadWrite:这个列指示连接是否可读写。如果设置为 true,表示该连接可以被修改(例如,通过添加、删除等操作)。如果设置为 false,则表示该连接不能被修改。


这些信息为用户提供了关于 Podman 服务连接的详细情况,帮助他们了解每个连接的配置和状态,从而进行适当的管理和操作。

参见

podman(1), podman-system(1)

历史

2020年6月,最初由 Jhon Honce (jhonce at redhat dot com) 整理


以上内容详细列出了 podman system connection 命令组中的各个子命令,包括它们的用途、手册页链接和简单的描述。此外,还提供了一个示例来展示如何列出系统连接,以及列出了相关的手册页和命令以供进一步参考。最后,给出了这个命令组的编写历史。