Initial Commit.

This commit is contained in:
James Martin 2013-05-23 13:33:36 -04:00
parent 008e18d1d3
commit 79cd04e689

View file

@ -7,7 +7,7 @@ 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 this module is written to transfer organized by hostname. Note that this module is written to transfer
log files that might not be present, so a missing remote file won't log files that might not be present, so a missing remote file won't
be an error unless fail_on_missing is set to 'yes'. be an error unless fail_on_missing is set to 'yes'.
version_added: "0.2" version_added: "0.2"
@ -34,9 +34,22 @@ options:
required: false required: false
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
default: "no" default: "no"
flat:
version_added: "1.2"
description:
Allows you to override the default behavior of prepending hostname/path/to/file to
the destination. If dest ends with '/', it will use the basename of the source
file, similar to the copy module. Obvioiusly this is only handy if the filenames
are unqiue.
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"
- code: "fetch: src=/tmp/somefile dest="/tmp/beefcake-{{ ansible_hostname }}" flat=yes"
description: "Copies a file from remote machine and stores it at the absolute path /tmp/beefcake-{{ ansible_hostname }}"
- code: "fetch: src=/tmp/uniquefile dest="/tmp/special/" flat=yes"
description: "Copies a file from remote machine and stores it at the absolute path /tmp/special"
- code: "fetch: src=/tmp/uniquefile dest="special/" flat=yes"
description: "Copies a file from remote machine and stores it in special/uniquefile relative to the playbook"
requirements: [] requirements: []
author: Michael DeHaan author: Michael DeHaan
''' '''