mirror of
https://github.com/ansible-collections/community.docker.git
synced 2026-04-05 11:08:51 +00:00
Fix M(). (#591)
* Fix M(). * Break long line. * Fix the remaining M(...). * Break long line.
This commit is contained in:
parent
bcd7b9bde4
commit
baf78aca3a
@ -101,7 +101,7 @@ notes:
|
|||||||
with the product that sets up the environment. It will set these variables for you. See
|
with the product that sets up the environment. It will set these variables for you. See
|
||||||
U(https://docs.docker.com/machine/reference/env/) for more details.
|
U(https://docs.docker.com/machine/reference/env/) for more details.
|
||||||
- When connecting to Docker daemon with TLS, you might need to install additional Python packages.
|
- When connecting to Docker daemon with TLS, you might need to install additional Python packages.
|
||||||
For the Docker SDK for Python, version 2.4 or newer, this can be done by installing C(docker[tls]) with M(pip).
|
For the Docker SDK for Python, version 2.4 or newer, this can be done by installing C(docker[tls]) with M(ansible.builtin.pip).
|
||||||
- Note that the Docker SDK for Python only allows to specify the path to the Docker configuration for very few functions.
|
- Note that the Docker SDK for Python only allows to specify the path to the Docker configuration for very few functions.
|
||||||
In general, it will use C($HOME/.docker/config.json) if the C(DOCKER_CONFIG) environment variable is not specified,
|
In general, it will use C($HOME/.docker/config.json) if the C(DOCKER_CONFIG) environment variable is not specified,
|
||||||
and use C($DOCKER_CONFIG/config.json) otherwise.
|
and use C($DOCKER_CONFIG/config.json) otherwise.
|
||||||
|
|||||||
@ -522,7 +522,7 @@ options:
|
|||||||
- 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 I(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(community.docker.docker_container) does not remove the default
|
||||||
network if I(networks) is specified. You need to explicitly use I(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 I(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 community.general 2.0.0 on.
|
Alternatively, use the I(networks_cli_compatible) option, which will be enabled by default from community.general 2.0.0 on.
|
||||||
|
|||||||
@ -15,7 +15,7 @@ short_description: Retrieves facts about docker container
|
|||||||
|
|
||||||
description:
|
description:
|
||||||
- Retrieves facts about a docker container.
|
- Retrieves facts about a docker container.
|
||||||
- Essentially returns the output of C(docker inspect <name>), similar to what M(docker_container)
|
- Essentially returns the output of C(docker inspect <name>), similar to what M(community.docker.docker_container)
|
||||||
returns for a non-absent container.
|
returns for a non-absent container.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -19,7 +19,7 @@ description:
|
|||||||
- If an image does not exist locally, it will not appear in the results. If you want to check whether an image exists
|
- If an image does not exist locally, it will not appear in the results. If you want to check whether an image exists
|
||||||
locally, you can call the module with the image name, then check whether the result list is empty (image does not
|
locally, you can call the module with the image name, then check whether the result list is empty (image does not
|
||||||
exist) or has one element (the image exists locally).
|
exist) or has one element (the image exists locally).
|
||||||
- The module will not attempt to pull images from registries. Use M(docker_image) with I(source) set to C(pull)
|
- The module will not attempt to pull images from registries. Use M(community.docker.docker_image) with I(source) set to C(pull)
|
||||||
to ensure an image is pulled.
|
to ensure an image is pulled.
|
||||||
|
|
||||||
notes:
|
notes:
|
||||||
|
|||||||
@ -27,7 +27,7 @@ options:
|
|||||||
- List of container names or container IDs to connect to a network.
|
- List of container names or container IDs to connect to a network.
|
||||||
- Please note that the module only makes sure that these containers are connected to the network,
|
- Please note that the module only makes sure that these containers are connected to the network,
|
||||||
but does not care about connection options. If you rely on specific IP addresses etc., use the
|
but does not care about connection options. If you rely on specific IP addresses etc., use the
|
||||||
M(docker_container) module to ensure your containers are correctly connected to this network.
|
M(community.docker.docker_container) module to ensure your containers are correctly connected to this network.
|
||||||
type: list
|
type: list
|
||||||
elements: str
|
elements: str
|
||||||
aliases:
|
aliases:
|
||||||
@ -180,7 +180,7 @@ notes:
|
|||||||
- When network options are changed, the module disconnects all containers from the network, deletes the network, and re-creates the network.
|
- When network options are changed, the module disconnects all containers from the network, deletes the network, and re-creates the network.
|
||||||
It does not try to reconnect containers, except the ones listed in (I(connected), and even for these, it does not consider specific
|
It does not try to reconnect containers, except the ones listed in (I(connected), and even for these, it does not consider specific
|
||||||
connection options like fixed IP addresses or MAC addresses. If you need more control over how the containers are connected to the
|
connection options like fixed IP addresses or MAC addresses. If you need more control over how the containers are connected to the
|
||||||
network, loop the M(docker_container) module to loop over your containers to make sure they are connected properly.
|
network, loop the M(community.docker.docker_container) module to loop over your containers to make sure they are connected properly.
|
||||||
- The module does not support Docker Swarm, i.e. it will not try to disconnect or reconnect services. If services are connected to the
|
- The module does not support Docker Swarm, i.e. it will not try to disconnect or reconnect services. If services are connected to the
|
||||||
network, deleting the network will fail. When network options are changed, the network has to be deleted and recreated, so this will
|
network, deleting the network will fail. When network options are changed, the network has to be deleted and recreated, so this will
|
||||||
fail as well.
|
fail as well.
|
||||||
|
|||||||
@ -15,7 +15,7 @@ short_description: Retrieves facts about docker network
|
|||||||
|
|
||||||
description:
|
description:
|
||||||
- Retrieves facts about a docker network.
|
- Retrieves facts about a docker network.
|
||||||
- Essentially returns the output of C(docker network inspect <name>), similar to what M(docker_network)
|
- Essentially returns the output of C(docker network inspect <name>), similar to what M(community.docker.docker_network)
|
||||||
returns for a non-absent network.
|
returns for a non-absent network.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -26,7 +26,7 @@ options:
|
|||||||
description:
|
description:
|
||||||
- User-defined key/value metadata that will be assigned as node attribute.
|
- User-defined key/value metadata that will be assigned as node attribute.
|
||||||
- Label operations in this module apply to the docker swarm node specified by I(hostname).
|
- Label operations in this module apply to the docker swarm node specified by I(hostname).
|
||||||
Use M(docker_swarm) module to add/modify/remove swarm cluster labels.
|
Use M(community.docker.docker_swarm) module to add/modify/remove swarm cluster labels.
|
||||||
- The actual state of labels assigned to the node when module completes its work depends on
|
- The actual state of labels assigned to the node when module completes its work depends on
|
||||||
I(labels_state) and I(labels_to_remove) parameters values. See description below.
|
I(labels_state) and I(labels_to_remove) parameters values. See description below.
|
||||||
type: dict
|
type: dict
|
||||||
|
|||||||
@ -139,7 +139,7 @@ options:
|
|||||||
description:
|
description:
|
||||||
- User-defined key/value metadata.
|
- User-defined key/value metadata.
|
||||||
- Label operations in this module apply to the docker swarm cluster.
|
- Label operations in this module apply to the docker swarm cluster.
|
||||||
Use M(docker_node) module to add/modify/remove swarm node labels.
|
Use M(community.docker.docker_node) module to add/modify/remove swarm node labels.
|
||||||
- Requires API version >= 1.32.
|
- Requires API version >= 1.32.
|
||||||
type: dict
|
type: dict
|
||||||
signing_ca_cert:
|
signing_ca_cert:
|
||||||
@ -165,7 +165,7 @@ options:
|
|||||||
description:
|
description:
|
||||||
- If set, generate a key and use it to lock data stored on the managers.
|
- If set, generate a key and use it to lock data stored on the managers.
|
||||||
- Docker default value is C(no).
|
- Docker default value is C(no).
|
||||||
- M(docker_swarm_info) can be used to retrieve the unlock key.
|
- M(community.docker.docker_swarm_info) can be used to retrieve the unlock key.
|
||||||
type: bool
|
type: bool
|
||||||
rotate_worker_token:
|
rotate_worker_token:
|
||||||
description: Rotate the worker join token.
|
description: Rotate the worker join token.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user