8.8 KiB
{% capture tabChar %} {% endcapture %} {% capture dockerBaseDesc %}The base command for the Docker CLI.{% endcapture %} {% if include.datafolder and include.datafile %}
Description
{% if include.datafile=="docker" %} {{ dockerBaseDesc }} {% else %} {{ site.data[include.datafolder][include.datafile].short }} {% endif %}
{% if site.data[include.datafolder][include.datafile].min_api_version %}
API {{ site.data[include.datafolder][include.datafile].min_api_version }}+
The client and daemon API must both be at least
{{ site.data[include.datafolder][include.datafile].min_api_version }}
to use this command. Use the docker version
command on the client to check
your client and daemon API versions.
{% endif %}
{% if site.data[include.datafolder][include.datafile].deprecated %}
This command is deprecated{: target="blank" class=""}.
It may be removed in a future Docker version. {: .warning }
{% endif %}
{% if site.data[include.datafolder][include.datafile].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
. {: .important }
{% endif %}
{% if site.data[include.datafolder][include.datafile].experimentalcli %}
This command is experimental.
This command is experimental on the Docker client. It should not be used in production environments. To enable experimental features in the Docker CLI, edit the config.json and set
experimental
toenabled
. {: .important }
{% endif %}
{% capture command-orchestrator %} {% if site.data[include.datafolder][include.datafile].swarm %}
Swarm This command works with the Swarm orchestrator.
{% endif %} {% if site.data[include.datafolder][include.datafile].kubernetes %}
Kubernetes This command works with the Kubernetes orchestrator.
{% endif %} {% endcapture %}{{ command-orchestrator }}
{% if site.data[include.datafolder][include.datafile].usage %}
Usage
{{ site.data[include.datafolder][include.datafile].usage | replace: tabChar,"" | strip }}{% if site.data[include.datafolder][include.datafile].cname %} COMMAND{% endif %}
{% endif %} {% if site.data[include.datafolder][include.datafile].options %} {% if site.data[include.datafolder][include.datafile].inherited_options %} {% assign alloptions = site.data[include.datafolder][include.datafile].options | concat:site.data[include.datafolder][include.datafile].inherited_options %} {% else %} {% assign alloptions = site.data[include.datafolder][include.datafile].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 %} {% capture min-api %}{% if option.min_api_version %}API {{ option.min_api_version }}+{% endif %}{%endcapture%} {% 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 %}
{% endfor %}
Name, shorthand | Default | Description |
`--{{ option.option }}{% if option.shorthand %} , -{{ option.shorthand }}{% endif %}` | {{ option-default }} | {% if all-badges != '' %}{{ all-badges | strip }} {% endif %}{{ option.description | strip }} |
{% endif %}
{% if site.data[include.datafolder][include.datafile].cname %}
Child commands
{% for command in site.data[include.datafolder][include.datafile].cname %} {% capture dataFileName %}{{ command | strip | replace: " ","_" }}{% endcapture %} {% endfor %}Command | Description |
[{{ command }}]({{ dataFileName | replace: "docker_","" }}/) | {{ site.data[include.datafolder][dataFileName].short }} |
{% if site.data[include.datafolder][include.datafile].pname %} {% unless site.data[include.datafolder][include.datafile].pname == include.datafile %}
Parent command
{% capture parentfile %}{{ site.data[include.datafolder][include.datafile].plink | replace: ".yaml", "" | replace: "docker_","" }}{% endcapture %} {% capture parentdatafile %}{{ site.data[include.datafolder][include.datafile].plink | replace: ".yaml", "" }}{% endcapture %}
{% if site.data[include.datafolder][include.datafile].pname == "docker" %} {% capture parentDesc %}{{ dockerBaseDesc }}{% endcapture %} {% else %} {% capture parentDesc %}{{ site.data[include.datafolder][parentdatafile].short }}{% endcapture %} {% endif %}
Command | Description |
---|---|
[{{ site.data[include.datafolder][include.datafile].pname }}]({{ parentfile }}) | {{ parentDesc }} |
{% endunless %} {% endif %}
{% unless site.data[include.datafolder][include.datafile].pname == "docker" or site.data[include.datafolder][include.datafile].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 }}]({{ dataFileName | replace: "docker_","" }}/) | {{ site.data[include.datafolder][dataFileName].short }} |
{% endunless %}
{% unless site.data[include.datafolder][include.datafile].long == site.data[include.datafolder][include.datafile].short %}
Extended description
{{ site.data[include.datafolder][include.datafile].long }}
{% endunless %}
{% if site.data[include.datafolder][include.datafile].examples %}
Examples
{{ site.data[include.datafolder][include.datafile].examples }}
{% endif %} {% else %}
The include.datafolder or include.datafile was not set.
{% endif %}