opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-05-22 17:46:52 +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
### Create a container using a local image
Create a container using a local image:
```
$ 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
```
### 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
```
### Set UID/GID mapping in a new user namespace
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
```
### Setting automatic user namespace separated containers
Setting automatic user-namespace separated containers:
```
# 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=Asia/Shanghai 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 container2 --requires container1 -t -i fedora bash
$ 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 container2 -t -i fedora bash
@ -447,32 +435,27 @@ $ podman create --name container3 --requires container1,container2 -t -i fedora
$ 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
```
### 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
```
### Configure execution domain for containers using personality flag
Configure execution domain for containers using personality flag:
```
$ 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
```
### 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
```