mirror of
https://github.com/containers/podman.git
synced 2025-07-31 12:22:29 +08:00

Much like --cidfile (#15414), --pod-id-file has two meanings. One is used in pod-related commands, one in container ones. Both meanings read the file, so the read/write split used in --cidfile is not applicable here. podman-pod-create keeps its --pod-id-file option because that one cannot be refactored: that's the only command (now) that writes a pod-id file. Reviewable using hack/markdown-preprocess-review but I did take some liberties with the #### args because they were wrong. And, since I had to much with the description text anyway (resulting in diffs), I also took the liberty of cleaning up a double space. Signed-off-by: Ed Santiago <santiago@redhat.com>
57 lines
1.1 KiB
Markdown
57 lines
1.1 KiB
Markdown
% podman-pod-start(1)
|
|
|
|
## NAME
|
|
podman\-pod\-start - Start one or more pods
|
|
|
|
## SYNOPSIS
|
|
**podman pod start** [*options*] *pod* ...
|
|
|
|
## DESCRIPTION
|
|
Start containers in one or more pods. You may use pod IDs or names as input. The pod must have a container attached
|
|
to be started.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--all**, **-a**
|
|
|
|
Starts all pods
|
|
|
|
#### **--latest**, **-l**
|
|
|
|
Instead of providing the pod name or ID, start the last created pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
|
|
|
|
@@option pod-id-file.pod
|
|
|
|
## EXAMPLE
|
|
|
|
Start pod with a given name
|
|
```
|
|
podman pod start mywebserverpod
|
|
```
|
|
|
|
Start pods with given IDs
|
|
```
|
|
podman pod start 860a4b23 5421ab4
|
|
```
|
|
|
|
Start the latest pod created by Podman
|
|
```
|
|
podman pod start --latest
|
|
```
|
|
|
|
Start all pods
|
|
```
|
|
podman pod start --all
|
|
```
|
|
|
|
Start pod using ID specified in a given file
|
|
```
|
|
podman pod start --pod-id-file /path/to/id/file
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-stop(1)](podman-pod-stop.1.md)**
|
|
|
|
## HISTORY
|
|
July 2018, Adapted from podman start man page by Peter Hunt <pehunt@redhat.com>
|