archive
/
ansible
mirror of https://github.com/ansible/ansible.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

docker_* modules: docs improvements (#63165)

Browse Source 
* Improve docker_container docs.

* Fix usage of C(...) and I(...).

* Fix abuses of I(...).

* tls_verify has been made an alias of validate_certs some time ago.

* Fix YAML problems.

* Update lib/ansible/modules/cloud/docker/docker_container.py

Co-Authored-By: Andrey Klychkov <aaklychkov@mail.ru>

* Update lib/ansible/modules/cloud/docker/docker_container.py

Co-Authored-By: Andrey Klychkov <aaklychkov@mail.ru>

* Fix order.

* Split long description.

* Improve formatting.

* Rewrite state docs.

* Make proper sentences.
pull/62438/head
Felix Fontein 5 years ago committed by GitHub
parent 1d5206f53e
commit 5349b3ae4c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
15 changed files with 193 additions and 188 deletions
Show Stats Download Patch File Download Diff File

8
lib/ansible/modules/cloud/docker/docker_config.py
Unescape Escape View File

@ -24,7 +24,7 @@ description:
- Create and remove Docker configs in a Swarm environment. Similar to C(docker config create) and C(docker config rm). - Create and remove Docker configs in a Swarm environment. Similar to C(docker config create) and C(docker config rm).
- Adds to the metadata of new configs 'ansible_key', an encrypted hash representation of the data, which is then used - Adds to the metadata of new configs 'ansible_key', an encrypted hash representation of the data, which is then used
in future runs to test if a config has changed. If 'ansible_key' is not present, then a config will not be updated in future runs to test if a config has changed. If 'ansible_key' is not present, then a config will not be updated
unless the C(force) option is set. unless the I(force) option is set.
- Updates to configs are performed by removing the config and creating it again. - Updates to configs are performed by removing the config and creating it again.
options: options:
data: data:
@ -35,7 +35,7 @@ options:
description: description:
- If set to C(true), the data is assumed to be Base64 encoded and will be - If set to C(true), the data is assumed to be Base64 encoded and will be
decoded before being used. decoded before being used.
- To use binary C(data), it is better to keep it Base64 encoded and let it - To use binary I(data), it is better to keep it Base64 encoded and let it
be decoded by this option. be decoded by this option.
type: bool type: bool
default: no default: no
@ -47,7 +47,7 @@ options:
force: force:
description: description:
- Use with state C(present) to always remove and recreate an existing config. - Use with state C(present) to always remove and recreate an existing config.
- If I(true), an existing config will be replaced, even if it has not been changed. - If C(true), an existing config will be replaced, even if it has not been changed.
type: bool type: bool
default: no default: no
name: name:
@ -145,7 +145,7 @@ RETURN = '''
config_id: config_id:
description: description:
- The ID assigned by Docker to the config object. - The ID assigned by Docker to the config object.
returned: success and C(state == "present") returned: success and I(state) is C(present)
type: str type: str
sample: 'hzehrmyjigmcp2gb6nlhmjqcv' sample: 'hzehrmyjigmcp2gb6nlhmjqcv'
''' '''

255
lib/ansible/modules/cloud/docker/docker_container.py
Unescape Escape View File

@ -38,7 +38,7 @@ notes:
options: options:
auto_remove: auto_remove:
description: description:
- enable auto-removal of the container on daemon side when the container's process exits - Enable auto-removal of the container on daemon side when the container's process exits.
type: bool type: bool
default: no default: no
version_added: "2.4" version_added: "2.4"
@ -65,16 +65,16 @@ options:
version_added: "2.2" version_added: "2.2"
command: command:
description: description:
- Command to execute when the container starts. - Command to execute when the container starts. A command may be either a string or a list.
A command may be either a string or a list.
- Prior to version 2.4, strings were split on commas. - Prior to version 2.4, strings were split on commas.
type: raw type: raw
comparisons: comparisons:
description: description:
- Allows to specify how properties of existing containers are compared with - Allows to specify how properties of existing containers are compared with
module options to decide whether the container should be recreated / updated module options to decide whether the container should be recreated / updated
or not. Only options which correspond to the state of a container as handled or not.
by the Docker daemon can be specified, as well as C(networks). - Only options which correspond to the state of a container as handled by the
Docker daemon can be specified, as well as C(networks).
- Must be a dictionary specifying for an option one of the keys C(strict), C(ignore) - Must be a dictionary specifying for an option one of the keys C(strict), C(ignore)
and C(allow_more_present). and C(allow_more_present).
- If C(strict) is specified, values are tested for equality, and changes always - If C(strict) is specified, values are tested for equality, and changes always
@ -86,17 +86,17 @@ options:
or restarted if the module option contains a key which isn't present in the or restarted if the module option contains a key which isn't present in the
container's option, or if the value of a key present differs. container's option, or if the value of a key present differs.
- The wildcard option C(*) can be used to set one of the default values C(strict) - The wildcard option C(*) can be used to set one of the default values C(strict)
or C(ignore) to I(all) comparisons. or C(ignore) to *all* comparisons which are not explicitly set to other values.
- See the examples for details. - See the examples for details.
type: dict type: dict
version_added: "2.8" version_added: "2.8"
cpu_period: cpu_period:
description: description:
- Limit CPU CFS (Completely Fair Scheduler) period - Limit CPU CFS (Completely Fair Scheduler) period.
type: int type: int
cpu_quota: cpu_quota:
description: description:
- Limit CPU CFS (Completely Fair Scheduler) quota - Limit CPU CFS (Completely Fair Scheduler) quota.
type: int type: int
cpuset_cpus: cpuset_cpus:
description: description:
@ -104,7 +104,7 @@ options:
type: str type: str
cpuset_mems: cpuset_mems:
description: description:
- Memory nodes (MEMs) in which to allow execution C(0-3) or C(0,1) - Memory nodes (MEMs) in which to allow execution C(0-3) or C(0,1).
type: str type: str
cpu_shares: cpu_shares:
description: description:
@ -113,13 +113,13 @@ options:
detach: detach:
description: description:
- Enable detached mode to leave the container running in background. - Enable detached mode to leave the container running in background.
If disabled, the task will reflect the status of the container run (failed if the command failed). - If disabled, the task will reflect the status of the container run (failed if the command failed).
type: bool type: bool
default: yes default: yes
devices: devices:
description: description:
- "List of host device bindings to add to the container. Each binding is a mapping expressed - List of host device bindings to add to the container.
in the format: <path_on_host>:<path_in_container>:<cgroup_permissions>" - "Each binding is a mapping expressed in the format C(<path_on_host>:<path_in_container>:<cgroup_permissions>)."
type: list type: list
elements: str elements: str
device_read_bps: device_read_bps:
@ -135,9 +135,9 @@ options:
required: yes required: yes
rate: rate:
description: description:
- "Device read limit. Format: <number>[<unit>]" - "Device read limit in format C(<number>[<unit>])."
- "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), - "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)" C(T) (tebibyte), or C(P) (pebibyte)."
- "Omitting the unit defaults to bytes." - "Omitting the unit defaults to bytes."
type: str type: str
required: yes required: yes
@ -155,9 +155,9 @@ options:
required: yes required: yes
rate: rate:
description: description:
- "Device read limit. Format: <number>[<unit>]" - "Device read limit in format C(<number>[<unit>])."
- "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), - "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)" C(T) (tebibyte), or C(P) (pebibyte)."
- "Omitting the unit defaults to bytes." - "Omitting the unit defaults to bytes."
type: str type: str
required: yes required: yes
@ -200,7 +200,7 @@ options:
version_added: "2.8" version_added: "2.8"
dns_opts: dns_opts:
description: description:
- list of DNS options - List of DNS options.
type: list type: list
elements: str elements: str
dns_servers: dns_servers:
@ -226,24 +226,24 @@ options:
env_file: env_file:
description: description:
- Path to a file, present on the target, containing environment variables I(FOO=BAR). - Path to a file, present on the target, containing environment variables I(FOO=BAR).
- If variable also present in C(env), then C(env) value will override. - If variable also present in I(env), then the I(env) value will override.
type: path type: path
version_added: "2.2" version_added: "2.2"
entrypoint: entrypoint:
description: description:
- Command that overwrites the default ENTRYPOINT of the image. - Command that overwrites the default C(ENTRYPOINT) of the image.
type: list type: list
elements: str elements: str
etc_hosts: etc_hosts:
description: description:
- Dict of host-to-IP mappings, where each host name is a key in the dictionary. - Dict of host-to-IP mappings, where each host name is a key in the dictionary.
Each host name will be added to the container's /etc/hosts file. Each host name will be added to the container's C(/etc/hosts) file.
type: dict type: dict
exposed_ports: exposed_ports:
description: description:
- List of additional container ports which informs Docker that the container - List of additional container ports which informs Docker that the container
listens on the specified network ports at runtime. listens on the specified network ports at runtime.
If the port is already exposed using EXPOSE in a Dockerfile, it does not - If the port is already exposed using C(EXPOSE) in a Dockerfile, it does not
need to be exposed again. need to be exposed again.
type: list type: list
elements: str elements: str
@ -264,11 +264,11 @@ options:
elements: str elements: str
healthcheck: healthcheck:
description: description:
- 'Configure a check that is run to determine whether or not containers for this service are "healthy". - Configure a check that is run to determine whether or not containers for this service are "healthy".
See the docs for the L(HEALTHCHECK Dockerfile instruction,https://docs.docker.com/engine/reference/builder/#healthcheck) - "See the docs for the L(HEALTHCHECK Dockerfile instruction,https://docs.docker.com/engine/reference/builder/#healthcheck)
for details on how healthchecks work.' for details on how healthchecks work."
- 'I(interval), I(timeout) and I(start_period) are specified as durations. They accept duration as a string in a format - "I(interval), I(timeout) and I(start_period) are specified as durations. They accept duration as a string in a format
that look like: C(5h34m56s), C(1m30s) etc. The supported units are C(us), C(ms), C(s), C(m) and C(h)' that look like: C(5h34m56s), C(1m30s) etc. The supported units are C(us), C(ms), C(s), C(m) and C(h)."
type: dict type: dict
suboptions: suboptions:
test: test:
@ -278,32 +278,37 @@ options:
type: raw type: raw
interval: interval:
description: description:
- 'Time between running the check. (default: 30s)' - Time between running the check.
- The default used by the Docker daemon is C(30s).
type: str type: str
timeout: timeout:
description: description:
- 'Maximum time to allow one check to run. (default: 30s)' - Maximum time to allow one check to run.
- The default used by the Docker daemon is C(30s).
type: str type: str
retries: retries:
description: description:
- 'Consecutive failures needed to report unhealthy. It accept integer value. (default: 3)' - Consecutive number of failures needed to report unhealthy.
- The default used by the Docker daemon is C(3).
type: int type: int
start_period: start_period:
description: description:
- 'Start period for the container to initialize before starting health-retries countdown. (default: 0s)' - Start period for the container to initialize before starting health-retries countdown.
- The default used by the Docker daemon is C(0s).
type: str type: str
version_added: "2.8" version_added: "2.8"
hostname: hostname:
description: description:
- Container hostname. - The container's hostname.
type: str type: str
ignore_image: ignore_image:
description: description:
- When C(state) is I(present) or I(started) the module compares the configuration of an existing - When I(state) is C(present) or C(started), the module compares the configuration of an existing
container to requested configuration. The evaluation includes the image version. If container to requested configuration. The evaluation includes the image version. If the image
the image version in the registry does not match the container, the container will be version in the registry does not match the container, the container will be recreated. You can
recreated. Stop this behavior by setting C(ignore_image) to I(True). stop this behavior by setting I(ignore_image) to C(True).
- I(Warning:) This option is ignored if C(image) or C(*) is used for the C(comparisons) option. - "*Warning:* This option is ignored if C(image: ignore) or C(*: ignore) is specified in the
I(comparisons) option."
type: bool type: bool
default: no default: no
version_added: "2.2" version_added: "2.2"
@ -312,12 +317,12 @@ options:
- Repository path and tag used to create the container. If an image is not found or pull is true, the image - Repository path and tag used to create the container. If an image is not found or pull is true, the image
will be pulled from the registry. If no tag is included, C(latest) will be used. will be pulled from the registry. If no tag is included, C(latest) will be used.
- Can also be an image ID. If this is the case, the image is assumed to be available locally. - Can also be an image ID. If this is the case, the image is assumed to be available locally.
The C(pull) option is ignored for this case. The I(pull) option is ignored for this case.
type: str type: str
init: init:
description: description:
- Run an init inside the container that forwards signals and reaps processes. - Run an init inside the container that forwards signals and reaps processes.
This option requires Docker API >= 1.25. - This option requires Docker API >= 1.25.
type: bool type: bool
default: no default: no
version_added: "2.6" version_added: "2.6"
@ -328,8 +333,9 @@ options:
default: no default: no
ipc_mode: ipc_mode:
description: description:
- Set the IPC mode for the container. Can be one of 'container:<name|id>' to reuse another - Set the IPC mode for the container.
container's IPC namespace or 'host' to use the host's IPC namespace within the container. - Can be one of C(container:<name|id>) to reuse another container's IPC namespace or C(host) to use
the host's IPC namespace within the container.
type: str type: str
keep_volumes: keep_volumes:
description: description:
@ -342,7 +348,7 @@ options:
type: str type: str
kernel_memory: kernel_memory:
description: description:
- "Kernel memory limit (format: C(<number>[<unit>])). Number is a positive integer. - "Kernel memory limit in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte). Minimum is C(4M)." C(T) (tebibyte), or C(P) (pebibyte). Minimum is C(4M)."
- Omitting the unit defaults to bytes. - Omitting the unit defaults to bytes.
@ -359,23 +365,23 @@ options:
elements: str elements: str
log_driver: log_driver:
description: description:
- Specify the logging driver. Docker uses I(json-file) by default. - Specify the logging driver. Docker uses C(json-file) by default.
- See L(here,https://docs.docker.com/config/containers/logging/configure/) for possible choices. - See L(here,https://docs.docker.com/config/containers/logging/configure/) for possible choices.
type: str type: str
log_options: log_options:
description: description:
- Dictionary of options specific to the chosen log_driver. See https://docs.docker.com/engine/admin/logging/overview/ - Dictionary of options specific to the chosen I(log_driver).
for details. - See U(https://docs.docker.com/engine/admin/logging/overview/) for details.
type: dict type: dict
aliases: aliases:
- log_opt - log_opt
mac_address: mac_address:
description: description:
- Container MAC address (e.g. 92:d0:c6:0a:29:33) - Container MAC address (e.g. 92:d0:c6:0a:29:33).
type: str type: str
memory: memory:
description: description:
- "Memory limit (format: C(<number>[<unit>])). Number is a positive integer. - "Memory limit in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- Omitting the unit defaults to bytes. - Omitting the unit defaults to bytes.
@ -383,14 +389,14 @@ options:
default: '0' default: '0'
memory_reservation: memory_reservation:
description: description:
- "Memory soft limit (format: C(<number>[<unit>])). Number is a positive integer. - "Memory soft limit in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- Omitting the unit defaults to bytes. - Omitting the unit defaults to bytes.
type: str type: str
memory_swap: memory_swap:
description: description:
- "Total memory limit (memory + swap, format: C(<number>[<unit>])). - "Total memory limit (memory + swap) in format C(<number>[<unit>]).
Number is a positive integer. Unit can be C(B) (byte), C(K) (kibibyte, 1024B), Number is a positive integer. Unit can be C(B) (byte), C(K) (kibibyte, 1024B),
C(M) (mebibyte), C(G) (gibibyte), C(T) (tebibyte), or C(P) (pebibyte)." C(M) (mebibyte), C(G) (gibibyte), C(T) (tebibyte), or C(P) (pebibyte)."
- Omitting the unit defaults to bytes. - Omitting the unit defaults to bytes.
@ -398,14 +404,15 @@ options:
memory_swappiness: memory_swappiness:
description: description:
- Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. - Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100.
- If not set, the value will be remain the same if container exists and will be inherited from the host machine if it is (re-)created. - If not set, the value will be remain the same if container exists and will be inherited
from the host machine if it is (re-)created.
type: int type: int
mounts: mounts:
version_added: "2.9" version_added: "2.9"
type: list type: list
elements: dict elements: dict
description: description:
- 'Specification for mounts to be added to the container. More powerful alternative to I(volumes).' - Specification for mounts to be added to the container. More powerful alternative to I(volumes).
suboptions: suboptions:
target: target:
description: description:
@ -422,35 +429,35 @@ options:
- Note that C(npipe) is only supported by Docker for Windows. - Note that C(npipe) is only supported by Docker for Windows.
type: str type: str
choices: choices:
- 'bind' - bind
- 'volume' - npipe
- 'tmpfs' - tmpfs
- 'npipe' - volume
default: volume default: volume
read_only: read_only:
description: description:
- 'Whether the mount should be read-only.' - Whether the mount should be read-only.
type: bool type: bool
consistency: consistency:
description: description:
- 'The consistency requirement for the mount.' - The consistency requirement for the mount.
type: str type: str
choices: choices:
- 'default' - cached
- 'consistent' - consistent
- 'cached' - default
- 'delegated' - delegated
propagation: propagation:
description: description:
- Propagation mode. Only valid for the C(bind) type. - Propagation mode. Only valid for the C(bind) type.
type: str type: str
choices: choices:
- 'private' - private
- 'rprivate' - rprivate
- 'shared' - shared
- 'rshared' - rshared
- 'slave' - slave
- 'rslave' - rslave
no_copy: no_copy:
description: description:
- False if the volume should be populated with the data from the target. Only valid for the C(volume) type. - False if the volume should be populated with the data from the target. Only valid for the C(volume) type.
@ -467,14 +474,14 @@ options:
type: str type: str
volume_options: volume_options:
description: description:
- Dictionary of options specific to the chosen volume_driver. See L(here,https://docs.docker.com/storage/volumes/#use-a-volume-driver) - Dictionary of options specific to the chosen volume_driver. See
for details. L(here,https://docs.docker.com/storage/volumes/#use-a-volume-driver) for details.
type: dict type: dict
tmpfs_size: tmpfs_size:
description: description:
- "The size for the tmpfs mount in bytes. Format: <number>[<unit>]" - "The size for the tmpfs mount in bytes in format <number>[<unit>]."
- "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), - "Number is a positive integer. Unit can be one of C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)" C(T) (tebibyte), or C(P) (pebibyte)."
- "Omitting the unit defaults to bytes." - "Omitting the unit defaults to bytes."
type: str type: str
tmpfs_mode: tmpfs_mode:
@ -489,21 +496,22 @@ options:
required: yes required: yes
network_mode: network_mode:
description: description:
- Connect the container to a network. Choices are "bridge", "host", "none" or "container:<name|id>" - Connect the container to a network. Choices are C(bridge), C(host), C(none) or C(container:<name|id>).
type: str type: str
userns_mode: userns_mode:
description: description:
- Set the user namespace mode for the container. Currently, the only valid value is C(host). - Set the user namespace mode for the container. Currently, the only valid value are C(host) and the empty string.
type: str type: str
version_added: "2.5" version_added: "2.5"
networks: networks:
description: description:
- List of networks the container belongs to. - List of networks the container belongs to.
- For examples of the data structure and usage see EXAMPLES below. - For examples of the data structure and usage see EXAMPLES below.
- To remove a container from one or more networks, use the C(purge_networks) option. - To remove a container from one or more networks, use the I(purge_networks) option.
- Note that as opposed to C(docker run ...), M(docker_container) does not remove the default - Note that as opposed to C(docker run ...), M(docker_container) does not remove the default
network if C(networks) is specified. You need to explicitly use C(purge_networks) to enforce network if I(networks) is specified. You need to explicitly use I(purge_networks) to enforce
the removal of the default network (and all other networks not explicitly mentioned in C(networks)). the removal of the default network (and all other networks not explicitly mentioned in I(networks)).
Alternatively, use the I(networks_cli_compatible) option, which will be enabled by default from Ansible 2.12 on.
type: list type: list
elements: dict elements: dict
suboptions: suboptions:
@ -537,15 +545,15 @@ options:
- "When networks are provided to the module via the I(networks) option, the module - "When networks are provided to the module via the I(networks) option, the module
behaves differently than C(docker run --network): C(docker run --network other) behaves differently than C(docker run --network): C(docker run --network other)
will create a container with network C(other) attached, but the default network will create a container with network C(other) attached, but the default network
not attached. This module with C(networks: {name: other}) will create a container not attached. This module with I(networks: {name: other}) will create a container
with both C(default) and C(other) attached. If I(purge_networks) is set to C(yes), with both C(default) and C(other) attached. If I(purge_networks) is set to C(yes),
the C(default) network will be removed afterwards." the C(default) network will be removed afterwards."
- "If I(networks_cli_compatible) is set to C(yes), this module will behave as - "If I(networks_cli_compatible) is set to C(yes), this module will behave as
C(docker run --network) and will I(not) add the default network if C(networks) is C(docker run --network) and will *not* add the default network if I(networks) is
specified. If C(networks) is not specified, the default network will be attached." specified. If I(networks) is not specified, the default network will be attached."
- "Note that docker CLI also sets C(network_mode) to the name of the first network - "Note that docker CLI also sets I(network_mode) to the name of the first network
added if C(--network) is specified. For more compatibility with docker CLI, you added if C(--network) is specified. For more compatibility with docker CLI, you
explicitly have to set C(network_mode) to the name of the first network you're explicitly have to set I(network_mode) to the name of the first network you're
adding." adding."
- Current value is C(no). A new default of C(yes) will be set in Ansible 2.12. - Current value is C(no). A new default of C(yes) will be set in Ansible 2.12.
type: bool type: bool
@ -562,8 +570,8 @@ options:
version_added: "2.2" version_added: "2.2"
output_logs: output_logs:
description: description:
- If set to true, output of the container command will be printed (only effective - If set to true, output of the container command will be printed.
when log_driver is set to json-file or journald. - Only effective when I(log_driver) is set to C(json-file) or C(journald).
type: bool type: bool
default: no default: no
version_added: "2.7" version_added: "2.7"
@ -575,13 +583,13 @@ options:
pid_mode: pid_mode:
description: description:
- Set the PID namespace mode for the container. - Set the PID namespace mode for the container.
- Note that Docker SDK for Python < 2.0 only supports 'host'. Newer versions of the - Note that Docker SDK for Python < 2.0 only supports C(host). Newer versions of the
Docker SDK for Python (docker) allow all values supported by the docker daemon. Docker SDK for Python (docker) allow all values supported by the Docker daemon.
type: str type: str
pids_limit: pids_limit:
description: description:
- Set PIDs limit for the container. It accepts an integer value. - Set PIDs limit for the container. It accepts an integer value.
- Set -1 for unlimited PIDs. - Set C(-1) for unlimited PIDs.
type: int type: int
version_added: "2.8" version_added: "2.8"
privileged: privileged:
@ -596,17 +604,17 @@ options:
container port, 9000 is a host port, and 0.0.0.0 is a host interface." container port, 9000 is a host port, and 0.0.0.0 is a host interface."
- Port ranges can be used for source and destination ports. If two ranges with - Port ranges can be used for source and destination ports. If two ranges with
different lengths are specified, the shorter range will be used. different lengths are specified, the shorter range will be used.
- "Bind addresses must be either IPv4 or IPv6 addresses. Hostnames are I(not) allowed. This - "Bind addresses must be either IPv4 or IPv6 addresses. Hostnames are *not* allowed. This
is different from the C(docker) command line utility. Use the L(dig lookup,../lookup/dig.html) is different from the C(docker) command line utility. Use the L(dig lookup,../lookup/dig.html)
to resolve hostnames." to resolve hostnames."
- A value of C(all) will publish all exposed container ports to random host ports, ignoring - A value of C(all) will publish all exposed container ports to random host ports, ignoring
any other mappings. any other mappings.
- If C(networks) parameter is provided, will inspect each network to see if there exists - If I(networks) parameter is provided, will inspect each network to see if there exists
a bridge network with optional parameter com.docker.network.bridge.host_binding_ipv4. a bridge network with optional parameter C(com.docker.network.bridge.host_binding_ipv4).
If such a network is found, then published ports where no host IP address is specified If such a network is found, then published ports where no host IP address is specified
will be bound to the host IP pointed to by com.docker.network.bridge.host_binding_ipv4. will be bound to the host IP pointed to by C(com.docker.network.bridge.host_binding_ipv4).
Note that the first bridge network with a com.docker.network.bridge.host_binding_ipv4 Note that the first bridge network with a C(com.docker.network.bridge.host_binding_ipv4)
value encountered in the list of C(networks) is the one that will be used. value encountered in the list of I(networks) is the one that will be used.
type: list type: list
elements: str elements: str
aliases: aliases:
@ -615,14 +623,14 @@ options:
description: description:
- If true, always pull the latest version of an image. Otherwise, will only pull an image - If true, always pull the latest version of an image. Otherwise, will only pull an image
when missing. when missing.
- I(Note) that images are only pulled when specified by name. If the image is specified - "*Note:* images are only pulled when specified by name. If the image is specified
as a image ID (hash), it cannot be pulled. as a image ID (hash), it cannot be pulled."
type: bool type: bool
default: no default: no
purge_networks: purge_networks:
description: description:
- Remove the container from ALL networks not included in C(networks) parameter. - Remove the container from ALL networks not included in I(networks) parameter.
- Any default networks such as I(bridge), if not found in C(networks), will be removed as well. - Any default networks such as C(bridge), if not found in I(networks), will be removed as well.
type: bool type: bool
default: no default: no
version_added: "2.2" version_added: "2.2"
@ -643,7 +651,8 @@ options:
default: no default: no
restart_policy: restart_policy:
description: description:
- Container restart policy. Place quotes around I(no) option. - Container restart policy.
- Place quotes around C(no) option.
type: str type: str
choices: choices:
- 'no' - 'no'
@ -661,37 +670,34 @@ options:
version_added: "2.8" version_added: "2.8"
shm_size: shm_size:
description: description:
- "Size of C(/dev/shm) (format: C(<number>[<unit>])). Number is positive integer. - "Size of C(/dev/shm) in format C(<number>[<unit>]). Number is positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- Omitting the unit defaults to bytes. If you omit the size entirely, the system uses C(64M). - Omitting the unit defaults to bytes. If you omit the size entirely, Docker daemon uses C(64M).
type: str type: str
security_opts: security_opts:
description: description:
- List of security options in the form of C("label:user:User") - List of security options in the form of C("label:user:User").
type: list type: list
elements: str elements: str
state: state:
description: description:
- 'I(absent) - A container matching the specified name will be stopped and removed. Use force_kill to kill the container - 'C(absent) - A container matching the specified name will be stopped and removed. Use I(force_kill) to kill the container
rather than stopping it. Use keep_volumes to retain volumes associated with the removed container.' rather than stopping it. Use I(keep_volumes) to retain volumes associated with the removed container.'
- 'I(present) - Asserts the existence of a container matching the name and any provided configuration parameters. If no - 'C(present) - Asserts the existence of a container matching the name and any provided configuration parameters. If no
container matches the name, a container will be created. If a container matches the name but the provided configuration container matches the name, a container will be created. If a container matches the name but the provided configuration
does not match, the container will be updated, if it can be. If it cannot be updated, it will be removed and re-created does not match, the container will be updated, if it can be. If it cannot be updated, it will be removed and re-created
with the requested config. Image version will be taken into account when comparing configuration. To ignore image with the requested config.'
version use the ignore_image option. Use the recreate option to force the re-creation of the matching container. Use - 'C(started) - Asserts that the container is first C(present), and then if the container is not running moves it to a running
force_kill to kill the container rather than stopping it. Use keep_volumes to retain volumes associated with a removed state. Use I(restart) to force a matching container to be stopped and restarted.'
container.' - 'C(stopped) - Asserts that the container is first C(present), and then if the container is running moves it to a stopped
- 'I(started) - Asserts there is a running container matching the name and any provided configuration. If no container state.'
matches the name, a container will be created and started. If a container matching the name is found but the - To control what will be taken into account when comparing configuration, see the I(comparisons) option. To avoid that the
configuration does not match, the container will be updated, if it can be. If it cannot be updated, it will be removed image version will be taken into account, you can also use the I(ignore_image) option.
and a new container will be created with the requested configuration and started. Image version will be taken into - Use the I(recreate) option to always force re-creation of a matching container, even if it is running.
account when comparing configuration. To ignore image version use the ignore_image option. Use recreate to always - If the container should be killed instead of stopped in case it needs to be stopped for recreation, or because I(state) is
re-create a matching container, even if it is running. Use restart to force a matching container to be stopped and C(stopped), please use the I(force_kill) option. Use I(keep_volumes) to retain volumes associated with a removed container.
restarted. Use force_kill to kill a container rather than stopping it. Use keep_volumes to retain volumes associated - Use I(keep_volumes) to retain volumes associated with a removed container.
with a removed container.'
- 'I(stopped) - Asserts that the container is first I(present), and then if the container is running moves it to a stopped
state. Use force_kill to kill a container rather than stopping it.'
type: str type: str
default: started default: started
choices: choices:
@ -705,7 +711,7 @@ options:
type: str type: str
stop_timeout: stop_timeout:
description: description:
- Number of seconds to wait for the container to stop before sending SIGKILL. - Number of seconds to wait for the container to stop before sending C(SIGKILL).
When the container is created by this module, its C(StopTimeout) configuration When the container is created by this module, its C(StopTimeout) configuration
will be set to this value. will be set to this value.
- When the container is stopped, will be used as a timeout for stopping the - When the container is stopped, will be used as a timeout for stopping the
@ -721,7 +727,7 @@ options:
default: no default: no
tmpfs: tmpfs:
description: description:
- Mount a tmpfs directory - Mount a tmpfs directory.
type: list type: list
elements: str elements: str
version_added: 2.4 version_added: 2.4
@ -732,7 +738,7 @@ options:
default: no default: no
ulimits: ulimits:
description: description:
- "List of ulimit options. A ulimit is specified as C(nofile:262144:262144)" - "List of ulimit options. A ulimit is specified as C(nofile:262144:262144)."
type: list type: list
elements: str elements: str
sysctls: sysctls:
@ -743,7 +749,7 @@ options:
user: user:
description: description:
- Sets the username or UID used and optionally the groupname or GID for the specified command. - Sets the username or UID used and optionally the groupname or GID for the specified command.
- "Can be [ user | user:group | uid | uid:gid | user:gid | uid:group ]" - "Can be of the forms C(user), C(user:group), C(uid), C(uid:gid), C(user:gid) or C(uid:group)."
type: str type: str
uts: uts:
description: description:
@ -756,8 +762,7 @@ options:
- "Mount modes can be a comma-separated list of various modes such as C(ro), C(rw), C(consistent), - "Mount modes can be a comma-separated list of various modes such as C(ro), C(rw), C(consistent),
C(delegated), C(cached), C(rprivate), C(private), C(rshared), C(shared), C(rslave), C(slave), and C(delegated), C(cached), C(rprivate), C(private), C(rshared), C(shared), C(rslave), C(slave), and
C(nocopy). Note that the docker daemon might not support all modes and combinations of such modes." C(nocopy). Note that the docker daemon might not support all modes and combinations of such modes."
- SELinux hosts can additionally use C(z) or C(Z) to use a shared or - SELinux hosts can additionally use C(z) or C(Z) to use a shared or private label for the volume.
private label for the volume.
- "Note that Ansible 2.7 and earlier only supported one mode, which had to be one of C(ro), C(rw), - "Note that Ansible 2.7 and earlier only supported one mode, which had to be one of C(ro), C(rw),
C(z), and C(Z)." C(z), and C(Z)."
type: list type: list
@ -768,7 +773,7 @@ options:
type: str type: str
volumes_from: volumes_from:
description: description:
- List of container names or Ids to get volumes from. - List of container names or IDs to get volumes from.
type: list type: list
elements: str elements: str
working_dir: working_dir:
@ -1016,8 +1021,8 @@ container:
are also accessible directly as C(docker_container). Note that the returned fact will be removed in Ansible 2.12. are also accessible directly as C(docker_container). Note that the returned fact will be removed in Ansible 2.12.
- Before 2.3 this was C(ansible_docker_container) but was renamed in 2.3 to C(docker_container) due to - Before 2.3 this was C(ansible_docker_container) but was renamed in 2.3 to C(docker_container) due to
conflicts with the connection plugin. conflicts with the connection plugin.
- Empty if C(state) is I(absent) - Empty if I(state) is C(absent)
- If detached is I(False), will include Output attribute containing any output from container run. - If I(detached) is C(false), will include C(Output) attribute containing any output from container run.
returned: always returned: always
type: dict type: dict
sample: '{ sample: '{

2
lib/ansible/modules/cloud/docker/docker_container_info.py
Unescape Escape View File

@ -70,7 +70,7 @@ exists:
container: container:
description: description:
- Facts representing the current state of the container. Matches the docker inspection output. - Facts representing the current state of the container. Matches the docker inspection output.
- Will be C(None) if container does not exist. - Will be C(none) if container does not exist.
returned: always returned: always
type: dict type: dict
sample: '{ sample: '{

18
lib/ansible/modules/cloud/docker/docker_image.py
Unescape Escape View File

@ -23,14 +23,14 @@ version_added: "1.5"
description: description:
- Build, load or pull an image, making the image available for creating containers. Also supports tagging an - Build, load or pull an image, making the image available for creating containers. Also supports tagging an
image into a repository and archiving an image to a .tar file. image into a repository and archiving an image to a .tar file.
- Since Ansible 2.8, it is recommended to explicitly specify the image's source (C(source=build), - Since Ansible 2.8, it is recommended to explicitly specify the image's source (I(source) can be C(build),
C(source=load), C(source=pull) or C(source=local)). This will be required from Ansible 2.12 on. C(load), C(pull) or C(local)). This will be required from Ansible 2.12 on.
options: options:
source: source:
description: description:
- "Determines where the module will try to retrieve the image from." - "Determines where the module will try to retrieve the image from."
- "Use C(build) to build the image from a C(Dockerfile). I(path) must - "Use C(build) to build the image from a C(Dockerfile). I(build.path) must
be specified when this value is used." be specified when this value is used."
- "Use C(load) to load the image from a C(.tar) file. I(load_path) must - "Use C(load) to load the image from a C(.tar) file. I(load_path) must
be specified when this value is used." be specified when this value is used."
@ -127,7 +127,7 @@ options:
type: str type: str
use_config_proxy: use_config_proxy:
description: description:
- If set to `yes` and a proxy configuration is specified in the docker client configuration - If set to C(yes) and a proxy configuration is specified in the docker client configuration
(by default C($HOME/.docker/config.json)), the corresponding environment variables will (by default C($HOME/.docker/config.json)), the corresponding environment variables will
be set in the container being built. be set in the container being built.
- Needs Docker SDK for Python >= 3.7.0. - Needs Docker SDK for Python >= 3.7.0.
@ -258,7 +258,7 @@ options:
the image, provide a I(path) value set to a directory containing a context and Dockerfile, and set I(source) the image, provide a I(path) value set to a directory containing a context and Dockerfile, and set I(source)
to C(build). To load an image, specify I(load_path) to provide a path to an archive file. To tag an image to to C(build). To load an image, specify I(load_path) to provide a path to an archive file. To tag an image to
a repository, provide a I(repository) path. If the name contains a repository path, it will be pushed. a repository, provide a I(repository) path. If the name contains a repository path, it will be pushed.
- "NOTE: C(state=build) is DEPRECATED and will be removed in release 2.11. Specifying C(build) will behave the - "*Note:* C(state=build) is DEPRECATED and will be removed in Ansible 2.11. Specifying C(build) will behave the
same as C(present)." same as C(present)."
type: str type: str
default: present default: present
@ -270,7 +270,7 @@ options:
description: description:
- Used to select an image when pulling. Will be added to the image when pushing, tagging or building. Defaults to - Used to select an image when pulling. Will be added to the image when pushing, tagging or building. Defaults to
I(latest). I(latest).
- If C(name) parameter format is I(name:tag), then tag value from C(name) will take precedence. - If I(name) parameter format is I(name:tag), then tag value from I(name) will take precedence.
type: str type: str
default: latest default: latest
buildargs: buildargs:
@ -309,8 +309,8 @@ options:
- "DEPRECATED. Whether to use tls to connect to the docker daemon. Set to - "DEPRECATED. Whether to use tls to connect to the docker daemon. Set to
C(encrypt) to use TLS. And set to C(verify) to use TLS and verify that C(encrypt) to use TLS. And set to C(verify) to use TLS and verify that
the server's certificate is valid for the server." the server's certificate is valid for the server."
- "NOTE: If you specify this option, it will set the value of the I(tls) or - "*Note:* If you specify this option, it will set the value of the I(tls) or
I(tls_verify) parameters if not set to I(no)." I(validate_certs) parameters if not set to C(no)."
- Will be removed in Ansible 2.11. - Will be removed in Ansible 2.11.
type: str type: str
choices: choices:
@ -900,7 +900,7 @@ def main():
if client.module.params['use_tls']: if client.module.params['use_tls']:
client.module.warn('The "use_tls" option has been deprecated for a long time ' client.module.warn('The "use_tls" option has been deprecated for a long time '
'and will be removed in Ansible 2.11. Please use the' 'and will be removed in Ansible 2.11. Please use the'
'"tls" and "tls_verify" options instead.') '"tls" and "validate_certs" options instead.')
if not is_valid_tag(client.module.params['tag'], allow_empty=True): if not is_valid_tag(client.module.params['tag'], allow_empty=True):
client.fail('"{0}" is not a valid docker tag!'.format(client.module.params['tag'])) client.fail('"{0}" is not a valid docker tag!'.format(client.module.params['tag']))

22
lib/ansible/modules/cloud/docker/docker_network.py
Unescape Escape View File

@ -49,19 +49,19 @@ options:
force: force:
description: description:
- With state I(absent) forces disconnecting all containers from the - With state C(absent) forces disconnecting all containers from the
network prior to deleting the network. With state I(present) will network prior to deleting the network. With state C(present) will
disconnect all containers, delete the network and re-create the disconnect all containers, delete the network and re-create the
network. This option is required if you have changed the IPAM or network.
driver options and want an existing network to be updated to use the - This option is required if you have changed the IPAM or driver options
new options. and want an existing network to be updated to use the new options.
type: bool type: bool
default: no default: no
appends: appends:
description: description:
- By default the connected list is canonical, meaning containers not on the list are removed from the network. - By default the connected list is canonical, meaning containers not on the list are removed from the network.
Use C(appends) to leave existing containers connected. - Use I(appends) to leave existing containers connected.
type: bool type: bool
default: no default: no
aliases: aliases:
@ -87,7 +87,7 @@ options:
ipam_options: ipam_options:
description: description:
- Dictionary of IPAM options. - Dictionary of IPAM options.
- Deprecated in 2.8, will be removed in 2.12. Use parameter C(ipam_config) instead. In Docker 1.10.0, IPAM - Deprecated in 2.8, will be removed in 2.12. Use parameter I(ipam_config) instead. In Docker 1.10.0, IPAM
options were introduced (see L(here,https://github.com/moby/moby/pull/17316)). This module parameter addresses options were introduced (see L(here,https://github.com/moby/moby/pull/17316)). This module parameter addresses
the IPAM config not the newly introduced IPAM options. For the IPAM options, see the I(ipam_driver_options) the IPAM config not the newly introduced IPAM options. For the IPAM options, see the I(ipam_driver_options)
parameter. parameter.
@ -138,14 +138,14 @@ options:
state: state:
description: description:
- I(absent) deletes the network. If a network has connected containers, it - C(absent) deletes the network. If a network has connected containers, it
cannot be deleted. Use the C(force) option to disconnect all containers cannot be deleted. Use the I(force) option to disconnect all containers
and delete the network. and delete the network.
- I(present) creates the network, if it does not already exist with the - C(present) creates the network, if it does not already exist with the
specified parameters, and connects the list of containers provided via specified parameters, and connects the list of containers provided via
the connected parameter. Containers not on the list will be disconnected. the connected parameter. Containers not on the list will be disconnected.
An empty list will leave no containers connected to the network. Use the An empty list will leave no containers connected to the network. Use the
C(appends) option to leave existing containers connected. Use the C(force) I(appends) option to leave existing containers connected. Use the I(force)
options to force re-creation of the network. options to force re-creation of the network.
type: str type: str
default: present default: present

2
lib/ansible/modules/cloud/docker/docker_network_info.py
Unescape Escape View File

@ -70,7 +70,7 @@ exists:
network: network:
description: description:
- Facts representing the current state of the network. Matches the docker inspection output. - Facts representing the current state of the network. Matches the docker inspection output.
- Will be C(None) if network does not exist. - Will be C(none) if network does not exist.
returned: always returned: always
type: dict type: dict
sample: '{ sample: '{

16
lib/ansible/modules/cloud/docker/docker_prune.py
Unescape Escape View File

@ -122,13 +122,13 @@ RETURN = '''
containers: containers:
description: description:
- List of IDs of deleted containers. - List of IDs of deleted containers.
returned: C(containers) is C(true) returned: I(containers) is C(true)
type: list type: list
sample: '[]' sample: '[]'
containers_space_reclaimed: containers_space_reclaimed:
description: description:
- Amount of reclaimed disk space from container pruning in bytes. - Amount of reclaimed disk space from container pruning in bytes.
returned: C(containers) is C(true) returned: I(containers) is C(true)
type: int type: int
sample: '0' sample: '0'
@ -136,13 +136,13 @@ containers_space_reclaimed:
images: images:
description: description:
- List of IDs of deleted images. - List of IDs of deleted images.
returned: C(images) is C(true) returned: I(images) is C(true)
type: list type: list
sample: '[]' sample: '[]'
images_space_reclaimed: images_space_reclaimed:
description: description:
- Amount of reclaimed disk space from image pruning in bytes. - Amount of reclaimed disk space from image pruning in bytes.
returned: C(images) is C(true) returned: I(images) is C(true)
type: int type: int
sample: '0' sample: '0'
@ -150,7 +150,7 @@ images_space_reclaimed:
networks: networks:
description: description:
- List of IDs of deleted networks. - List of IDs of deleted networks.
returned: C(networks) is C(true) returned: I(networks) is C(true)
type: list type: list
sample: '[]' sample: '[]'
@ -158,13 +158,13 @@ networks:
volumes: volumes:
description: description:
- List of IDs of deleted volumes. - List of IDs of deleted volumes.
returned: C(volumes) is C(true) returned: I(volumes) is C(true)
type: list type: list
sample: '[]' sample: '[]'
volumes_space_reclaimed: volumes_space_reclaimed:
description: description:
- Amount of reclaimed disk space from volumes pruning in bytes. - Amount of reclaimed disk space from volumes pruning in bytes.
returned: C(volumes) is C(true) returned: I(volumes) is C(true)
type: int type: int
sample: '0' sample: '0'
@ -172,7 +172,7 @@ volumes_space_reclaimed:
builder_cache_space_reclaimed: builder_cache_space_reclaimed:
description: description:
- Amount of reclaimed disk space from builder cache pruning in bytes. - Amount of reclaimed disk space from builder cache pruning in bytes.
returned: C(builder_cache) is C(true) returned: I(builder_cache) is C(true)
type: int type: int
sample: '0' sample: '0'
''' '''

10
lib/ansible/modules/cloud/docker/docker_secret.py
Unescape Escape View File

@ -24,7 +24,7 @@ description:
- Create and remove Docker secrets in a Swarm environment. Similar to C(docker secret create) and C(docker secret rm). - Create and remove Docker secrets in a Swarm environment. Similar to C(docker secret create) and C(docker secret rm).
- Adds to the metadata of new secrets 'ansible_key', an encrypted hash representation of the data, which is then used - Adds to the metadata of new secrets 'ansible_key', an encrypted hash representation of the data, which is then used
in future runs to test if a secret has changed. If 'ansible_key is not present, then a secret will not be updated in future runs to test if a secret has changed. If 'ansible_key is not present, then a secret will not be updated
unless the C(force) option is set. unless the I(force) option is set.
- Updates to secrets are performed by removing the secret and creating it again. - Updates to secrets are performed by removing the secret and creating it again.
options: options:
data: data:
@ -35,20 +35,20 @@ options:
description: description:
- If set to C(true), the data is assumed to be Base64 encoded and will be - If set to C(true), the data is assumed to be Base64 encoded and will be
decoded before being used. decoded before being used.
- To use binary C(data), it is better to keep it Base64 encoded and let it - To use binary I(data), it is better to keep it Base64 encoded and let it
be decoded by this option. be decoded by this option.
type: bool type: bool
default: no default: no
version_added: "2.8" version_added: "2.8"
labels: labels:
description: description:
- "A map of key:value meta data, where both the I(key) and I(value) are expected to be a string." - "A map of key:value meta data, where both key and value are expected to be strings."
- If new meta data is provided, or existing meta data is modified, the secret will be updated by removing it and creating it again. - If new meta data is provided, or existing meta data is modified, the secret will be updated by removing it and creating it again.
type: dict type: dict
force: force:
description: description:
- Use with state C(present) to always remove and recreate an existing secret. - Use with state C(present) to always remove and recreate an existing secret.
- If I(true), an existing secret will be replaced, even if it has not changed. - If C(true), an existing secret will be replaced, even if it has not changed.
type: bool type: bool
default: no default: no
name: name:
@ -145,7 +145,7 @@ RETURN = '''
secret_id: secret_id:
description: description:
- The ID assigned by Docker to the secret object. - The ID assigned by Docker to the secret object.
returned: success and C(state == "present") returned: success and I(state) is C(present)
type: str type: str
sample: 'hzehrmyjigmcp2gb6nlhmjqcv' sample: 'hzehrmyjigmcp2gb6nlhmjqcv'
''' '''

6
lib/ansible/modules/cloud/docker/docker_stack.py
Unescape Escape View File

@ -65,8 +65,8 @@ options:
choices: ["always", "changed", "never"] choices: ["always", "changed", "never"]
absent_retries: absent_retries:
description: description:
- If C(>0) and C(state==absent) the module will retry up to - If C(>0) and I(state) is C(absent) the module will retry up to
C(absent_retries) times to delete the stack until all the I(absent_retries) times to delete the stack until all the
resources have been effectively deleted. resources have been effectively deleted.
If the last try still reports the stack as not completely If the last try still reports the stack as not completely
removed the module will fail. removed the module will fail.
@ -74,7 +74,7 @@ options:
default: 0 default: 0
absent_retries_interval: absent_retries_interval:
description: description:
- Interval in seconds between C(absent_retries) - Interval in seconds between consecutive I(absent_retries).
type: int type: int
default: 1 default: 1

6
lib/ansible/modules/cloud/docker/docker_swarm.py
Unescape Escape View File

@ -27,7 +27,7 @@ options:
port number, like C(eth0:4567). port number, like C(eth0:4567).
- If the port number is omitted, - If the port number is omitted,
the port number from the listen address is used. the port number from the listen address is used.
- If C(advertise_addr) is not specified, it will be automatically - If I(advertise_addr) is not specified, it will be automatically
detected when possible. detected when possible.
- Only used when swarm is initialised or joined. Because of this it's not - Only used when swarm is initialised or joined. Because of this it's not
considered for idempotency checking. considered for idempotency checking.
@ -244,12 +244,12 @@ swarm_facts:
type: complex type: complex
contains: contains:
Worker: Worker:
description: Token to create a new I(worker) node description: Token to create a new *worker* node
returned: success returned: success
type: str type: str
example: SWMTKN-1--xxxxx example: SWMTKN-1--xxxxx
Manager: Manager:
description: Token to create a new I(manager) node description: Token to create a new *manager* node
returned: success returned: success
type: str type: str
example: SWMTKN-1--xxxxx example: SWMTKN-1--xxxxx

6
lib/ansible/modules/cloud/docker/docker_swarm_info.py
Unescape Escape View File

@ -75,9 +75,9 @@ options:
default: no default: no
verbose_output: verbose_output:
description: description:
- When set to C(yes) and I(nodes), I(services) or I(tasks) is set to C(yes) - When set to C(yes) and I(nodes), I(services) or I(tasks) is set to C(yes), then the module output will
then output will contain verbose information about objects matching the full output of API method. contain verbose information about objects matching the full output of API method.
For details see the documentation of your version of Docker API at U(https://docs.docker.com/engine/api/). - For details see the documentation of your version of Docker API at U(https://docs.docker.com/engine/api/).
- The verbose output in this module contains only subset of information returned by I(_info) module - The verbose output in this module contains only subset of information returned by I(_info) module
for each type of the objects. for each type of the objects.
type: bool type: bool

18
lib/ansible/modules/cloud/docker/docker_swarm_service.py
Unescape Escape View File

@ -211,7 +211,7 @@ options:
type: float type: float
memory: memory:
description: description:
- "Service memory reservation (format: C(<number>[<unit>])). Number is a positive integer. - "Service memory reservation in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- C(0) equals no reservation. - C(0) equals no reservation.
@ -228,7 +228,7 @@ options:
type: float type: float
limit_memory: limit_memory:
description: description:
- "Service memory limit (format: C(<number>[<unit>])). Number is a positive integer. - "Service memory limit in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- C(0) equals no limit. - C(0) equals no limit.
@ -347,7 +347,7 @@ options:
version_added: "2.8" version_added: "2.8"
tmpfs_size: tmpfs_size:
description: description:
- "Size of the tmpfs mount (format: C(<number>[<unit>])). Number is a positive integer. - "Size of the tmpfs mount in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- Can only be used when I(mode) is C(tmpfs). - Can only be used when I(mode) is C(tmpfs).
@ -368,8 +368,8 @@ options:
networks: networks:
description: description:
- List of the service networks names or dictionaries. - List of the service networks names or dictionaries.
- When passed dictionaries valid sub-options are C(name) which is required and - When passed dictionaries valid sub-options are I(name), which is required, and
C(aliases) and C(options). I(aliases) and I(options).
- Prior to API version 1.29, updating and removing networks is not supported. - Prior to API version 1.29, updating and removing networks is not supported.
If changes are made the service will then be removed and recreated. If changes are made the service will then be removed and recreated.
- Corresponds to the C(--network) option of C(docker service create). - Corresponds to the C(--network) option of C(docker service create).
@ -453,7 +453,7 @@ options:
type: float type: float
memory: memory:
description: description:
- "Service memory reservation (format: C(<number>[<unit>])). Number is a positive integer. - "Service memory reservation in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- C(0) equals no reservation. - C(0) equals no reservation.
@ -470,7 +470,7 @@ options:
type: float type: float
reserve_memory: reserve_memory:
description: description:
- "Service memory reservation (format: C(<number>[<unit>])). Number is a positive integer. - "Service memory reservation in format C(<number>[<unit>]). Number is a positive integer.
Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte), Unit can be C(B) (byte), C(K) (kibibyte, 1024B), C(M) (mebibyte), C(G) (gibibyte),
C(T) (tebibyte), or C(P) (pebibyte)." C(T) (tebibyte), or C(P) (pebibyte)."
- C(0) equals no reservation. - C(0) equals no reservation.
@ -636,8 +636,8 @@ options:
type: int type: int
state: state:
description: description:
- I(absent) - A service matching the specified name will be removed and have its tasks stopped. - C(absent) - A service matching the specified name will be removed and have its tasks stopped.
- I(present) - Asserts the existence of a service matching the name and provided configuration parameters. - C(present) - Asserts the existence of a service matching the name and provided configuration parameters.
Unspecified configuration parameters will be set to docker defaults. Unspecified configuration parameters will be set to docker defaults.
type: str type: str
required: yes required: yes

4
lib/ansible/modules/cloud/docker/docker_volume.py
Unescape Escape View File

@ -60,8 +60,8 @@ options:
version_added: "2.8" version_added: "2.8"
description: description:
- Controls when a volume will be recreated when I(state) is C(present). Please - Controls when a volume will be recreated when I(state) is C(present). Please
note that recreating an existing volume will cause I(any data in the existing volume note that recreating an existing volume will cause **any data in the existing volume
to be lost!) The volume will be deleted and a new volume with the same name will be to be lost!** The volume will be deleted and a new volume with the same name will be
created. created.
- The value C(always) forces the volume to be always recreated. - The value C(always) forces the volume to be always recreated.
- The value C(never) makes sure the volume will not be recreated. - The value C(never) makes sure the volume will not be recreated.

2
lib/ansible/modules/cloud/docker/docker_volume_info.py
Unescape Escape View File

@ -66,7 +66,7 @@ exists:
volume: volume:
description: description:
- Volume inspection results for the affected volume. - Volume inspection results for the affected volume.
- Will be C(None) if volume does not exist. - Will be C(none) if volume does not exist.
returned: success returned: success
type: dict type: dict
sample: '{ sample: '{

6
lib/ansible/plugins/doc_fragments/docker.py
Unescape Escape View File

@ -75,7 +75,7 @@ options:
tls: tls:
description: description:
- Secure the connection to the API by using TLS without verifying the authenticity of the Docker host - Secure the connection to the API by using TLS without verifying the authenticity of the Docker host
server. Note that if C(tls_verify) is set to C(yes) as well, it will take precedence. server. Note that if I(validate_certs) is set to C(yes) as well, it will take precedence.
- If the value is not specified in the task, the value of environment variable C(DOCKER_TLS) will be used - If the value is not specified in the task, the value of environment variable C(DOCKER_TLS) will be used
instead. If the environment variable is not set, the default value will be used. instead. If the environment variable is not set, the default value will be used.
type: bool type: bool
@ -116,7 +116,7 @@ requirements:
Python module has been superseded by L(docker,https://pypi.org/project/docker/) Python module has been superseded by L(docker,https://pypi.org/project/docker/)
(see L(here,https://github.com/docker/docker-py/issues/1310) for details). (see L(here,https://github.com/docker/docker-py/issues/1310) for details).
For Python 2.6, C(docker-py) must be used. Otherwise, it is recommended to For Python 2.6, C(docker-py) must be used. Otherwise, it is recommended to
install the C(docker) Python module. Note that both modules should I(not) install the C(docker) Python module. Note that both modules should *not*
be installed at the same time. Also note that when both modules are installed be installed at the same time. Also note that when both modules are installed
and one of them is uninstalled, the other might no longer function and a and one of them is uninstalled, the other might no longer function and a
reinstall of it is required." reinstall of it is required."
@ -132,5 +132,5 @@ requirements:
- "Docker SDK for Python: Please note that the L(docker-py,https://pypi.org/project/docker-py/) - "Docker SDK for Python: Please note that the L(docker-py,https://pypi.org/project/docker-py/)
Python module has been superseded by L(docker,https://pypi.org/project/docker/) Python module has been superseded by L(docker,https://pypi.org/project/docker/)
(see L(here,https://github.com/docker/docker-py/issues/1310) for details). (see L(here,https://github.com/docker/docker-py/issues/1310) for details).
This module does I(not) work with docker-py." This module does *not* work with docker-py."
''' '''

Write Preview
Loading…
Cancel
Save