ANSIBLE.ASSEMBLE(3)             ANSIBLE MODULES            ANSIBLE.ASSEMBLE(3)



NAME
       assemble - Assembles a configuration file from fragments

DESCRIPTION
       Assembles a configuration file from fragments. Often a particular
       program will take a single configuration file and does not support a
       conf.d style structure where it is easy to build up the configuration
       from multiple sources. assemble will take a directory of files that can
       be local or have already been transferred to the system, and
       concatenate them together to produce a destination file. Files are
       assembled in string sorting order. Puppet calls this idea fragments.

OPTIONS
       backup Create a backup file (if yes), including the timestamp
              information so you can get the original file back if you somehow
              clobbered it incorrectly.  Choices: yes,no. (default: no)

       delimiter
              A delimiter to seperate the file contents.(Added in Ansible
              version 1.4.)


       dest   A file to create using the concatenation of all of the source
              files.(required)

       others all arguments accepted by the file module also work here

       regexp Assemble files only if regex matches the filename. If not set,
              all files are assembled. All "" (backslash) must be escaped as
              "\" to comply yaml syntax. Uses Python regular expressions; see
              http://docs.python.org/2/library/re.html.

       remote_src
              If False, it will search for src at originating/master machine,
              if True it will go to the remote/target machine for the src.
              Default is True.  Choices: True,False. (default: True)(Added in
              Ansible version 1.4.)


       src    An already existing directory full of source files.(required).

EXAMPLES
       # Example from Ansible Playbooks
       - assemble: src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf

       # When a delimiter is specified, it will be inserted in between each fragment
       - assemble: src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf delimiter='### START FRAGMENT ###'



AUTHOR
       Stephen Fromm

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#assemble



1.4.5                             2014-02-12               ANSIBLE.ASSEMBLE(3)
