mirror of
https://github.com/containers/podman.git
synced 2025-10-10 07:45:08 +08:00
feb36e4fe6
* Added flags to point to TLS PEM files to use for exposing and connecting to an encrypted remote API socket with server and client authentication. * Added TLS fields for system connection ls templates. * Added special "tls" format for system connection ls to list TLS fields in human-readable table format. * Updated remote integration and system tests to allow specifying a "transport" to run the full suite against a unix, tcp, tls, or mtls system service. * Added system tests to verify basic operation of unix, tcp, tls, and mtls services, clients, and connections. Signed-off-by: Andrew Melnick <meln5674.5674@gmail.com>
3.6 KiB
3.6 KiB
% podman-system-connection-list 1
NAME
podman-system-connection-list - List the destination for the Podman service(s)
SYNOPSIS
podman system connection list [options]
podman system connection ls [options]
DESCRIPTION
List ssh destination(s) for podman service(s).
OPTIONS
--format, -f=format
Change the default output format. This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template listed below:
| Placeholder | Description |
|---|---|
| .Default | Indicates whether connection is the default |
| .Identity | Path to file containing SSH identity |
| .Name | Connection Name/Identifier |
| .ReadWrite | Indicates if this connection can be modified using the system connection commands |
| .TLSCA | Path to a PEM file containing the certificate authority bundle to verify the server's certificate against. |
| .TLSCert | Path to a PEM file containing the certificate authority bundle to verify the server's certificate against. |
| .TLSKey | Path to a PEM file containing the private key matching .TLSCA |
| .URI | URI to podman service. Valid schemes are ssh://[user@]host[:port]Unix domain socket[?secure=True], unix://Unix domain socket, and tcp://localhost[:port] |
--quiet, -q
Only show connection names
EXAMPLE
List system connections:
$ podman system connection list
Name URI Identity Default ReadWrite
deva ssh://root@example.com:/run/podman/podman.sock ~/.ssh/id_rsa true true
devb ssh://user@example.com:/run/user/1000/podman/podman.sock ~/.ssh/id_rsa false true
Show connections in JSON format:
$ podman system connection list --format json
[
{
"Name": "podman-machine-default",
"URI": "ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock",
"Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
"IsMachine": true,
"Default": true,
"ReadWrite": true
},
{
"Name": "podman-machine-default-root",
"URI": "ssh://root@127.0.0.1:53298/run/podman/podman.sock",
"Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
"IsMachine": true,
"Default": false,
"ReadWrite": true
}
]
Show connection names and URIs:
$ podman system connection list --format "{{.Name}}\t{{.URI}}"
podman-machine-default ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
podman-machine-default-root ssh://root@127.0.0.1:53298/run/podman/podman.sock
Show all connection details in a comprehensive format:
$ podman system connection list --format "Name: {{.Name}}\nURI: {{.URI}}\nIdentity: {{.Identity}}\nDefault: {{.Default}}\nReadWrite: {{.ReadWrite}}\n---"
Name: podman-machine-default
URI: ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
Identity: /Users/ragm/.local/share/containers/podman/machine/machine
Default: true
ReadWrite: true
---
Name: podman-machine-default-root
URI: ssh://root@127.0.0.1:53298/run/podman/podman.sock
Identity: /Users/ragm/.local/share/containers/podman/machine/machine
Default: false
ReadWrite: true
---
SEE ALSO
podman(1), podman-system(1), podman-system-connection(1)
HISTORY
July 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)