mirror of
https://github.com/containers/podman.git
synced 2025-08-06 03:19:52 +08:00
Document containers.conf settings for remote connections
Currently we don't document which end of the podman-remote client server operations uses the containers.conf. This PR begins documenting this and then testing to make sure the defaults follow the rules. Fixes: https://github.com/containers/podman/issues/7657 Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
This commit is contained in:
@ -18,6 +18,10 @@ any point.
|
||||
|
||||
The initial status of the container created with **podman create** is 'created'.
|
||||
|
||||
Default settings for flags are defined in `containers.conf`. Most settings for
|
||||
remote connections use the server's containers.conf, except when documented in
|
||||
man pages.
|
||||
|
||||
## OPTIONS
|
||||
#### **--add-host**=*host*
|
||||
|
||||
@ -817,6 +821,7 @@ Signal to stop a container. Default is SIGTERM.
|
||||
#### **--stop-timeout**=*seconds*
|
||||
|
||||
Timeout (in seconds) to stop a container. Default is 10.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--subgidname**=*name*
|
||||
|
||||
@ -893,10 +898,12 @@ standard input.
|
||||
#### **--tz**=*timezone*
|
||||
|
||||
Set timezone in container. This flag takes area-based timezones, GMT time, as well as `local`, which sets the timezone in the container to match the host machine. See `/usr/share/zoneinfo/` for valid timezones.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--umask**=*umask*
|
||||
|
||||
Set the umask inside the container. Defaults to `0022`.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--uidmap**=*container_uid:host_uid:amount*
|
||||
|
||||
|
@ -33,6 +33,10 @@ is located at _/run/.containerenv_.
|
||||
When running from a user defined network namespace, the _/etc/netns/NSNAME/resolv.conf_
|
||||
will be used if it exists, otherwise _/etc/resolv.conf_ will be used.
|
||||
|
||||
Default settings are defined in `containers.conf`. Most settings for remote
|
||||
connections use the servers containers.conf, except when documented in man
|
||||
pages.
|
||||
|
||||
## OPTIONS
|
||||
#### **--add-host**=_host_:_ip_
|
||||
|
||||
@ -857,6 +861,7 @@ Signal to stop a container. Default is **SIGTERM**.
|
||||
#### **--stop-timeout**=*seconds*
|
||||
|
||||
Timeout to stop a container. Default is **10**.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--subgidname**=*name*
|
||||
|
||||
@ -952,10 +957,12 @@ standard input.
|
||||
#### **--tz**=*timezone*
|
||||
|
||||
Set timezone in container. This flag takes area-based timezones, GMT time, as well as `local`, which sets the timezone in the container to match the host machine. See `/usr/share/zoneinfo/` for valid timezones.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--umask**=*umask*
|
||||
|
||||
Set the umask inside the container. Defaults to `0022`.
|
||||
Remote connections use local containers.conf for defaults
|
||||
|
||||
#### **--uidmap**=*container_uid*:*host_uid*:*amount*
|
||||
|
||||
|
@ -17,6 +17,10 @@ Podman uses Buildah(1) internally to create container images. Both tools share i
|
||||
(not container) storage, hence each can use or manipulate images (but not containers)
|
||||
created by the other.
|
||||
|
||||
Default settings for flags are defined in `containers.conf`. Most settings for
|
||||
Remote connections use the server's containers.conf, except when documented in
|
||||
man pages.
|
||||
|
||||
**podman [GLOBAL OPTIONS]**
|
||||
|
||||
## GLOBAL OPTIONS
|
||||
@ -33,6 +37,7 @@ Path of the configuration directory for CNI networks. (Default: `/etc/cni/net.d
|
||||
|
||||
#### **--connection**, **-c**
|
||||
Connection to use for remote podman (Default connection is configured in `containers.conf`)
|
||||
Remote connections use local containers.conf for default.
|
||||
|
||||
#### **--conmon**
|
||||
Path of the conmon binary (Default path is configured in `containers.conf`)
|
||||
@ -71,6 +76,7 @@ Identity value resolution precedence:
|
||||
- command line value
|
||||
- environment variable `CONTAINER_SSHKEY`, if `CONTAINER_HOST` is found
|
||||
- `containers.conf`
|
||||
Remote connections use local containers.conf for default.
|
||||
|
||||
#### **--log-level**=*level*
|
||||
|
||||
@ -86,6 +92,7 @@ Path to the command binary to use for setting up a network. It is currently onl
|
||||
|
||||
#### **--remote**, **-r**
|
||||
Access Podman service will be remote
|
||||
Remote connections use local containers.conf for default.
|
||||
|
||||
#### **--url**=*value*
|
||||
URL to access Podman service (default from `containers.conf`, rootless `unix://run/user/$UID/podman/podman.sock` or as root `unix://run/podman/podman.sock`).
|
||||
@ -104,6 +111,7 @@ URL value resolution precedence:
|
||||
- environment variable `CONTAINER_HOST`
|
||||
- `containers.conf`
|
||||
- `unix://run/podman/podman.sock`
|
||||
Remote connections use local containers.conf for default.
|
||||
|
||||
#### **--root**=*value*
|
||||
|
||||
|
Reference in New Issue
Block a user