9.3 KiB
{% capture tabChar %} {% endcapture %} {% assign controller_data = site.data[include.datafolder][include.datafile] %} {% assign parentPath = page.path | prepend: "/" | remove: page.name %}
{{ controller_data.short | replace_relative_links: page.path }}
{% if controller_data.min_api_version %} {% comment %} To reduce unnecessary clutter on the page, we only show the minimum required API version if it requires a relatively recent version of the Engine, which is configured through the "min_api_threshold" option in _config.yml
Below, we first convert the min_api_version from a string to a number, so that we can compare versions (see https://stackoverflow.com/a/27200972/1811501), then compare it, to decide whether to show the "minimum required API version". {% endcomment %} {% assign min_api_version = controller_data.min_api_version | plus: 0 %} {% if min_api_version >= site.min_api_threshold %}
API {{ controller_data.min_api_version }}+
The client and daemon API must both be at least
{{ controller_data.min_api_version }}
to use this command. Use the docker version
command on the client to check
your client and daemon API versions.
{% endif %} {% endif %}
{% if controller_data.deprecated %}
This command is deprecated{: target="blank" rel="noopener" class=""}.
It may be removed in a future Docker version. For more information, see the Docker Roadmap{: target="blank" rel="noopener" class=""}. {: .warning }
{% endif %}
{% if controller_data.experimental %}
This command is experimental.
This command is experimental on the Docker daemon. It should not be used in production environments. To enable experimental features on the Docker daemon, edit the daemon.json and set
experimental
totrue
.{% include experimental.md %}
{% endif %}
{% if controller_data.experimentalcli %}
This command is experimental.
Experimental features are intended for testing and feedback as their functionality or UX may change between releases without warning or can be removed entirely in a future release. {: .important }
{% endif %}
{% capture command-orchestrator %} {% if controller_data.swarm %}
Swarm This command works with the Swarm orchestrator.
{% endif %} {% if controller_data.kubernetes %}
Kubernetes This command works with the Kubernetes orchestrator.
{% endif %} {% endcapture %}{{ command-orchestrator }}
{% if controller_data.usage %}
Usage
$ {{ controller_data.usage | replace: tabChar, "" | strip }}{% if controller_data.cname %} COMMAND{% endif %}
{% endif %}
{% unless controller_data.long == controller_data.short %}
{% if controller_data.options %}
Refer to the options section for an overview of available OPTIONS
for this command.
{% endif %}
Description
{: name="extended-description"}
{{ controller_data.long | replace_relative_links: page.path }}
{% endunless %}
{% if controller_data.examples %} For example uses of this command, refer to the examples section below. {% endif %}
{% if controller_data.options %} {% if controller_data.inherited_options %} {% assign alloptions = controller_data.options | concat:controller_data.inherited_options %} {% else %} {% assign alloptions = controller_data.options %} {% endif %}
Options
{% for option in alloptions %} {% capture deprecated-badge %}{% if option.deprecated %}deprecated{% endif %}{% endcapture %} {% capture experimental-daemon-badge %}{% if option.experimental %}experimental (daemon){% endif %}{% endcapture %} {% capture experimental-cli-badge %}{% if option.experimentalcli %}experimental (CLI){% endif %}{% endcapture %} {%- if option.min_api_version -%} {% assign min_api_version = option.min_api_version | plus: 0 %} {% if min_api_version >= site.min_api_threshold %} {% capture min-api %}API {{ option.min_api_version }}+{%endcapture%} {%- endif -%} {%- else -%} {% capture min-api %}{%endcapture%} {%- endif -%} {% capture flag-orchestrator %}{% if option.swarm %}Swarm{% endif %}{% if option.kubernetes %}Kubernetes{% endif %}{% endcapture %} {% capture all-badges %}{{ deprecated-badge }}{{ experimental-daemon-badge }}{{ experimental-cli-badge }}{{ min-api }}{{ flag-orchestrator }}{% endcapture %} {% assign defaults-to-skip = "[],map[],false,0,0s,default,'',\"\"" | split: ',' %} {% capture option-default %}{% if option.default_value %}{% unless defaults-to-skip contains option.default_value or defaults-to-skip == blank %}`{{ option.default_value }}`{% endunless %}{% endif %}{% endcapture %} {% if option.details_url and option.details_url != '' -%} {%- else -%} {%- endif %} {% endfor %}Name, shorthand | Default | Description | |
[`--{{ option.option }}`]({{ option.details_url }}){% if option.shorthand %} , [`-{{ option.shorthand }}`]({{ option.details_url }}){% endif %} | `--{{ option.option }}`{% if option.shorthand %} , `-{{ option.shorthand }}`{% endif %} | {{ option-default }} | {% if all-badges != '' %}{{ all-badges | strip }} {% endif %}{{ option.description | strip | escape }} |
{% if controller_data.examples %}
Examples
{{ controller_data.examples | replace_relative_links: page.path }}
{% endif %}
{% if controller_data.pname %} {% unless controller_data.pname == include.datafile or controller_data.pname == "docker" %}
Parent command
{% capture parentfile %}{{ controller_data.plink | remove_first: ".yaml" | remove_first: "docker_" }}{% endcapture %} {% capture parentdatafile %}{{ controller_data.plink | remove_first: ".yaml" }}{% endcapture %} {% capture parentDesc %}{{ site.data[include.datafolder][parentdatafile].short }}{% endcapture %}
Command | Description |
---|---|
[{{ controller_data.pname }}]({{parentPath}}{{ parentfile }}/) | {{ parentDesc }} |
{% endunless %} {% endif %}
{% if controller_data.cname %}
Child commands
{% for command in controller_data.cname %} {% capture dataFileName %}{{ command | strip | replace: " ", "_" }}{% endcapture %} {% endfor %}Command | Description |
[{{ command }}]({{ parentPath }}{{ dataFileName | remove_first: "docker_" }}/) | {{ site.data[include.datafolder][dataFileName].short }} |
{% unless controller_data.pname == "docker" or controller_data.pname == "dockerd" or include.datafile=="docker" %}
Related commands
{% for command in site.data[include.datafolder][parentdatafile].cname %} {% capture dataFileName %}{{ command | strip | replace: " ", "_" }}{% endcapture %} {% endfor %}Command | Description |
[{{ command }}]({{ parentPath }}{{ dataFileName | remove_first: "docker_" }}/) | {{ site.data[include.datafolder][dataFileName].short }} |
{% endunless %}