mirror of
https://github.com/containers/podman.git
synced 2025-09-22 12:14:26 +08:00
c12b1b32bc
This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type, podman-quadlet.7.md for general quadlet information and podman-quadlet-basic-usage.7.md for quadlet examples. - Removes the original podman-systemd.unit.5.md file. - Adds support for jinja2 templating language in the markdown_preprocess. - Uses jinja2 in options/*.md to use the 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>
27 lines
1.2 KiB
Markdown
27 lines
1.2 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 %}
|
|
### `CgroupsMode=how`
|
|
{% else %}
|
|
#### **--cgroups**=*how*
|
|
{% endif %}
|
|
|
|
Determines whether the container creates CGroups.
|
|
|
|
{% if is_quadlet %}
|
|
By default, the cgroups mode of the container created by Quadlet is `split`,
|
|
which differs from the default (`enabled`) used by the Podman CLI.
|
|
|
|
If the container joins a pod (i.e. `Pod=` is specified), you may want to change this to
|
|
`no-conmon` or `enabled` so that pod level cgroup resource limits can take effect.
|
|
{% else %}
|
|
Default is **enabled**.
|
|
{% endif %}
|
|
|
|
The **enabled** option creates a new cgroup under the cgroup-parent.
|
|
The **disabled** option forces the container to not create CGroups, and thus conflicts with CGroup options (**--cgroupns** and **--cgroup-parent**).
|
|
The **no-conmon** option disables a new CGroup only for the **conmon** process.
|
|
The **split** option splits the current CGroup in two sub-cgroups: one for conmon and one for the container payload. It is not possible to set **--cgroup-parent** with **split**.
|