mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-10-18 11:57:32 +00:00
7612af4c0e
This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type. - Adds the podman-quadlet-basic-usage.7.md for quadlet examples. - Majority of the text in the new files is copied from the podman-systemd.unit.5.md - Adds support for very simple condditional in the markdown_preprocess. - Uses new logic in markdown_preprocess in options/*.md to use a single .md file for both podman subcommands man-pages and quadlet man-pages. This deduplicates the Quadlet man-pages a lot. - Adds new `@@option quadlet:source.md`` preprocess command to import such .md files from options directory. Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
25 lines
1 KiB
Markdown
25 lines
1 KiB
Markdown
####> This option file is used in:
|
|
####> podman podman-container.unit.5.md.in, create, run
|
|
####> If file is edited, make sure the changes
|
|
####> are applicable to all of those.
|
|
<< if is_quadlet >>
|
|
### `ContainerName=name`
|
|
<< else >>
|
|
#### **--name**=*name*
|
|
<< endif >>
|
|
|
|
Assign a name to the container.
|
|
|
|
The operator can identify a container in three ways:
|
|
|
|
- UUID long identifier (“f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778”);
|
|
- UUID short identifier (“f78375b1c487”);
|
|
- Name (“jonah”).
|
|
|
|
Podman generates a UUID for each container, and if no name is assigned to the
|
|
container using << '**ContainerName=**' if is_quadlet else '**--name**' >>,
|
|
Podman generates a random string name. The name can
|
|
be useful as a more human-friendly way to identify containers. This works for
|
|
both background and foreground containers. The container's name is also added
|
|
to the `/etc/hosts` file using the container's primary IP address (also see the
|
|
<< '**AddHost=**' if is_quadlet else '**--add-host**' >> option).
|