docker_network: adjust documentation to reality for state=absent + force=true. (#1016)

This commit is contained in:
Felix Fontein 2024-12-20 22:51:04 +01:00 committed by GitHub
parent 742a373e59
commit d17ee667ce
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -73,9 +73,7 @@ options:
force:
description:
- With state V(absent) forces disconnecting all containers from the
network prior to deleting the network. With state V(present) will
disconnect all containers, delete the network and re-create the
- With state V(present) will disconnect all containers for existing networks, delete the network and re-create the
network.
- This option is required if you have changed the IPAM or driver options
and want an existing network to be updated to use the new options.
@ -139,9 +137,8 @@ options:
state:
description:
- V(absent) deletes the network. If a network has connected containers, it
cannot be deleted. Use the O(force) option to disconnect all containers
and delete the network.
- V(absent) deletes the network. If a network has connected containers, these will be
detached from the network.
- V(present) creates the network, if it does not already exist with the
specified parameters, and connects the list of containers provided via
the connected parameter. Containers not on the list will be disconnected.
@ -265,7 +262,6 @@ EXAMPLES = '''
community.docker.docker_network:
name: network_one
state: absent
force: true
'''
RETURN = '''