Added a fail_on_missing option to fetch.

This commit is contained in:
Yves Dorfsman 2013-03-02 11:04:48 -07:00
parent acb2ab73c2
commit d79d57fbfe

11
fetch
View file

@ -7,8 +7,9 @@ short_description: Fetches a file from remote nodes
description:
- 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,
organized by hostname. Note that if the source file is missing, it
returns status=ok.
organized by hostname. Note that this module was originally written to
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"
options:
src:
@ -26,6 +27,12 @@ options:
C(/backup/host.example.com/etc/profile)
required: true
default: null
fail_on_missing:
description:
- Makes it fails when the source file is missing.
required: false
choices: [ "yes", "no" ]
default: "no"
examples:
- code: "fetch: src=/var/log/messages dest=/home/logtree"
description: "Example from Ansible Playbooks"