summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
authorValentin Rothberg <rothberg@redhat.com>2020-06-15 13:49:36 +0200
committerValentin Rothberg <rothberg@redhat.com>2020-06-15 15:55:55 +0200
commitfe488b5f11836a021bcef6217aeeea41b1321217 (patch)
tree7a90c6966811ed33636cc645d7a252d08ff04a39 /docs/source
parentfa3b8a75c4ec571f8cbb2622ea624b42bc5c2472 (diff)
downloadpodman-fe488b5f11836a021bcef6217aeeea41b1321217.tar.gz
podman-fe488b5f11836a021bcef6217aeeea41b1321217.tar.bz2
podman-fe488b5f11836a021bcef6217aeeea41b1321217.zip
pod create --replace
Add a `--replace` flag to the `pod create` command. If another pod with the same name already exists, it will be replaced and removed. Adding this flag is motivated by #5485 to make running Podman in systemd units (or any other scripts/automation) more robust. In case of a crash, a pod may not be removed by a sytemd unit anymore. The `--replace` flag allows for supporting crashes. Note that the `--replace` flag does not require the `--name` flag to be set, so it can be set unconditionally in `podman generate systemd`. Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/markdown/podman-pod-create.1.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-pod-create.1.md b/docs/source/markdown/podman-pod-create.1.md
index de6b600f0..1401400bb 100644
--- a/docs/source/markdown/podman-pod-create.1.md
+++ b/docs/source/markdown/podman-pod-create.1.md
@@ -102,6 +102,10 @@ Use `podman port` to see the actual mapping: `podman port CONTAINER $CONTAINERPO
NOTE: This cannot be modified once the pod is created.
+**--replace**=**true**|**false**
+
+If another pod with the same name already exists, replace and remove it. The default is **false**.
+
**--share**=*namespace*
A comma delimited list of kernel namespaces to share. If none or "" is specified, no namespaces will be shared. The namespaces to choose from are ipc, net, pid, user, uts.