mirror of
https://github.com/containers/podman.git
synced 2025-06-23 02:18:13 +08:00
Merge pull request #15548 from edsantiago/docs_dedup_restart
[CI:DOCS] Man pages: refactor common options: --restart
This commit is contained in:
15
docs/source/markdown/options/restart.md
Normal file
15
docs/source/markdown/options/restart.md
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
#### **--restart**=*policy*
|
||||||
|
|
||||||
|
Restart policy to follow when containers exit.
|
||||||
|
Restart policy will not take effect if a container is stopped via the **podman kill** or **podman stop** commands.
|
||||||
|
|
||||||
|
Valid _policy_ values are:
|
||||||
|
|
||||||
|
- `no` : Do not restart containers on exit
|
||||||
|
- `on-failure[:max_retries]` : Restart containers when they exit with a non-zero exit code, retrying indefinitely or until the optional *max_retries* count is hit
|
||||||
|
- `always` : Restart containers when they exit, regardless of status, retrying indefinitely
|
||||||
|
- `unless-stopped` : Identical to **always**
|
||||||
|
|
||||||
|
Please note that restart will not restart containers after a system reboot.
|
||||||
|
If this functionality is required in your environment, you can invoke Podman from a **systemd.unit**(5) file, or create an init script for whichever init system is in use.
|
||||||
|
To generate systemd unit files, please see **podman generate systemd**.
|
@ -500,21 +500,7 @@ Suppress output information when pulling images
|
|||||||
|
|
||||||
@@option requires
|
@@option requires
|
||||||
|
|
||||||
#### **--restart**=*policy*
|
@@option restart
|
||||||
|
|
||||||
Restart policy to follow when containers exit.
|
|
||||||
Restart policy will not take effect if a container is stopped via the `podman kill` or `podman stop` commands.
|
|
||||||
|
|
||||||
Valid values are:
|
|
||||||
|
|
||||||
- `no` : Do not restart containers on exit
|
|
||||||
- `on-failure[:max_retries]` : Restart containers when they exit with a non-0 exit code, retrying indefinitely or until the optional max_retries count is hit
|
|
||||||
- `always` : Restart containers when they exit, regardless of status, retrying indefinitely
|
|
||||||
- `unless-stopped` : Identical to **always**
|
|
||||||
|
|
||||||
Please note that restart will not restart containers after a system reboot.
|
|
||||||
If this functionality is required in your environment, you can invoke Podman from a systemd unit file, or create an init script for whichever init system is in use.
|
|
||||||
To generate systemd unit files, please see *podman generate systemd*
|
|
||||||
|
|
||||||
#### **--rm**
|
#### **--rm**
|
||||||
|
|
||||||
|
@ -531,21 +531,7 @@ Suppress output information when pulling images
|
|||||||
|
|
||||||
@@option requires
|
@@option requires
|
||||||
|
|
||||||
#### **--restart**=*policy*
|
@@option restart
|
||||||
|
|
||||||
Restart policy to follow when containers exit.
|
|
||||||
Restart policy will not take effect if a container is stopped via the **podman kill** or **podman stop** commands.
|
|
||||||
|
|
||||||
Valid _policy_ values are:
|
|
||||||
|
|
||||||
- `no` : Do not restart containers on exit
|
|
||||||
- `on-failure[:max_retries]` : Restart containers when they exit with a non-zero exit code, retrying indefinitely or until the optional *max_retries* count is hit
|
|
||||||
- `always` : Restart containers when they exit, regardless of status, retrying indefinitely
|
|
||||||
- `unless-stopped` : Identical to **always**
|
|
||||||
|
|
||||||
Please note that restart will not restart containers after a system reboot.
|
|
||||||
If this functionality is required in your environment, you can invoke Podman from a **systemd.unit**(5) file, or create an init script for whichever init system is in use.
|
|
||||||
To generate systemd unit files, please see **podman generate systemd**.
|
|
||||||
|
|
||||||
#### **--rm**
|
#### **--rm**
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user