mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Clarified documentation for the unsafe_writes option (#27471)
* Clarified documentation for the unsafe_writes option per #24449.
This commit is contained in:
parent
17ca0a9bd9
commit
dd5d191d7a
1 changed files with 7 additions and 5 deletions
|
@ -57,11 +57,13 @@ options:
|
||||||
default: "s0"
|
default: "s0"
|
||||||
unsafe_writes:
|
unsafe_writes:
|
||||||
description:
|
description:
|
||||||
- Normally this module uses atomic operations to prevent data corruption or inconsistent reads from the target files,
|
- By default this module uses atomic operations to prevent data
|
||||||
sometimes systems are configured or just broken in ways that prevent this. One example are docker mounted files,
|
corruption or inconsistent reads from the target files,
|
||||||
they cannot be updated atomically and can only be done in an unsafe manner.
|
but sometimes systems are configured or just broken in ways that prevent this. One example is docker mounted files,
|
||||||
- This boolean option allows ansible to fall back to unsafe methods of updating files for those cases in which you do
|
which cannot be updated atomically from inside the container and can only be written in an unsafe manner.
|
||||||
not have any other choice. Be aware that this is subject to race conditions and can lead to data corruption.
|
- This option allows Ansible to fall back to unsafe methods of
|
||||||
|
updating files when atomic operations fail (however, it doesn't force Ansible to perform unsafe writes).
|
||||||
|
IMPORTANT! Unsafe writes are subject to race conditions and can lead to data corruption.
|
||||||
type: bool
|
type: bool
|
||||||
default: 'no'
|
default: 'no'
|
||||||
version_added: "2.2"
|
version_added: "2.2"
|
||||||
|
|
Loading…
Reference in a new issue