ansible/library/fetch

# this is a virtual module that is entirely implemented server side

DOCUMENTATION = '''
---
module: fetch
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 this module is written to transfer 
       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'.
version_added: "0.2"
options:
  src:
    description:
      - The file on the remote system to fetch. This I(must) be a file, not a
        directory. Recursive fetching may be supported in a later release.
    required: true
    default: null
    aliases: []
  dest:
    description:
      - A directory to save the file into. For example, if the I(dest)
        directory is C(/backup) a I(src) file named C(/etc/profile) on host
        C(host.example.com), would be saved into
        C(/backup/host.example.com/etc/profile)
    required: true
    default: null
  fail_on_missing:
    version_added: "1.1"
    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"
requirements: []
author: Michael DeHaan
'''
Setup module no longer saves to disk, as templates are mostly useful in playbooks and this allows lots of simplifications around file pathing and removes occasional permissions conflicts depending on how things are used. 2012-07-14 15:59:12 +00:00			`# this is a virtual module that is entirely implemented server side`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00
			`DOCUMENTATION = '''`
			`---`
			`module: fetch`
			`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,`
Update fetch documentation 2013-03-18 03:17:56 +00:00			`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`
			`be an error unless fail_on_missing is set to 'yes'.`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`version_added: "0.2"`
			`options:`
			`src:`
			`description:`
DOCUMENTATION strings 2012-11-21 17:49:30 +00:00			`- The file on the remote system to fetch. This I(must) be a file, not a`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`directory. Recursive fetching may be supported in a later release.`
			`required: true`
			`default: null`
			`aliases: []`
			`dest:`
			`description:`
			`- A directory to save the file into. For example, if the I(dest)`
DOCUMENTATION strings 2012-11-21 17:49:30 +00:00			`directory is C(/backup) a I(src) file named C(/etc/profile) on host`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`C(host.example.com), would be saved into`
			`C(/backup/host.example.com/etc/profile)`
			`required: true`
			`default: null`
Added a fail_on_missing option to fetch. 2013-03-02 18:04:48 +00:00			`fail_on_missing:`
Double quoted version_added in documentation 2013-03-30 19:44:34 +00:00			`version_added: "1.1"`
Added a fail_on_missing option to fetch. 2013-03-02 18:04:48 +00:00			`description:`
Double quoted version_added in documentation 2013-03-30 19:44:34 +00:00			`- Makes it fails when the source file is missing.`
Added a fail_on_missing option to fetch. 2013-03-02 18:04:48 +00:00			`required: false`
			`choices: [ "yes", "no" ]`
			`default: "no"`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`examples:`
Reformat code: examples consistently - added terse syntax to modules.rst - added description of special variables to template module 2012-10-23 13:14:01 +00:00			`- code: "fetch: src=/var/log/messages dest=/home/logtree"`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`description: "Example from Ansible Playbooks"`
			`requirements: []`
			`author: Michael DeHaan`
			`'''`