opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-05-23 10:07:33 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix up example description of podman-create.1.md.in

Browse Source 
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
This commit is contained in:
Daniel J Walsh
2024-02-17 13:36:23 -05:00
parent fbb4d5dca6
commit d4b3ab521d
1 changed files with 13 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
docs/source/markdown/podman-create.1.md.in
View File

@ -387,59 +387,47 @@ Use the **--group-add keep-groups** option to pass the user's supplementary grou
## EXAMPLES ## EXAMPLES
### Create a container using a local image Create a container using a local image:
``` ```
$ podman create alpine ls $ podman create alpine ls
``` ```
### Create a container using a local image and annotate it Create a container using a local image and annotate it:
``` ```
$ podman create --annotation HELLO=WORLD alpine ls $ podman create --annotation HELLO=WORLD alpine ls
``` ```
### Create a container using a local image, allocating a pseudo-TTY, keeping stdin open and name it myctr Create a container using a local image, allocating a pseudo-TTY, keeping stdin open and name it myctr:
``` ```
podman create -t -i --name myctr alpine ls podman create -t -i --name myctr alpine ls
``` ```
### Set UID/GID mapping in a new user namespace
Running a container in a new user namespace requires a mapping of Running a container in a new user namespace requires a mapping of
the UIDs and GIDs from the host. the UIDs and GIDs from the host:
``` ```
$ podman create --uidmap 0:30000:7000 --gidmap 0:30000:7000 fedora echo hello $ podman create --uidmap 0:30000:7000 --gidmap 0:30000:7000 fedora echo hello
``` ```
### Setting automatic user namespace separated containers Setting automatic user-namespace separated containers:
``` ```
# podman create --userns=auto:size=65536 ubi8-init # podman create --userns=auto:size=65536 ubi8-init
``` ```
### Configure timezone in a container Configure timezone in a container:
``` ```
$ podman create --tz=local alpine date $ podman create --tz=local alpine date
$ podman create --tz=Asia/Shanghai alpine date $ podman create --tz=Asia/Shanghai alpine date
$ podman create --tz=US/Eastern alpine date $ podman create --tz=US/Eastern alpine date
``` ```
### Adding dependency containers Podman makes sure the first container (container1) is running before the second container (container2) is started:
Podman makes sure the first container, container1, is running before the second container (container2) is started.
``` ```
$ podman create --name container1 -t -i fedora bash $ podman create --name container1 -t -i fedora bash
$ podman create --name container2 --requires container1 -t -i fedora bash $ podman create --name container2 --requires container1 -t -i fedora bash
$ podman start --attach container2 $ podman start --attach container2
``` ```
Multiple containers can be required. Create a container which requires multiple containers:
``` ```
$ podman create --name container1 -t -i fedora bash $ podman create --name container1 -t -i fedora bash
$ podman create --name container2 -t -i fedora bash $ podman create --name container2 -t -i fedora bash
@ -447,32 +435,27 @@ $ podman create --name container3 --requires container1,container2 -t -i fedora
$ podman start --attach container3 $ podman start --attach container3
``` ```
### Exposing shared libraries inside of container as read-only using a glob Expose shared libraries inside of container as read-only using a glob:
``` ```
$ podman create --mount type=glob,src=/usr/lib64/libnvidia\*,ro -i -t fedora /bin/bash $ podman create --mount type=glob,src=/usr/lib64/libnvidia\*,ro -i -t fedora /bin/bash
``` ```
### Configure keep supplemental groups for access to volume Configure container to keep supplemental groups for access to volume:
``` ```
$ podman create -v /var/lib/design:/var/lib/design --group-add keep-groups ubi8 $ podman create -v /var/lib/design:/var/lib/design --group-add keep-groups ubi8
``` ```
### Configure execution domain for containers using personality flag Configure execution domain for containers using personality flag:
``` ```
$ podman create --name container1 --personality=LINUX32 fedora bash $ podman create --name container1 --personality=LINUX32 fedora bash
``` ```
### Create a container with external rootfs mounted as an overlay Create a container with external rootfs mounted as an overlay:
``` ```
$ podman create --name container1 --rootfs /path/to/rootfs:O bash $ podman create --name container1 --rootfs /path/to/rootfs:O bash
``` ```
### Create a container connected to two networks (called net1 and net2) with a static ip Create a container connected to two networks (called net1 and net2) with a static ip:
``` ```
$ podman create --network net1:ip=10.89.1.5 --network net2:ip=10.89.10.10 alpine ip addr $ podman create --network net1:ip=10.89.1.5 --network net2:ip=10.89.10.10 alpine ip addr
``` ```