Added a fail_on_missing option to fetch.

reviewable/pr18780/r1
Yves Dorfsman 12 years ago
parent acb2ab73c2
commit d79d57fbfe

11
fetch

@ -7,8 +7,9 @@ short_description: Fetches a file from remote nodes
description: description:
- This module works like M(copy), but in reverse. It is used for fetching - This module works like M(copy), but in reverse. It is used for fetching
files from remote machines and storing them locally in a file tree, files from remote machines and storing them locally in a file tree,
organized by hostname. Note that if the source file is missing, it organized by hostname. Note that this module was originally written to
returns status=ok. transfer log files that were not necessarily present, therefore, by
default, if the source file is missing, it does not fail ;
version_added: "0.2" version_added: "0.2"
options: options:
src: src:
@ -26,6 +27,12 @@ options:
C(/backup/host.example.com/etc/profile) C(/backup/host.example.com/etc/profile)
required: true required: true
default: null default: null
fail_on_missing:
description:
- Makes it fails when the source file is missing.
required: false
choices: [ "yes", "no" ]
default: "no"
examples: examples:
- code: "fetch: src=/var/log/messages dest=/home/logtree" - code: "fetch: src=/var/log/messages dest=/home/logtree"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"

Loading…
Cancel
Save