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 命令进行编辑。
命令
命令 | 手册页 | 描述 |
---|---|---|
add | podman-system-connection-add(1) | 记录 Podman 服务的目标 |
default | podman-system-connection-default(1) | 将命名目标设置为 Podman 服务的默认目标 |
list | podman-system-connection-list(1) | 列出 Podman 服务的目标 |
remove | podman-system-connection-remove(1) | 删除命名目标 |
rename | podman-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 服务连接的详细情况,帮助他们了解每个连接的配置和状态,从而进行适当的管理和操作。
参见
历史
2020年6月,最初由 Jhon Honce (jhonce at redhat dot com) 整理
以上内容详细列出了 podman system connection
命令组中的各个子命令,包括它们的用途、手册页链接和简单的描述。此外,还提供了一个示例来展示如何列出系统连接,以及列出了相关的手册页和命令以供进一步参考。最后,给出了这个命令组的编写历史。