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.
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
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 17:59:12 +02: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 12:21:35 +02: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,`
			`organized by hostname.`
			`version_added: "0.2"`
			`options:`
			`src:`
			`description:`
DOCUMENTATION strings 2012-11-21 18:49:30 +01: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 12:21:35 +02: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 18:49:30 +01: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 12:21:35 +02:00			`C(host.example.com), would be saved into`
			`C(/backup/host.example.com/etc/profile)`
			`required: true`
			`default: null`
			`examples:`
Reformat code: examples consistently - added terse syntax to modules.rst - added description of special variables to template module 2012-10-23 15:14:01 +02: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 12:21:35 +02:00			`description: "Example from Ansible Playbooks"`
			`requirements: []`
			`author: Michael DeHaan`
			`'''`