From 826c71fcb17cc6895e7bf0c3fbfeda93eebed7e7 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Wed, 3 Oct 2012 20:58:27 -0400 Subject: [PATCH] Fix patterns typo, rebuild --- YAMLSyntax.html | 2 +- api.html | 2 +- bestpractices.html | 2 +- examples.html | 2 +- genindex.html | 2 +- gettingstarted.html | 2 +- index.html | 2 +- moduledev.html | 2 +- modules.html | 2760 +++++++++++++++---------------- patterns.html | 6 +- playbooks.html | 2 +- playbooks2.html | 2 +- rst/modules/apt.rst | 102 +- rst/modules/apt_repository.rst | 52 +- rst/modules/assemble.rst | 67 +- rst/modules/async_status.rst | 44 + rst/modules/authorized_key.rst | 54 +- rst/modules/command.rst | 79 +- rst/modules/copy.rst | 70 +- rst/modules/easy_install.rst | 59 +- rst/modules/facter.rst | 17 +- rst/modules/fail.rst | 42 + rst/modules/fetch.rst | 48 +- rst/modules/file.rst | 115 +- rst/modules/fireball.rst | 61 + rst/modules/get_url.rst | 45 +- rst/modules/git.rst | 73 +- rst/modules/group.rst | 64 +- rst/modules/ini_file.rst | 61 +- rst/modules/lineinfile.rst | 59 +- rst/modules/mount.rst | 91 +- rst/modules/mysql_db.rst | 99 +- rst/modules/mysql_user.rst | 117 +- rst/modules/nagios.rst | 197 +-- rst/modules/ohai.rst | 17 +- rst/modules/pause.rst | 57 + rst/modules/ping.rst | 14 +- rst/modules/pip.rst | 84 +- rst/modules/postgresql_db.rst | 93 +- rst/modules/postgresql_user.rst | 147 +- rst/modules/raw.rst | 11 +- rst/modules/seboolean.rst | 54 +- rst/modules/selinux.rst | 58 +- rst/modules/service.rst | 74 +- rst/modules/setup.rst | 16 +- rst/modules/shell.rst | 65 +- rst/modules/slurp.rst | 44 + rst/modules/subversion.rst | 57 +- rst/modules/supervisorctl.rst | 42 +- rst/modules/template.rst | 73 +- rst/modules/user.rst | 156 +- rst/modules/virt.rst | 80 +- rst/modules/wait_for.rst | 73 +- rst/modules/yum.rst | 57 +- rst/patterns.rst | 4 +- search.html | 2 +- searchindex.js | 2 +- 57 files changed, 3398 insertions(+), 2284 deletions(-) create mode 100644 rst/modules/async_status.rst create mode 100644 rst/modules/fail.rst create mode 100644 rst/modules/fireball.rst create mode 100644 rst/modules/pause.rst create mode 100644 rst/modules/slurp.rst diff --git a/YAMLSyntax.html b/YAMLSyntax.html index 88ed667934..5354b29941 100644 --- a/YAMLSyntax.html +++ b/YAMLSyntax.html @@ -268,7 +268,7 @@ languages:

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/api.html b/api.html index ebcd4893c1..25ac19ef41 100644 --- a/api.html +++ b/api.html @@ -483,7 +483,7 @@ directory.

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/bestpractices.html b/bestpractices.html index 27b26bcec3..0f0ae26a5f 100644 --- a/bestpractices.html +++ b/bestpractices.html @@ -327,7 +327,7 @@ different variables to different geographies.

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/examples.html b/examples.html index 14c698dcd5..a1bb036f8c 100644 --- a/examples.html +++ b/examples.html @@ -446,7 +446,7 @@ the first config file it finds present:

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/genindex.html b/genindex.html index 22b37f522b..5090f7b5bc 100644 --- a/genindex.html +++ b/genindex.html @@ -185,7 +185,7 @@ s.parentNode.insertBefore(ga, s);

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/gettingstarted.html b/gettingstarted.html index 8512e63b3d..d71d018be2 100644 --- a/gettingstarted.html +++ b/gettingstarted.html @@ -403,7 +403,7 @@ explore, but you already have a fully working infrastructure!

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/index.html b/index.html index ef6132743f..bcb873f3d9 100644 --- a/index.html +++ b/index.html @@ -200,7 +200,7 @@ s.parentNode.insertBefore(ga, s);

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/moduledev.html b/moduledev.html index 6274d4039a..c44ab63da6 100644 --- a/moduledev.html +++ b/moduledev.html @@ -507,7 +507,7 @@ the program. Stop by the mailing list to inquire about requirements.

© Copyright 2012 Michael DeHaan.
- Last updated on Sep 28, 2012.
+ Last updated on Oct 03, 2012.

diff --git a/modules.html b/modules.html index 2493734ad4..06f405aa1a 100644 --- a/modules.html +++ b/modules.html @@ -220,47 +220,47 @@ s.parentNode.insertBefore(ga, s);

Contents

+

Add nginx stable repository from PPA

+apt_repository repo=ppa://nginx/stable
+

+

Add specified repository into sources.

+apt_repository repo='deb http://archive.canonical.com/ubuntu hardy partner'
+

+

Notes

+

This module works on Debian and Ubuntu only and requires apt-add-repository be available on destination server. To ensure this package is available use the apt module and install the python-software-properties package before using this module.

+

A bug in apt-add-repository always adds deb and deb-src types for repositories (see the issue on Launchpad https://bugs.launchpad.net/ubuntu/+source/software-properties/+bug/987264), if a repo doesn't have source information (eg MongoDB repo from 10gen) the system will fail while updating repositories.

apt

+

+New in version 0.0.2.

Manages apt-packages (such as for Debian/Ubuntu).

- ------ - - +
parameter
+ + + - - - + + - - + + + - + + - + + - + + - + + - - - - - - - - - - - - + + - + + + - + + - + + - -
parameter required defaultchoices comments
name
purge no A package name or package specifier with version, like foo or foo=1.0no
  • yes
  • no
Will force purging of configuration files if the module state is set to absent.
state
state no present‘absent’, ‘present’, or ‘latest’.
  • installed
  • latest
  • remove
  • absent
  • present
Indicates the desired package state
update_cache
force no noRun the equivalent of apt-get update before the operation. -Can be run as part of the package installation or a seperate step
  • yes
  • no
If yes, force installs/removes.
purgenonoWill forge purge of configuration files if state is set to ‘absent’.
default_releaseno Corresponds to the -t option for apt and sets pin priorities
install_recommendsno
pkg yesCorresponds to the –no-install-recommends option for apt, default -behavior works as apt’s default behavior, ‘no’ does not install -recommended packages. Suggested packages are never installed.
    		A package name or package specifier with version, like foo or foo=1.0
    force
    update_cache no noIf ‘yes’, force installs/removes.
    • yes
    • no
    		Run the equivalent of apt-get update before the operation. Can be run as part of the package installation or as a seperate step
    -

    Example action from Ansible Playbooks:

    -
    apt pkg=foo update-cache=yes
+    
+default_release
+no
+
+
      
+Corresponds to the -t option for apt and sets pin priorities
+
+    
+install_recommends
+no
+no
+
      • yes
      • no
      
+Corresponds to the --no-install-recommends option for apt, default behavior works as apt's default behavior, no does not install recommended packages. Suggested packages are never installed.
+
+    
      Update repositories cache and install foo package
          
      +apt pkg=foo update-cache=yes
+
      
+
      Remove foo package
          
       apt pkg=foo state=removed
+
      
+
      Install the the package foo
          
       apt pkg=foo state=installed
+
      
+
      Install the version '1.00' of package foo
          
       apt pkg=foo=1.00 state=installed
+
      
+
      Update the repository cache and update package ngnix to latest version using default release squeeze-backport
          
       apt pkg=nginx state=latest default-release=squeeze-backports update-cache=yes
-apt pkg=openjdk-6-jdk state=latest install-recommends=no
      
-
      -
      +

      +

      Install latest version of openjdk-6-jdk ignoring install-recomands

      +apt pkg=openjdk-6-jdk state=latest install-recommends=no
+

      +

      assemble

      New in version 0.5.

      -

      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 -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”.

      - ------ - - +

      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 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.

      +
      parameter
      + + + - - - + + - - + + + - + + - - + + + - + + - + + - - - - + + + + + + - -
      parameter required defaultchoices comments
      src
      dest yes An already existing directory full of source files
        		A file to create using the concatenation of all of the source files.
        dest
        src yes A file to create using the concatenation of all of the source files
          		An already existing directory full of source files.
          backup
          backup no noCreate a backup file including the timestamp information so you can -get the original file back if you somehow clobbered it incorrectly.
          • yes
          • no
          		Create a backup file (if yes), including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
          OTHERS  All arguments that the file module takes may also be used
          othersno
            		all arguments accepted by the file module also work here
            -

            Example action from Ansible Playbooks:

            -
            assemble src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf
            -
            -
            +

            Example from Ansible Playbooks

            +assemble src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf
+

            +

            authorized_key

            New in version 0.5.

            -

            Adds or removes an authorized key for a user from a remote host.

            - ------ - - +

            Adds or removes an SSH authorized key for a user from a remote host.

            +
            parameter
            + + + - - - - - - - - - - - - - + + + - -
            parameter required defaultchoices comments
            useryes Name of the user who should have access to the remote host
            keyyes the SSH public key, as a string
            state
            state no present
            • present
            • absent
            		 whether the given key should or should not be in the file
            -

            Example action from Ansible Playbooks:

            -
            authorized_key user=charlie key="ssh-dss ASDF1234L+8BTwaRYr/rycsBF1D8e5pTxEsXHQs4iq+mZdyWqlW++L6pMiam1A8yweP+rKtgjK2httVS6GigVsuWWfOd7/sdWippefq74nppVUELHPKkaIOjJNN1zUHFoL/YMwAAAEBALnAsQN10TNGsRDe5arBsW8cTOjqLyYBcIqgPYTZW8zENErFxt7ij3fW3Jh/sCpnmy8rkS7FyK8ULX0PEy/2yDx8/5rXgMIICbRH/XaBy9Ud5bRBFVkEDu/r+rXP33wFPHjWjwvHAtfci1NRBAudQI/98DbcGQw5HmE89CjgZRo5ktkC5yu/8agEPocVjdHyZr7PaHfxZGUDGKtGRL2QzRYukCmWo1cZbMBHcI5FzImvTHS9/8B3SATjXMPgbfBuEeBwuBK5EjL+CtHY5bWs9kmYjmeo0KfUMH8hY4MAXDoKhQ7DhBPIrcjS5jPtoGxIREZjba67r6/P2XKXaCZH6Fc= charlie@example.org 2011-01-17"
            -
            -
            + +user +yes + + +Name of the user who should have access to the remote host + + +key +yes + + +the SSH public key, as a string + +

            Example from Ansible Playbooks

            +authorized_key user=charlie key="ssh-dss ASDF1234L+8BTwaRYr/rycsBF1D8e5pTxEsXHQs4iq+mZdyWqlW++L6pMiam1A8yweP+rKtgjK2httVS6GigVsuWWfOd7/sdWippefq74nppVUELHPKkaIOjJNN1zUHFoL/YMwAAAEBALnAsQN10TNGsRDe5arBsW8cTOjqLyYBcIqgPYTZW8zENErFxt7ij3fW3Jh/sCpnmy8rkS7FyK8ULX0PEy/2yDx8/5rXgMIICbRH/XaBy9Ud5bRBFVkEDu/r+rXP33wFPHjWjwvHAtfci1NRBAudQI/98DbcGQw5HmE89CjgZRo5ktkC5yu/8agEPocVjdHyZr7PaHfxZGUDGKtGRL2QzRYukCmWo1cZbMBHcI5FzImvTHS9/8B3SATjXMPgbfBuEeBwuBK5EjL+CtHY5bWs9kmYjmeo0KfUMH8hY4MAXDoKhQ7DhBPIrcjS5jPtoGxIREZjba67r6/P2XKXaCZH6Fc= charlie@example.org 2011-01-17"
+

            +

            Shorthand available in Ansible 0.8 and later

            +authorized_key user=charlie key=$FILE(/home/charlie/.ssh/id_rsa.pub)
+

            +

            command

            -

            The command module takes the command name followed by a list of -arguments, space delimited.

            - ------ - - +

            The command module takes the command name followed by a list of space-delimited arguments. +The given command will be executed on all selected nodes. It will not be processed through the shell, so variables like $HOME and operations like "<", ">", "|", and "&" will not work. As such, all paths to commands must be fully qualified

            +
            parameter
            + + + - - - - - + + + + + + + + + + + + - + + - - + + + - + + - - + + + - -
            parameter required defaultchoices comments
            (free form)N/AN/A
            createsno
              		a filename, when it already exists, this step will not be run.
              free_formyes
                		 the command module takes a free form command to run
                creates
                chdir no a filename, when it already exists, this step will NOT be run
                  		cd into this directory before running the command (added in Ansible 0.6)
                  chdir
                  removes no cd into this directory before running the command (0.6 and later)
                    		a filename, when it does not exist, this step will not be run. (added in Ansible 0.8)
                    -

                    The given command will be executed on all selected nodes. It will not -be processed through the shell, so variables like “$HOME” and -operations like “<”, “>”, “|”, and “&” will not work. As such, all -paths to commands must be fully qualified.

                    -
                    -

                    Note

                    -

                    If you want to run a command through the shell (say you are using -‘<’, ‘>’, ‘|’, etc), you actually want the ‘shell’ module instead. -The ‘command’ module is much more secure as it’s not affected by -the user’s environment.

                    -
                    -

                    Example action from Ansible Playbooks:

                    -
                    command /sbin/shutdown -t now
                    -
                    -

                    creates and chdir can be specified after the command. For instance, if you only want to run a command if a certain file does not exist, you can do the following:

                    -
                    command /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
                    -
                    -

                    The creates= and chdir options will not be passed to the actual executable.

                    -
                    +

                    Example from Ansible Playbooks

                    +command /sbin/shutdown -t now
+

                    +

                    creates, removes, and chdir can be specified after the command. For instance, if you only want to run a command if a certain file does not exist, use this.

                    +command /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
+

                    +

                    Notes

                    +

                    If you want to run a command through the shell (say you are using <, >, |, etc), you actually want the shell module instead. The command module is much more secure as it's not affected by the user's environment.

                    copy

                    -

                    The copy module moves a file on the local box to remote locations. In addition to the options -listed below, the arguments available to the file module can also be passed to the copy -module.

                    - ------ - - +

                    The copy module copies a file on the local box to remote locations.

                    +
                    parameter
                    + + + - - - + + - - + + + - + + - - + + + - + + - + + - - - - + + + + + + - -
                    parameter required defaultchoices comments
                    src
                    dest yes Local path to a file to copy to the remote server, can be absolute or -relative.
                      		Remote absolute path where the file should be copied to.
                      dest
                      src yes Remote absolute path where the file should end up
                        		Local path to a file to copy to the remote server; can be absolute or relative.
                        backup
                        backup no noCreate a backup file including the timestamp information so you can -get the original file back if you somehow clobbered it incorrectly.
                        • yes
                        • no
                        		Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. (added in Ansible 0.7)
                        OTHERS  All arguments the file module takes are also supported
                        othersno
                          		all arguments accepted by the file module also work here
                          -

                          Example action from Ansible Playbooks:

                          -
                          copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644
                          -
                          -

                          Copy a new ntp.conf file into place, backing up the original if it differs from the copied version:

                          -
                          copy src=/srv/myfiles/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes
                          -
                          -
                          +

                          Example from Ansible Playbooks

                          +copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644
+

                          +

                          Copy a new ntp.conf file into place, backing up the original if it differs from the copied version

                          +copy src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes
+

                          +

                          easy_install

                          New in version 0.7.

                          -

                          The easy_install module installs Python libraries.

                          - ------ - - +

                          Installs Python libraries, optionally in a virtualenv

                          +
                          parameter
                          + + + - - - - - - - - + + - - + + + - -
                          parameter required defaultchoices comments
                          nameyes a Python library name
                          virtualenv
                          virtualenv no an optional virtualenv directory path to install into, if the virtualenv -does not exist it is created automatically
                            		an optional virtualenv directory path to install into. If the virtualenv does not exist, it is created automatically
                            -

                            Please note that the easy_install command can only install Python libraries. -Thus this module is not able to remove libraries. It is generally recommended to -use the pip module which you can first install using easy_install.

                            -

                            Also note that virtualenv must be installed on -the remote host if the virtualenv parameter is specified.

                            -

                            Example action from Ansible Playbooks:

                            -
                            easy_install name=pip
-easy_install name=flask==0.8
-easy_install name=flask virtualenv=/srv/webapps/my_app/venv
                            -
                            -
                            + +name +yes + + +A Python library name + +

                            Examples from Ansible Playbooks

                            +easy_install name=pip
+

                            +

                            Install Flask (http://flask.pocoo.org/) into the specified virtualenv

                            +easy_install name=flask virtualenv=/webapps/myapp/venv
+

                            +

                            Notes

                            +

                            Please note that the easy_install module can only install Python libraries. Thus this module is not able to remove libraries. It is generally recommended to use the pip module which you can first install using easy_install.

                            +

                            Also note that virtualenv must be installed on the remote host if the virtualenv parameter is specified.

                            facter

                            -

                            Runs the discovery program ‘facter’ on the remote system, returning -JSON data that can be useful for inventory purposes.

                            -

                            Requires that ‘facter’ and ‘ruby-json’ be installed on the remote end.

                            -

                            Playbooks do not actually use this module, they use the setup -module behind the scenes.

                            -

                            Example from /usr/bin/ansible:

                            -
                            ansible foo.example.org -m facter
                            -
                            -
                            +

                            +New in version 0.2.

                            +

                            Runs the facter discovery program (https://github.com/puppetlabs/facter) on the remote system, returning JSON data that can be useful for inventory purposes.

                            +

                            Example command-line invocation

                            +ansible  www.example.net -m facter
+

                            +

                            fetch

                            -

                            This module works like ‘copy’, but in reverse. It is used for fetching files -from remote machines and storing them locally in a file tree, organized by hostname.

                            - ------ - - +

                            +New in version 0.2.

                            +

                            This module works like copy, but in reverse. It is used for fetching files from remote machines and storing them locally in a file tree, organized by hostname.

                            +
                            parameter
                            + + + - - - + + - - + + + - + + - - + + + - -
                            parameter required defaultchoices comments
                            src
                            dest yes The file on the remote system to fetch. This needs to be a file, not -a directory. Recursive fetching may be supported in a later release.
                              		A directory to save the file into. For example, if the dest directory is /backup a src file named /etc/profile on host host.example.com, would be saved into /backup/host.example.com/etc/profile
                              dest
                              src yes A directory to save the file into. For example, if the ‘dest’ directory -is ‘/foo’, a src file named ‘/tmp/bar’ on host ‘host.example.com’, would -be saved into ‘/foo/host.example.com/tmp/bar’
                                		The file on the remote system to fetch. This must be a file, not a directory. Recursive fetching may be supported in a later release.
                                -

                                Example:

                                -
                                fetch src=/var/log/messages dest=/home/logtree
                                -
                                -
                                +

                                Example from Ansible Playbooks

                                +fetch src=/var/log/messages dest=/home/logtree
+

                                +

                                file

                                -

                                -New in version 0.1.

                                Sets attributes of files, symlinks, and directories, or removes files/symlinks/directories. Many other modules support the same options as the file module - including copy, template, and assmeble.

                                @@ -703,36 +677,98 @@ be saved into ‘/foo/host.example.com/tmp/bar’ - - + + + + + + + + + + + + + + + - - + + - - - - - - - + + + + + + - - - - + + + - + - -
                                choices comments
                                srcno
                                  		path of the file to link to (applies only to state=link).
                                  groupno
                                    		name of the group that should own the file/directory, as would be fed to chown
                                    destTrue[]yes
                                      		defines the file being managed, unless when used with state=link, and then sets the destination to create a symbolic link to using src
                                      stateFalsefile
                                      • file
                                      • link
                                      • directory
                                      • absent
                                      		If directory, all immediate subdirectories will be created if they do not exist. If file, the file will NOT be created if it does not exist, see the copy or template module if you want that behavior. If link, the symbolic link will be created or changed. If absent, directories will be recursively deleted, and files or symlinks will be unlinked.
                                      selevelnos0
                                        		level part of the SELinux file context. This is the MLS/MCS attribute, sometimes known as the range. _default feature works as for seuser.
                                        modeFalse
                                        seuserno
                                          		mode the file or directory should be, such as 0644 as would be fed to chmod. English modes like g+x are not yet supporteduser part of SELinux file context. Will default to system policy, if applicable. If set to _default, it will use the user portion of the the policy if available

                                          Example from Ansible Playbooks

                                          -

                                          -file path=/etc/foo.conf owner=foo group=foo mode=0644

                                          - -
                                          + +state +no +file + +If directory, all immediate subdirectories will be created if they do not exist. If file, the file will NOT be created if it does not exist, see the copy or template module if you want that behavior. If link, the symbolic link will be created or changed. If absent, directories will be recursively deleted, and files or symlinks will be unlinked. + + +serole +no + + +role part of SELinux file context, _default feature works as for seuser. + + +mode +no + + +mode the file or directory should be, such as 0644 as would be fed to + + +context +no + + +accepts only default as value. This will restore a file's SELinux context in the policy. Does nothing if no default value is available. + + +owner +no + + +name of the user that should own the file/directory, as would be fed to chown + + +force +no + + +force is required when changing an existing file to a directory, or a link to a directory, and so on. Use this with caution. + + +setype +no + + +type part of SELinux file context, _default feature works as for seuser. + +

                                          Example from Ansible Playbooks

                                          +file path=/etc/foo.conf owner=foo group=foo mode=0644
+

                                          + 

                                          +file src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link
+

                                          +

                                          Notes

                                          +

                                          See also copy, template, assemble

                                          get_url

                                          @@ -746,140 +782,136 @@ file path=/etc/foo.conf owner=foo group=foo mode=0644

                                          choices comments - - + url -True -None +yes + HTTP, HTTPS, or FTP URL - - + dest -True -None +yes + absolute path of where to download the file to.If dest is a directory, the basename of the file on the remote server will be used. If a directory, thirsty=yes must also be set. - - + thirsty -False +no no -if yes, will download the file every time and replace the file if the contents change. if no, the file will only be downloaded if the destination does not exist. Generally should be yes only for small local files. prior to 0.6, acts if yes by default. +if yes, will download the file every time and replace the file if the contents change. if no, the file will only be downloaded if the destination does not exist. Generally should be yes only for small local files. prior to 0.6, acts if yes by default. (added in Ansible 0.7) - - + others -False +no all arguments accepted by the file module also work here - -

                                          Example from Ansible Playbooks

                                          -

                                          -get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440

                                          - -
                                          +

                                          Example from Ansible Playbooks

                                          +get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440
+

                                          +

                                          Notes

                                          +

                                          This module doesn't yet support configuration for proxies or passwords.

                                          git

                                          -

                                          Deploys software (or files) from git checkouts.

                                          - ------ - - +

                                          +New in version 0.0.1.

                                          +

                                          Manage git checkouts of repositories to deploy files or software.

                                          +
                                          parameter
                                          + + + - - - + + - - + + + - + + - - + + + - + + - + + - + + + + + + + + + - + + - - - - - - -
                                          parameter required defaultchoices comments
                                          repo
                                          repo yes git, ssh, or http protocol address of the git repo
                                            		git, ssh, or http protocol address of the git repository.
                                            dest
                                            dest yes absolute path of where the repo should be checked out to
                                              		Absolute path of where the repository should be checked out to.
                                              version
                                              version no HEADwhat version to check out – either the git SHA, the literal string -‘HEAD’, branch name, or a tag name.
                                                		What version of the repository to check out. This can be the git SHA, the literal string HEAD, branch name, or a tag name.
                                                remote
                                                forcenoyes
                                                • True
                                                • False
                                                		(New in 0.7) If yes, any modified files in the working repository will be discarded. Prior to 0.7, this was always 'yes' and could not be disabled.
                                                remote no originname of the remote branch
                                                  		Name of the remote branch.
                                                  forcenoyes(new in 0.7) If yes, any modified files in the working repository will be -discarded. Prior to 0.7, this was always ‘yes’ and could not be disabled.
                                                  -

                                                  Example action from Ansible Playbooks:

                                                  -
                                                  git repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22
                                                  -
                                                  -
                                                  +

                                                  Example git checkout from Ansible Playbooks

                                                  +git repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22
+

                                                  +

                                                  group

                                                  -

                                                  Adds or removes groups.

                                                  - ------ - - +

                                                  +New in version 0.0.2.

                                                  +

                                                  Manage presence of groups on a host.

                                                  +
                                                  parameter
                                                  + + + - - - - - - - - - - - - - - - - - - - + + - + + + - -
                                                  parameter required defaultchoices comments
                                                  nameyes name of the group
                                                  gid  optional git to set for the group
                                                  state present‘absent’ or ‘present’
                                                  system 
                                                  state noif ‘yes’, indicates that the group being created is a system group.present
                                                  • present
                                                  • absent
                                                  		Whether the group should be present or not on the remote host.
                                                  -

                                                  To control members of the group, see the users resource.

                                                  -

                                                  Example action from Ansible Playbooks:

                                                  -
                                                  group name=somegroup state=present
                                                  -
                                                  -
                                                  + +gid +no + + +Optional GID to set for the group. + + +name +yes + + +Name of the group to manage. + + +system +no +no + +If yes, indicates that the group created is a system group. + +

                                                  Example group command from Ansible Playbooks

                                                  +group name=somegroup state=present
+

                                                  +

                                                  ini_file

                                                  @@ -893,56 +925,61 @@ discarded. Prior to 0.7, this was always ‘yes’ and could not be dis choices comments - - + option -False -None +no +

                                                  if set (required for changing a value), this is the name of the option.May be omitted if adding/removing a whole section. - - + others -False +no all arguments accepted by the file module also work here - - + dest -True -None +yes + Path to the INI-style file; this file is created if required - - + section -True -None +yes + Section name in INI file. This is added if state=present automatically when a single value is being set. - - + backup -False -False +no + Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. - - + value -False -None +no + the string value to be associated with an option. May be omitted when removing an option. +

                                                  Ensure fav=lemonade is in section [drinks] in said file

                                                  +ini_file dest=/etc/conf section=drinks option=fav value=lemonade mode=0600 backup=true
+

                                                  + 

                                                  +ini_file dest=/etc/anotherconf
+     section=drinks
+     option=temperature
+     value=cold
+     backup=true
 
-
                                                  +

                                                  +

                                                  Notes

                                                  +

                                                  While it is possible to add an option without specifying a value, this makes no sense.

                                                  lineinfile

                                                  @@ -957,1266 +994,1143 @@ This is primarily useful when you want to change a single line in a file only. F choices comments - - + state -False +no present

                                                  Whether the line should be there or not. - - + name -True +yes The file to modify - - + insertafter -False +no EOF -Used with state=present. If specified, the line will be inserted after the specified regular expression. Two special values are available; BOF for inserting the line at the beginning of the file, and EOF for inserting the line at the end of the file. +Used with state=present. If specified, the line will be inserted after the specified regular expression. Two special values are available; BOF for inserting the line at the beginning of the file, and EOF for inserting the line at the end of the file. - - + regexp -True +yes -The regular expression to look for in the file. For state=present, the pattern to replace. For state=absent, the pattern of the line to remove. +The regular expression to look for in the file. For state=present, the pattern to replace. For state=absent, the pattern of the line to remove. - - + line -False +no -Required for state=present. The line to insert/replace into the file. Must match the value given to regexp. +Required for state=present. The line to insert/replace into the file. Must match the value given to regexp. - - + backup -False -False +no + Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. - -

                                                  -

                                                  -lineinfile name=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled

                                                  - -

                                                  -

                                                  -lineinfile name=/etc/sudoers state=absent regexp="^%wheel"

                                                  - + 

                                                  +lineinfile name=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled
+

                                                  + 

                                                  +lineinfile name=/etc/sudoers state=absent regexp="^%wheel"
+


                                                  mount

                                                  New in version 0.6.

                                                  -

                                                  The mount module controls active and configured mount points (fstab).

                                                  - ------ - - +

                                                  This module controls active and configured mount points in /etc/fstab.

                                                  +
                                                  parameter
                                                  + + + - - - + + - - + + + - + + - - + + + - + + - + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + + + - -
                                                  parameter required defaultchoices comments
                                                  name
                                                  src yes path to the mountpoint, ex: /mnt/foo
                                                    		device to be mounted on name.
                                                    src
                                                    state yes device to be mounted
                                                    • present
                                                    • absent
                                                    • mounted
                                                    • unmounted
                                                    		If mounted or unmounted, the device will be actively mounted or unmounted as well as just configured in fstab. absent and present only deal with fstab.
                                                    fstype
                                                    name yes 
                                                      		path to the mount point, eg: /mnt/files
                                                      dumpno
                                                        		dump (see fstab(8))
                                                        passnono
                                                          		passno (see fstab(8))
                                                          optsno
                                                            		mount options (see fstab(8))
                                                            fstype
                                                            optsno mount options (see fstab docs)
                                                            dumpno dump (see fstab docs)
                                                            passnono passno (see fstab docs)
                                                            state yes ‘present’, ‘absent’, ‘mounted’, or ‘unmounted’. If mounted/unmounted, -the device will be actively mounted or unmounted as well as just -configured in fstab. ‘absent’, and ‘present’ only deal with fstab.
                                                              		file-system type
                                                              -
                                                              +

                                                              Mount DVD read-only

                                                              +mount name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro
+

                                                              +

                                                              mysql_db

                                                              New in version 0.6.

                                                              Add or remove MySQL databases from a remote host.

                                                              -

                                                              Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as -apt-get install python-mysqldb.

                                                              - ------ - - +
                                                              parameter
                                                              + + + - - - - - - - - - - - - - - - - - - - - - - - + + - + + - + + + + + + + + + - - + + + - + + - - + + + - -
                                                              parameter required defaultchoices comments
                                                              nameyes name of the database to add or remove
                                                              login_userno user name used to authenticate with
                                                              login_passwordno password used to authenticate with
                                                              login_hostnolocalhosthost running the database
                                                              state
                                                              state no present‘absent’ or ‘present’
                                                              • present
                                                              • absent
                                                              		The database state
                                                              collation
                                                              nameyes
                                                                		name of the database to add or remove
                                                                encoding no collation mode
                                                                  		Encoding mode
                                                                  encoding
                                                                  collation no encoding mode
                                                                    		Collation mode
                                                                    -

                                                                    Both ‘login_password’ and ‘login_username’ are required when you are passing credentials. -If none are present, the module will attempt to read the credentials from ~/.my.cnf, and -finally fall back to using the MySQL default login of ‘root’ with no password.

                                                                    -

                                                                    Example action from Ansible Playbooks:

                                                                    -
                                                                    - name: Create database
-  action: mysql_db db=bobdata state=present
                                                                    -
                                                                    -
                                                                    + +login_user +no + + +The username used to authenticate with + + +login_host +no +localhost + +Host running the database + + +login_password +no + + +The password used to authenticate with + +

                                                                    Create a new database with name 'bobdata'

                                                                    +mysql_db db=bobdata state=present
+

                                                                    +

                                                                    Notes

                                                                    +

                                                                    Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as apt-get install python-mysqldb.

                                                                    +

                                                                    Both login_password and login_username are required when you are passing credentials. If none are present, the module will attempt to read the credentials from ~/.my.cnf, and finally fall back to using the MySQL default login of 'root' with no password.

                                                                    mysql_user

                                                                    New in version 0.6.

                                                                    Adds or removes a user from a MySQL database.

                                                                    -

                                                                    Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as -apt-get install python-mysqldb.

                                                                    - ------ - - +
                                                                    parameter
                                                                    + + + - - - + + - + + - + + - - + + + - + + - + + - - - - - - - - - - - + + - + + - - - - - - + + - + + - -
                                                                    parameter required defaultchoices comments
                                                                    name
                                                                    name yes 
                                                                      		 name of the user (role) to add or remove
                                                                      password
                                                                      login_user no set the user’s password
                                                                        		The username used to authenticate with
                                                                        host
                                                                        login_host no localhostthe ‘host’ part of the MySQL username
                                                                          		Host running the database
                                                                          login_userno user name used to authenticate with
                                                                          login_passwordno password used to authenticate with
                                                                          login_host
                                                                          host no localhosthost running MySQL.
                                                                            		the 'host' part of the MySQL username
                                                                            privno MySQL privileges string in the format: db.table:priv1,priv2
                                                                            state
                                                                            state no present‘absent’ or ‘present’
                                                                            • present
                                                                            • absent
                                                                            		The database state
                                                                            -

                                                                            Both ‘login_password’ and ‘login_username’ are required when you are passing credentials. -If none are present, the module will attempt to read the credentials from ~/.my.cnf, and -finally fall back to using the MySQL default login of ‘root’ with no password.

                                                                            -

                                                                            Example privileges string format:

                                                                            -
                                                                            -
                                                                            mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL
                                                                            -

                                                                            Example action from Ansible Playbooks:

                                                                            -
                                                                            - name: Create database user
-  action: mysql_user name=bob password=12345 priv=*.*:ALL state=present
-
-- name: Ensure no user named 'sally' exists, also passing in the auth credentials.
-  action: mysql_user login_user=root login_password=123456 name=sally state=absent
                                                                            -
                                                                            -
                                                                            + +login_password +no + + +The password used to authenticate with + + +password +no + + +set the user's password + + +priv +no + + +MySQL privileges string in the format: db.table:priv1,priv2 + +

                                                                            Create database user with name 'bob' and password '12345' with all database privileges

                                                                            +mysql_user name=bob password=12345 priv=*.*:ALL state=present
+

                                                                            +

                                                                            Ensure no user named 'sally' exists, also passing in the auth credentials.

                                                                            +mysql_user login_user=root login_password=123456 name=sally state=absent
+

                                                                            +

                                                                            Example privileges string format

                                                                            +mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL
+

                                                                            +

                                                                            Notes

                                                                            +

                                                                            Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as apt-get install python-mysqldb.

                                                                            +

                                                                            Both login_password and login_username are required when you are passing credentials. If none are present, the module will attempt to read the credentials from ~/.my.cnf, and finally fall back to using the MySQL default login of 'root' with no password.

                                                                            nagios

                                                                            New in version 0.7.

                                                                            -

                                                                            Perform common tasks in Nagios related to downtime and notifications.

                                                                            -

                                                                            The Nagios module has two basic functions: scheduling downtime and -toggling alerts for services or hosts.

                                                                            -

                                                                            The following parameters are common to all actions in the nagios -module:

                                                                            - ------ - - +

                                                                            The nagios module has two basic functions: scheduling downtime and toggling alerts for services or hosts. +All actions require the host parameter to be given explicitly. In playbooks you can use the $inventory_hostname variable to refer to the host the playbook is currently running on. +You can specify multiple services at once by separating them with commas, .e.g., services=httpd,nfs,puppet. +When specifying what service to handle there is a special service value, host, which will handle alerts/downtime for the host itself, e.g., service=host. This keyword may not be given with other services at the same time. Setting alerts/downtime for a host does not affect alerts/downtime for any of the services running on it. +When using the nagios module you will need to specify your nagios server using the delegate_to parameter.

                                                                            +
                                                                            parameter
                                                                            + + + - - - + + - - + + + - + + - - + + + - - - - - - -
                                                                            parameter required defaultchoices comments
                                                                            action
                                                                            action yes one of: ‘downtime’, ‘enable_alerts’/’disable_alerts’, or -‘silence’/’unsilence’
                                                                            • downtime
                                                                            • enable_alerts
                                                                            • disable_alerts
                                                                            • silence
                                                                            • unsilence
                                                                            		Action to take.
                                                                            host
                                                                            host yes host to operate on in nagios
                                                                              		Host to operate on in Nagios.
                                                                              cmdfilenoauto-detectedpath to the nagios command file (FIFO pipe)
                                                                              -

                                                                              The following parameters may be used with the downtime action:

                                                                              - ------ - - - - - - - - - + + - + + - + + + + + + + + + - + + - - - - + + + + + + - -
                                                                              parameterrequireddefaultcomments
                                                                              author
                                                                              author no Ansibleauthor to leave downtime comments as
                                                                                		Author to leave downtime comments as. - Only useable with the downtime action.
                                                                                minutes
                                                                                servicesyes
                                                                                  		What to manage downtime/alerts for. Separate multiple services with commas.service is an alias for services.Required option when using the downtime, enable_alerts, and disable_alerts actions.
                                                                                  minutes no 30minutes to schedule downtime for
                                                                                    		Minutes to schedule downtime for.Only useable with the downtime action.
                                                                                    servicesyes what to manage downtime/alerts for. separate multiple services -with commas. -service is an alias for services
                                                                                    cmdfilenoauto-detected
                                                                                      		Path to the nagios command file (FIFO pipe).Only required if auto-detection fails.
                                                                                      -

                                                                                      The following parameter must be used with the enable_alerts and disable_alerts actions:

                                                                                      - ------ - - - - - - - - - - - - - - -
                                                                                      parameterrequireddefaultcomments
                                                                                      servicesyes what to manage downtime/alerts for. separate multiple services -with commas. -service is an alias for services
                                                                                      -
                                                                                      -

                                                                                      Note

                                                                                      -

                                                                                      The silence and unsilence actions have no additional -parameters that may be used with them.

                                                                                      -
                                                                                      -

                                                                                      All actions require the host parameter to be given explicitly. In -playbooks you can use the $inventory_hostname variable to refer to -the host the playbook is currently running on.

                                                                                      -

                                                                                      You can specify multiple services at once by separating them with -commas, .e.g., services=httpd,nfs,puppet.

                                                                                      -

                                                                                      When specifying what service to handle there is a special service value, -host, which will handle alerts/downtime for the host itself, -e.g., service=host. This keyword may not be given with other -services at the same time. Handling alerts/downtime for a host does -not affect alerts/downtime for any of the services running on it.

                                                                                      -

                                                                                      Examples from Playbooks:

                                                                                      -
                                                                                      ---
-- hosts: webservers
-  user: root
-  tasks:
-    - name: set 30 minutes of apache downtime
-      action: nagios action=downtime minutes=30 service=httpd host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    - name: schedule an hour of HOST downtime
-      action: nagios action=downtime minutes=60 service=host host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    # Use the default of 30 minutes
-    # Schedule downtime for three services at once
-    - name: schedule downtime for a few services
-      action: nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    - name: enable SMART disk alerts
-      action: nagios action=enable_alerts service=smart host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    # you can disable multiple at once
-    - name: disable httpd alerts
-      action: nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    # host alerts must be disabled as a seperate action
-    - name: disable HOST alerts
-      action: nagios action=disable_alerts service=host host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    - name: silence ALL alerts
-      action: nagios action=silence host=$inventory_hostname
-      delegate_to: nagios.example.com
-
-    - name: unsilence all alerts
-      action: nagios action=unsilence host=$inventory_hostname
-      delegate_to: nagios.example.com
                                                                                      -
                                                                                      -

                                                                                      Troubleshooting Tips

                                                                                      -

                                                                                      The nagios module may not operate for you out of the box. The most -likely problem is with your cmdfile permissions/paths. You will -receive this error if that is the case:

                                                                                      -
                                                                                      {"msg": "unable to write to nagios command file", "failed": true, "cmdfile": "/var/spool/nagios/cmd/nagios.cmd"}
-
                                                                                      -
                                                                                      -

                                                                                      Steps to correct this:

                                                                                      -
                                                                                        -
                                                                                      1. Ensure you are running the nagios module as a user who has -write permissions to the cmdfile.
                                                                                        2. -
                                                                                      2. Ensure you have cmdfile set correctly.
                                                                                        3. -
                                                                                      -
                                                                                      +

                                                                                      set 30 minutes of apache downtime

                                                                                      +nagios action=downtime minutes=30 service=httpd host=$inventory_hostname
+

                                                                                      +

                                                                                      schedule an hour of HOST downtime

                                                                                      +nagios action=downtime minutes=60 service=host host=$inventory_hostname
+

                                                                                      +

                                                                                      schedule downtime for a few services

                                                                                      +nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
+

                                                                                      +

                                                                                      enable SMART disk alerts

                                                                                      +nagios action=enable_alerts service=smart host=$inventory_hostname
+

                                                                                      +

                                                                                      two services at once: disable httpd and nfs alerts

                                                                                      +nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
+

                                                                                      +

                                                                                      disable HOST alerts

                                                                                      +nagios action=disable_alerts service=host host=$inventory_hostname
+

                                                                                      +

                                                                                      silence ALL alerts

                                                                                      +nagios action=silence host=$inventory_hostname
+

                                                                                      +

                                                                                      unsilence all alerts

                                                                                      +nagios action=unsilence host=$inventory_hostname
+

                                                                                      +

                                                                                      ohai

                                                                                      -

                                                                                      Similar to the facter module, this returns JSON inventory data. -Ohai data is a bit more verbose and nested than facter.

                                                                                      -

                                                                                      Requires that ‘ohai’ be installed on the remote end.

                                                                                      -

                                                                                      Playbooks should not call the ohai module, playbooks call the -setup module behind the scenes instead.

                                                                                      -

                                                                                      Example:

                                                                                      -
                                                                                      ansible foo.example.org -m ohai
                                                                                      -
                                                                                      -
                                                                                      +

                                                                                      +New in version 0.6.

                                                                                      +

                                                                                      Similar to the facter module, this runs the ohai discovery program (http://wiki.opscode.com/display/chef/Ohai) on the remote host and returns JSON inventory data. Ohai data is a bit more verbose and nested than facter.

                                                                                      +

                                                                                      Retrieve ohai data from all Web servers and store in one-file per host

                                                                                      +ansible webservers -m ohai --tree=/tmp/ohaidata
+

                                                                                      +

                                                                                      ping

                                                                                      -

                                                                                      A trivial test module, this module always returns ‘pong’ on -successful contact. It does not make sense in playbooks, but is useful -from /usr/bin/ansible:

                                                                                      -
                                                                                      ansible webservers -m ping
                                                                                      -
                                                                                      -
                                                                                      +

                                                                                      A trivial test module, this module always returns ‘pong’ on successful contact. It does not make sense in playbooks, but is useful from /usr/bin/ansible

                                                                                      +

                                                                                      Test 'webservers' status

                                                                                      +ansible webservers -m ping
+

                                                                                      +

                                                                                      pip

                                                                                      New in version 0.7.

                                                                                      -

                                                                                      Manages Python library dependencies.

                                                                                      - ------ - - +

                                                                                      Manage Python library dependencies.

                                                                                      +
                                                                                      parameter
                                                                                      + + + - - - + + - - - - - - - - - - - - - - - - + + - + + - + + - -
                                                                                      parameter required defaultchoices comments
                                                                                      name
                                                                                      virtualenv no The name of a Python library to install
                                                                                      versionno The version number to install of the Python library specified in the -‘name’ parameter
                                                                                      requirementsno The path to a pip requirements file
                                                                                      virtualenvno 
                                                                                        		 An optional path to a virtualenv directory to install into
                                                                                        state
                                                                                        state no present‘present’, ‘absent’ or ‘latest’
                                                                                        • present
                                                                                        • absent
                                                                                        • latest
                                                                                        		The state of module
                                                                                        -

                                                                                        Please note that virtualenv must be installed on -the remote host if the virtualenv parameter is specified.

                                                                                        -

                                                                                        Examples:

                                                                                        -
                                                                                        pip name=flask
+    
+version
+no
+
+
                                                                                          
+The version number to install of the Python library specified in the 'name' parameter
+
+    
+requirements
+no
+
+
                                                                                            
+The path to a pip requirements file
+
+    
+name
+yes
+
+
                                                                                              
+The name of a Python library to install
+
+    
                                                                                              Install flask python package.
                                                                                                  
                                                                                              +pip name=flask
+
                                                                                              
+
                                                                                              Install flask python package on version 0.8.
                                                                                                  
                                                                                               pip name=flask version=0.8
+
                                                                                              
+
                                                                                              Install Flask (http://flask.pocoo.org/) into the specified virtualenv
                                                                                                  
                                                                                               pip name=flask virtualenv=/srv/webapps/my_app/venv
+
                                                                                              
+
                                                                                              Install specified python requirements.
                                                                                                  
                                                                                               pip requirements=/srv/webapps/my_app/src/requirements.txt
-pip requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv
                                                                                              
-
                                                                                              -
                                                                                              +

                                                                                              +

                                                                                              Install specified python requirements in indicated virtualenv.

                                                                                              +pip requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv
+

                                                                                              +

                                                                                              Notes

                                                                                              +

                                                                                              Please note that http://www.virtualenv.org/, virtualenv must be installed on the remote host if the virtualenv parameter is specified.

                                                                                              -

                                                                                              postgresql_db

                                                                                              +

                                                                                              postgresql_db

                                                                                              New in version 0.6.

                                                                                              Add or remove PostgreSQL databases from a remote host.

                                                                                              -

                                                                                              The default authentication assumes that you are either logging in as or -sudo’ing to the postgres account on the host.

                                                                                              -

                                                                                              This module uses psycopg2, a Python PostgreSQL database adapter. You must -ensure that psycopg2 is installed on the host before using this module. If -the remote host is the PostgreSQL server (which is the default case), then -PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, -install the postgresql, libpq-dev, and python-psycopg2 packages on the remote -host before using this module.

                                                                                              - ------ - - +
                                                                                              parameter
                                                                                              + + + - - - + + + + + + + + + - + + - + + - - + + + - + + - - + + + - + + - - + + + - + + - - + + + - - - - - - -
                                                                                              parameter required defaultchoices comments
                                                                                              name
                                                                                              statenopresent
                                                                                              • present
                                                                                              • absent
                                                                                              		The database state
                                                                                              name yes 
                                                                                                		 name of the database to add or remove
                                                                                                login_user
                                                                                                login_password nopostgresuser (role) used to authenticate with PostgreSQL
                                                                                                  		The password used to authenticate with
                                                                                                  login_password
                                                                                                  owner no password used to authenticate with PostgreSQL
                                                                                                    		Name of the role to set as owner of the database
                                                                                                    login_host
                                                                                                    login_user no host running PostgreSQL. Default (blank) implies localhost
                                                                                                      		The username used to authenticate with
                                                                                                      owner
                                                                                                      login_host no name of the role to set as owner of the databaselocalhost
                                                                                                        		Host running the database
                                                                                                        state present‘absent’ or ‘present’
                                                                                                        -

                                                                                                        Example action from Ansible Playbooks:

                                                                                                        -
                                                                                                        postgresql_db db=acme
                                                                                                        -
                                                                                                        -
                                                                                                        +

                                                                                                        Create a new database with name 'acme'

                                                                                                        +postgresql_db db=acme
+

                                                                                                        +

                                                                                                        Notes

                                                                                                        +

                                                                                                        The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host.

                                                                                                        +

                                                                                                        This module uses psycopg2, a Python PostgreSQL database adapter. You must ensure that psycopg2 is installed on the host before using this module. If the remote host is the PostgreSQL server (which is the default case), then PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, install the postgresql, libpq-dev, and python-psycopg2 packages on the remote host before using this module.

                                                                                                        -

                                                                                                        postgresql_user

                                                                                                        +

                                                                                                        postgresql_user

                                                                                                        New in version 0.6.

                                                                                                        -

                                                                                                        Add or remove PostgreSQL users (roles) from a remote host and, optionally, grant the users -access to an existing database or tables.

                                                                                                        -

                                                                                                        The default authentication assumes that you are either logging in as or -sudo’ing to the postgres account on the host.

                                                                                                        -

                                                                                                        This module uses psycopg2, a Python PostgreSQL database adapter. You must -ensure that psycopg2 is installed on the host before using this module. If -the remote host is the PostgreSQL server (which is the default case), then -PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, -install the postgresql, libpq-dev, and python-psycopg2 packages on the remote -host before using this module.

                                                                                                        - ------ - - +

                                                                                                        Add or remove PostgreSQL users (roles) from a remote host and, optionally, grant the users access to an existing database or tables. +The fundamental function of the module is to create, or delete, roles from a PostgreSQL cluster. Privilege assignment, or removal, is an optional step, which works on one database at a time. This allows for the module to be called several times in the same module to modify the permissions on different databases, or to grant permissions to already existing users. +A user cannot be removed untill all the privileges have been stripped from the user. In such situation, if the module tries to remove the user it will fail. To avoid this from happening the fail_on_user option signals the module to try to remove the user, but if not possible keep going; the module will report if changes happened and separately if the user was removed or not.

                                                                                                        +
                                                                                                        parameter
                                                                                                        + + + - - - + + - + + - - - - - - - - - - - - - - - - - - - - - + + - + + - + + - - + + + - + + - - + + + - - + + + - + + - -
                                                                                                        parameter required defaultchoices comments
                                                                                                        name
                                                                                                        name yes 
                                                                                                          		 name of the user (role) to add or remove
                                                                                                          passwordyes set the user’s password
                                                                                                          dbno name of database where permissions will be granted
                                                                                                          privno PostgreSQL privileges string in the format: table:priv1,priv2
                                                                                                          fail_on_usernoyesif yes, fail when user can’t be removed. Otherwise just log and continue
                                                                                                          login_user
                                                                                                          login_user no postgresuser (role) used to authenticate with PostgreSQL
                                                                                                            		User (role) used to authenticate with PostgreSQL
                                                                                                            login_password
                                                                                                            login_host no password used to authenticate with PostgreSQLlocalhost
                                                                                                              		Host running PostgreSQL.
                                                                                                              login_host
                                                                                                              db no host running PostgreSQL. Default (blank) implies localhost
                                                                                                                		name of database where permissions will be granted
                                                                                                                state 
                                                                                                                stateno present‘absent’ or ‘present’
                                                                                                                • present
                                                                                                                • absent
                                                                                                                		The database state
                                                                                                                -

                                                                                                                The fundamental function of the module is to create, or delete, roles from a PostgreSQL cluster. -Privilege assignment, or removal, is an optional step, which works on one database at a time. -This allows for the module to be called several times in the same module to modify the permissions on -different databases, or to grant permissions to already existing users.

                                                                                                                -

                                                                                                                A user cannot be removed untill all the privileges have been stripped from the user. In such situation, -if the module tries to remove the user it will fail. To avoid this from happening the fail_on_user option -signals the module to try to remove the user, but if not possible keep going; the module will report if changes -happened and separately if the user was removed or not.

                                                                                                                -

                                                                                                                Example privileges string format:

                                                                                                                -
                                                                                                                -
                                                                                                                INSERT,UPDATE/table:SELECT/anothertable:ALL
                                                                                                                -

                                                                                                                Example action from Ansible Playbooks:

                                                                                                                -
                                                                                                                - name: Create django user and grant access to database and products table
-  postgresql_user db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL
-
-- name: Remove test user privileges from acme
-  postgresql_user db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no
-- name: Remove test user from test database and the cluster
-  postgresql_user db=test user=test priv=ALL state=absent
                                                                                                                -
                                                                                                                -
                                                                                                                + +login_password +no + + +Password used to authenticate with PostgreSQL + + +password +yes + + +set the user's password + + +fail_on_user +no +True + +if yes, fail when user can't be removed. Otherwise just log and continue + + +priv +no + + +PostgreSQL privileges string in the format: table:priv1,priv2 + +

                                                                                                                Create django user and grant access to database and products table

                                                                                                                +postgresql_user db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL
+

                                                                                                                +

                                                                                                                Remove test user privileges from acme

                                                                                                                +postgresql_user db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no
+

                                                                                                                +

                                                                                                                Remove test user from test database and the cluster

                                                                                                                +postgresql_user db=test user=test priv=ALL state=absent
+

                                                                                                                +

                                                                                                                Example privileges string format

                                                                                                                +INSERT,UPDATE/table:SELECT/anothertable:ALL
+

                                                                                                                +

                                                                                                                Notes

                                                                                                                +

                                                                                                                The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host.

                                                                                                                +

                                                                                                                This module uses psycopg2, a Python PostgreSQL database adapter. You must ensure that psycopg2 is installed on the host before using this module. If the remote host is the PostgreSQL server (which is the default case), then PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, install the postgresql, libpq-dev, and python-psycopg2 packages on the remote host before using this module.

                                                                                                                -

                                                                                                                raw

                                                                                                                +

                                                                                                                raw

                                                                                                                Executes a low-down and dirty SSH command, not going through the module subsystem. This is useful and should only be done in two cases. The first case is installing python-simplejson on older (Python 2.4 and before) hosts that need it as a dependency to run modules, since nearly all core modules require it. Another is speaking to any devices such as routers that do not have any Python installed. In any other case, using the shell or command module is much more appropriate. Arguments given to raw are run directly through the configured remote shell and only output is returned. There is no error detection or change handler support for this module

                                                                                                                -

                                                                                                                Example from /usr/bin/ansible to bootstrap a legacy python 2.4 host

                                                                                                                -

                                                                                                                -ansible newhost.example.com -m raw -a "yum -y install python-simplejson"

                                                                                                                - +

                                                                                                                Example from /usr/bin/ansible to bootstrap a legacy python 2.4 host

                                                                                                                +ansible newhost.example.com -m raw -a "yum -y install python-simplejson"
+


                                                                                                                -

                                                                                                                service

                                                                                                                -

                                                                                                                Controls services on remote machines.

                                                                                                                - ------ - - +

                                                                                                                service

                                                                                                                +

                                                                                                                +New in version 0.1.

                                                                                                                +

                                                                                                                Controls services on remote hosts.

                                                                                                                +
                                                                                                                parameter
                                                                                                                + + + - - - + + + + + + + + + + + + + + + + + + + + + + + - - + + + - - - - - - - - - - - - - - - - -
                                                                                                                parameter required defaultchoices comments
                                                                                                                name
                                                                                                                patternno
                                                                                                                  		If the service does not respond to the status command, name a substring to look for as would be found in the output of the ps command as a stand-in for a status result. If the string is found, the servie will be assumed to be running. (added in Ansible 0.7)
                                                                                                                  stateno
                                                                                                                  • running
                                                                                                                  • started
                                                                                                                  • stopped
                                                                                                                  • restarted
                                                                                                                  • reloaded
                                                                                                                  		started, stopped, reloaded, restarted. Started/stopped are idempotent actions that will not run commands unless necessary. restarted will always bounce the service. reloaded will always reload.
                                                                                                                  enabledno
                                                                                                                  • yes
                                                                                                                  • no
                                                                                                                  		Whether the service should start on boot.
                                                                                                                  name yes name of the service
                                                                                                                    		Name of the service.
                                                                                                                    statenostarted‘started’, ‘stopped’, ‘reloaded’, or ‘restarted’. Started/stopped are -idempotent actions that will not run commands unless neccessary. -‘restarted’ will always bounce the service, ‘reloaded’ will always reload.
                                                                                                                    patternno (new in 0.7) if the service does not respond to the status command, -name a substring to look for as would be found in the output of the ‘ps’ -command as a stand-in for a status result. If the string is found, the -service will be assumed to be running.
                                                                                                                    enabledno Whether the service should start on boot. Either ‘yes’ or ‘no’.
                                                                                                                    -

                                                                                                                    Example actions from Ansible Playbooks:

                                                                                                                    -
                                                                                                                    service name=httpd state=started
+    
                                                                                                                    Example action from Ansible Playbooks
                                                                                                                        
                                                                                                                    +service name=httpd state=started
+
                                                                                                                    
+
                                                                                                                    Example action from Ansible Playbooks
                                                                                                                        
                                                                                                                     service name=httpd state=stopped
+
                                                                                                                    
+
                                                                                                                    Example action from Ansible Playbooks
                                                                                                                        
                                                                                                                     service name=httpd state=restarted
+
                                                                                                                    
+
                                                                                                                    Example action from Ansible Playbooks
                                                                                                                        
                                                                                                                     service name=httpd state=reloaded
-service name=foo pattern=/usr/bin/foo state=started
                                                                                                                    
-
                                                                                                                    -
                                                                                                                    +

                                                                                                                    +

                                                                                                                    Example action from Ansible Playbooks

                                                                                                                    +service name=foo pattern=/usr/bin/foo state=started
+

                                                                                                                    +
                                                                                                                    -

                                                                                                                    seboolean

                                                                                                                    +

                                                                                                                    seboolean

                                                                                                                    New in version 0.7.

                                                                                                                    Toggles SELinux booleans.

                                                                                                                    - ------ - - +
                                                                                                                    parameter
                                                                                                                    + + + - - - + + - - + + + - - - - - - + + - - + + + - -
                                                                                                                    parameter required defaultchoices comments
                                                                                                                    name
                                                                                                                    state yes name of the boolean to configure
                                                                                                                    • true
                                                                                                                    • false
                                                                                                                    		Desired boolean value
                                                                                                                    persistentnonoset to ‘yes’ if the boolean setting should survive a reboot
                                                                                                                    state
                                                                                                                    name yes desired boolean value. ‘true’ or ‘false’.
                                                                                                                      		Name of the boolean to configure
                                                                                                                      -

                                                                                                                      Example from Ansible Playbooks:

                                                                                                                      -
                                                                                                                      seboolean name=httpd_can_network_connect state=true persistent=yes
                                                                                                                      -
                                                                                                                      -
                                                                                                                      + +persistent +no + + +Set to 'yes' if the boolean setting should survive a reboot + +

                                                                                                                      Set httpd_can_network_connect SELinux flag to true and persistent

                                                                                                                      +seboolean name=httpd_can_network_connect state=true persistent=yes
+

                                                                                                                      +

                                                                                                                      Notes

                                                                                                                      +

                                                                                                                      Not tested on any debian based system

                                                                                                                      -

                                                                                                                      selinux

                                                                                                                      +

                                                                                                                      selinux

                                                                                                                      New in version 0.7.

                                                                                                                      -

                                                                                                                      Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but -will let you know when it is required.

                                                                                                                      - ------ - - +

                                                                                                                      Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but will let you know when it is required.

                                                                                                                      +
                                                                                                                      parameter
                                                                                                                      + + + - - - + + - - + + + - + + - - + + + - + + + - -
                                                                                                                      parameter required defaultchoices comments
                                                                                                                      policy
                                                                                                                      policy yes name of the SELinux policy to use (example: ‘targeted’)
                                                                                                                        		name of the SELinux policy to use (example: 'targeted')
                                                                                                                        state
                                                                                                                        state yes the SELinux mode. ‘enforcing’, ‘permissive’, or ‘disabled’
                                                                                                                        • enforcing
                                                                                                                        • permissive
                                                                                                                        • disabled
                                                                                                                        		The SELinux mode
                                                                                                                        conf
                                                                                                                        conf no /etc/selinux/config
                                                                                                                          		 path to the SELinux configuration file, if non-standard
                                                                                                                          -

                                                                                                                          Example from Ansible Playbooks:

                                                                                                                          -
                                                                                                                          selinux policy=targeted state=enforcing
-selinux policy=targeted state=disabled
                                                                                                                          -
                                                                                                                          -
                                                                                                                          + 

                                                                                                                          +selinux policy=targeted state=enforcing
+

                                                                                                                          + 

                                                                                                                          +selinux policy=targeted state=disabled
+

                                                                                                                          +

                                                                                                                          Notes

                                                                                                                          +

                                                                                                                          Not tested on any debian based system

                                                                                                                          -

                                                                                                                          setup

                                                                                                                          +

                                                                                                                          setup

                                                                                                                          This module is automatically called by playbooks to gather useful variables about remote hosts that can be used in playbooks. It can also be executed directly by /usr/bin/ansible to check what variables are available to a host. Ansible provides many facts about the system, automatically.

                                                                                                                          -

                                                                                                                          Obtain facts from all hosts and store them indexed by hostname at /tmp/facts.

                                                                                                                          -

                                                                                                                          -ansible all -m setup -tree /tmp/facts

                                                                                                                          - -
                                                                                                                          +

                                                                                                                          Obtain facts from all hosts and store them indexed by hostname at /tmp/facts.

                                                                                                                          +ansible all -m setup -tree /tmp/facts
+

                                                                                                                          +

                                                                                                                          Notes

                                                                                                                          +

                                                                                                                          More ansible facts will be added with successive releases. If facter or ohai are installed, variables from these programs will also be snapshotted into the JSON file for usage in templating. These variables are prefixed with facter_ and ohai_ so it's easy to tell their source. All variables are bubbled up to the caller. Using the ansible facts and choosing to not install facter and ohai means you can avoid Ruby-dependencies on your remote systems.

                                                                                                                          -

                                                                                                                          shell

                                                                                                                          -

                                                                                                                          The shell module takes the command name followed by a list of -arguments, space delimited. It is almost exactly like the command module -but runs the command through the user’s configured shell on the remote node.

                                                                                                                          - ------ - - +

                                                                                                                          shell

                                                                                                                          +

                                                                                                                          +New in version 0.2.

                                                                                                                          +

                                                                                                                          The shell module takes the command name followed by a list of arguments, space delimited. It is almost exactly like the command module but runs the command through the user’s configured shell on the remote node.

                                                                                                                          +
                                                                                                                          parameter
                                                                                                                          + + + - - - - - - - - + + - + + - + + - + + - -
                                                                                                                          parameter required defaultchoices comments
                                                                                                                          (free form)N/AN/Athe command module takes a free form command to run
                                                                                                                          creates
                                                                                                                          creates no 
                                                                                                                            		 a filename, when it already exists, this step will NOT be run
                                                                                                                            chdir
                                                                                                                            chdir no 
                                                                                                                              		 cd into this directory before running the command (0.6 and later)
                                                                                                                              -

                                                                                                                              The given command will be executed on all selected nodes.

                                                                                                                              -
                                                                                                                              -

                                                                                                                              Note

                                                                                                                              -

                                                                                                                              If you want to execute a command securely and predicably, it may be -better to use the ‘command’ module instead. Best practices when -writing playbooks will follow the trend of using ‘command’ unless -‘shell’ is explicitly required. When running ad-hoc commands, use -your best judgement.

                                                                                                                              -
                                                                                                                              -

                                                                                                                              Example action from a playbook:

                                                                                                                              -
                                                                                                                              shell somescript.sh >> somelog.txt
                                                                                                                              -
                                                                                                                              -
                                                                                                                              + +(free form) +no + + +The command module takes a free form command to run + +

                                                                                                                              Execute the command in remote shell

                                                                                                                              +shell somescript.sh >> somelog.txt
+

                                                                                                                              +

                                                                                                                              Notes

                                                                                                                              +

                                                                                                                              If you want to execute a command securely and predicably, it may be better to use the command module instead. Best practices when writing playbooks will follow the trend of using command unless shell is explicitly required. When running ad-hoc commands, use your best judgement.

                                                                                                                              -

                                                                                                                              subversion

                                                                                                                              +

                                                                                                                              subversion

                                                                                                                              New in version 0.7.

                                                                                                                              -

                                                                                                                              Deploys a subversion repository.

                                                                                                                              - ------ - - +

                                                                                                                              This module is really simple, so for now this checks out from the given branch of a repo at a particular SHA or tag. Latest is not supported, you should not be doing that.

                                                                                                                              +
                                                                                                                              parameter
                                                                                                                              + + + - - - + + - + + - + + - + + - + + - - + + + - -
                                                                                                                              parameter required defaultchoices comments
                                                                                                                              repo
                                                                                                                              repo yes 
                                                                                                                                		 The subversion URL to the repository.
                                                                                                                                dest
                                                                                                                                dest yes 
                                                                                                                                  		 Absolute path where the repository should be deployed.
                                                                                                                                  force
                                                                                                                                  force noyesIf yes, any modified files in the working repository will be -discarded. If no, this module will fail if it encounters modified files.True
                                                                                                                                  • yes
                                                                                                                                  • no
                                                                                                                                  		If yes, any modified files in the working repository will be discarded. If no, this module will fail if it encounters modified files.
                                                                                                                                  -

                                                                                                                                  Example action from Ansible Playbooks:

                                                                                                                                  -
                                                                                                                                  subversion repo=svn+ssh://an.example.org/path/to/repo dest=/src/checkout
                                                                                                                                  -
                                                                                                                                  -
                                                                                                                                  +

                                                                                                                                  Export subversion repository in a specified folder

                                                                                                                                  +subversion repo=svn+ssh://an.example.org/path/to/repo dest=/src/checkout
+

                                                                                                                                  +

                                                                                                                                  Notes

                                                                                                                                  +

                                                                                                                                  Requires subversion and grep on the client.

                                                                                                                                  -

                                                                                                                                  supervisorctl

                                                                                                                                  +

                                                                                                                                  supervisorctl

                                                                                                                                  New in version 0.7.

                                                                                                                                  Manage the state of a program or group of programs running via Supervisord

                                                                                                                                  - ------ - - +
                                                                                                                                  parameter
                                                                                                                                  + + + - - - + + - + + + + + + + + + - - - - - - -
                                                                                                                                  parameter required defaultchoices comments
                                                                                                                                  name
                                                                                                                                  state yes 
                                                                                                                                  • started
                                                                                                                                  • stopped
                                                                                                                                  • restarted
                                                                                                                                  		The state of service
                                                                                                                                  nameyes
                                                                                                                                    		 The name of the supervisord program/process to manage
                                                                                                                                    stateyes ‘started’, ‘stopped’ or ‘restarted’
                                                                                                                                    -

                                                                                                                                    Example action from a playbook:

                                                                                                                                    -
                                                                                                                                    supervisorctl name=my_app state=started
                                                                                                                                    -
                                                                                                                                    -
                                                                                                                                    +

                                                                                                                                    Manage the state of program my_app to be in started state.

                                                                                                                                    +supervisorctl name=my_app state=started
+

                                                                                                                                    +
                                                                                                                                    -

                                                                                                                                    template

                                                                                                                                    -

                                                                                                                                    Templates a file out to a remote server.

                                                                                                                                    -

                                                                                                                                    Templates are processed by the -Jinja2 templating language - -documentation on the template formatting can be found in the -Template Designer Documentation

                                                                                                                                    - ------ - - +

                                                                                                                                    template

                                                                                                                                    +

                                                                                                                                    Templates are processed by the Jinja2 templating language (http://jinja.pocoo.org/docs/) - documentation on the template formatting can be found in the Template Designer Documentation (http://jinja.pocoo.org/docs/templates/).

                                                                                                                                    +
                                                                                                                                    parameter
                                                                                                                                    + + + - - - + + - - + + + - + + - - + + + - + + - + + - - - - + + + + + + - -
                                                                                                                                    parameter required defaultchoices comments
                                                                                                                                    src
                                                                                                                                    dest yes Path of a Jinja2 formatted template on the local server. This can be -a relative or absolute path.
                                                                                                                                      		Location to render the template to on the remote machine.
                                                                                                                                      dest
                                                                                                                                      src yes Location to render the template on the remote server
                                                                                                                                        		Path of a Jinja2 formatted template on the local server. This can be a relative or absolute path.
                                                                                                                                        backup
                                                                                                                                        backup no noCreate a backup file including the timestamp information so you can -get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                        • yes
                                                                                                                                        • no
                                                                                                                                        		Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                        OTHERS  This module also supports all of the arguments to the file module
                                                                                                                                        othersno
                                                                                                                                          		all arguments accepted by the file module also work here
                                                                                                                                          -

                                                                                                                                          Example action from a playbook:

                                                                                                                                          -
                                                                                                                                          template src=/srv/mytemplates/foo.j2 dest=/etc/foo.conf owner=foo group=foo mode=0644
                                                                                                                                          -
                                                                                                                                          -
                                                                                                                                          +

                                                                                                                                          Example from Ansible Playbooks

                                                                                                                                          +template src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644
+

                                                                                                                                          +

                                                                                                                                          Notes

                                                                                                                                          +

                                                                                                                                          Since Ansible version 0.9, templates are loaded with trim_blocks=True.

                                                                                                                                          -

                                                                                                                                          user

                                                                                                                                          -

                                                                                                                                          Creates user accounts, manipulates existing user accounts, and removes user accounts.

                                                                                                                                          - ------ - - +

                                                                                                                                          user

                                                                                                                                          +

                                                                                                                                          +New in version 0.2.

                                                                                                                                          +

                                                                                                                                          Manage user accounts and user attributes.

                                                                                                                                          +
                                                                                                                                          parameter
                                                                                                                                          + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + + + - - - - + + + + + + - - + + + + + + + + + - + + + - - - - + + + + + + - - - - + + + + + + - - + + + + + + + + + + - + + - - + + - + + + - - + + - + + + - - + + - + + + - -
                                                                                                                                          parameter required defaultchoices comments
                                                                                                                                          nameyes name of the user to create, remove, or edit
                                                                                                                                          comment  optionally sets the description of the user
                                                                                                                                          uid  optionally sets the uid of the user
                                                                                                                                          group  optionally sets the user’s primary group (takes a group name)
                                                                                                                                          groups  puts the user in this comma-delimited list of groups
                                                                                                                                          append 
                                                                                                                                          comment noif ‘yes’, will only add groups, not set them to just the list in ‘groups’
                                                                                                                                            		Optionally sets the description (aka GECOS) of user account.
                                                                                                                                            shell  optionally set the user’s shell
                                                                                                                                            shellno
                                                                                                                                              		Optionally set the user's shell.
                                                                                                                                              createhome 
                                                                                                                                              forcenono
                                                                                                                                              • True
                                                                                                                                              • False
                                                                                                                                              		When used with state=absent, behavior is as with userdel --force.
                                                                                                                                              name yesunless ‘no’, a home directory will be made for the user
                                                                                                                                                		Name of the user to create, remove or modify.
                                                                                                                                                home  sets where the user’s homedir should be, if not the default
                                                                                                                                                createhomenoyes
                                                                                                                                                • True
                                                                                                                                                • False
                                                                                                                                                		Unless set to no, a home directory will be made for the user when the account is created.
                                                                                                                                                password  optionally set the user’s password to this crypted value. See the user’s -example in the github examples directory for what this looks like in a -playbook
                                                                                                                                                systemnono
                                                                                                                                                • True
                                                                                                                                                • False
                                                                                                                                                		When creating an account, setting this to yes makes the user a system account. This setting cannot be changed on existing users.
                                                                                                                                                state 
                                                                                                                                                removenono
                                                                                                                                                • True
                                                                                                                                                • False
                                                                                                                                                		When used with state=absent, behavior is as with userdel --remove.
                                                                                                                                                stateno presentwhen ‘absent’, removes the user.
                                                                                                                                                • present
                                                                                                                                                • absent
                                                                                                                                                		Whether the account should exist. When absent, removes the user account.
                                                                                                                                                system 
                                                                                                                                                groups noonly when initially creating, setting this to ‘yes’ makes the user a -system account. This setting cannot be changed on existing users.
                                                                                                                                                  		Puts the user in this comma-delimited list of groups.
                                                                                                                                                  force 
                                                                                                                                                  home nowhen used with state=absent, behavior is as with userdel –force
                                                                                                                                                    		Optionally set the user's home directory.
                                                                                                                                                    remove 
                                                                                                                                                    group nowhen used with state=absent, behavior is as with userdel –remove
                                                                                                                                                      		Optionally sets the user's primary group (takes a group name).
                                                                                                                                                      -

                                                                                                                                                      Example action from Ansible Playbooks:

                                                                                                                                                      -
                                                                                                                                                      user name=mdehaan comment=awesome password=awWxVV.JvmdHw createhome=yes
-user name=mdehaan groups=wheel,skynet
-user name=mdehaan state=absent force=yes
                                                                                                                                                      -
                                                                                                                                                      -
                                                                                                                                                      + +password +no + + +Optionally set the user's password to this crypted value. See the user example in the github examples directory for what this looks like in a playbook. + + +append +no + + +If yes, will only add groups, not set them to just the list in groups. + + +uid +no + + +Optionally sets the UID of the user. + +
                                                                                                                                                      -

                                                                                                                                                      wait_for

                                                                                                                                                      +

                                                                                                                                                      wait_for

                                                                                                                                                      New in version 0.7.

                                                                                                                                                      -

                                                                                                                                                      Waits for a given port to become accessible (or inaccessible) on a local or remote server.

                                                                                                                                                      -

                                                                                                                                                      This is useful for when services are not immediately available after their init scripts return – which is true of certain -Java application servers. It is also useful when starting guests with the virt module and -needing to pause until they are ready.

                                                                                                                                                      - ------ - - +

                                                                                                                                                      This is useful for when services are not immediately available after their init scripts return - which is true of certain Java application servers. It is also useful when starting guests with the virt module and needing to pause until they are ready.

                                                                                                                                                      +
                                                                                                                                                      parameter
                                                                                                                                                      + + + - - - + + - - - - - - - - - - - + + - - - - + + + + + + - + + + + + + + + + + + + + + + + - + + - -
                                                                                                                                                      parameter required defaultchoices comments
                                                                                                                                                      host
                                                                                                                                                      delay no127.0.0.1hostname or IP to wait for
                                                                                                                                                      timeoutno300maximum number of seconds to wait
                                                                                                                                                      delayno0
                                                                                                                                                        		 number of seconds to wait before starting to poll
                                                                                                                                                        portyes port to poll for openness or closedness
                                                                                                                                                        hostno127.0.0.1
                                                                                                                                                          		hostname or IP address to wait for
                                                                                                                                                          state
                                                                                                                                                          portyes
                                                                                                                                                            		port number to poll
                                                                                                                                                            timeoutno300
                                                                                                                                                              		maximum number of seconds to wait for
                                                                                                                                                              state no startedeither ‘started’, or ‘stopped’ depending on whether the module should poll -for the port being open or closed.
                                                                                                                                                              • started
                                                                                                                                                              • stopped
                                                                                                                                                              		either started, or stopped depending on whether the module should poll for the port being open or closed.
                                                                                                                                                              -

                                                                                                                                                              Example from Ansible Playbooks:

                                                                                                                                                              -
                                                                                                                                                              wait_for port=8080 delay=10
                                                                                                                                                              -
                                                                                                                                                              -
                                                                                                                                                              +

                                                                                                                                                              Example from Ansible Playbooks

                                                                                                                                                              +wait_for port=8000 delay=10
+

                                                                                                                                                              +
                                                                                                                                                              -

                                                                                                                                                              virt

                                                                                                                                                              -

                                                                                                                                                              Manages virtual machines supported by libvirt. Requires that libvirt be installed -on the managed machine.

                                                                                                                                                              - ------ - - +

                                                                                                                                                              virt

                                                                                                                                                              +

                                                                                                                                                              +New in version 0.2.

                                                                                                                                                              +

                                                                                                                                                              Manages virtual machines supported by libvirt.

                                                                                                                                                              +
                                                                                                                                                              parameter
                                                                                                                                                              + + + - - - + + + + + + + + + + + + + + + + - + + - - - - - - - - - - - -
                                                                                                                                                              parameter required defaultchoices comments
                                                                                                                                                              name
                                                                                                                                                              statenono
                                                                                                                                                              • running
                                                                                                                                                              • shutdown
                                                                                                                                                              • destroyed
                                                                                                                                                              • undefined
                                                                                                                                                              		Note that there may be some lag for state requests like shutdown since these refer only to VM states. After starting a guest, it may not be immediately accessible.
                                                                                                                                                              commandno
                                                                                                                                                                		in addition to state management, various non-idempotent commands are available. See examples
                                                                                                                                                                name yes 
                                                                                                                                                                  		 name of the guest VM being managed
                                                                                                                                                                  state  ‘running’, ‘shutdown’, ‘destroyed’, or ‘undefined’. Note that there may -be some lag for state requests like ‘shutdown’ since these refer only to -VM states. After starting a guest, it may not be immediately accessible.
                                                                                                                                                                  command  in addition to state management, various non-idempotent commands are -available. See examples below.
                                                                                                                                                                  -

                                                                                                                                                                  Example action from Ansible Playbooks:

                                                                                                                                                                  -
                                                                                                                                                                  virt guest=alpha state=running
-virt guest=alpha state=shutdown
-virt guest=alpha state=destroyed
-virt guest=alpha state=undefined
                                                                                                                                                                  -
                                                                                                                                                                  -

                                                                                                                                                                  Example guest management commands from /usr/bin/ansible:

                                                                                                                                                                  -
                                                                                                                                                                  ansible host -m virt -a "guest=foo command=status"
-ansible host -m virt -a "guest=foo command=pause"
-ansible host -m virt -a "guest=foo command=unpause"
-ansible host -m virt -a "guest=foo command=get_xml"
-ansible host -m virt -a "guest=foo command=autostart"
                                                                                                                                                                  -
                                                                                                                                                                  -

                                                                                                                                                                  Example host (hypervisor) management commands from /usr/bin/ansible:

                                                                                                                                                                  -
                                                                                                                                                                  ansible host -m virt -a "command=freemem"
-ansible host -m virt -a "command=list_vms"
-ansible host -m virt -a "command=info"
-ansible host -m virt -a "command=nodeinfo"
-ansible host -m virt -a "command=virttype"
                                                                                                                                                                  -
                                                                                                                                                                  -
                                                                                                                                                                  +

                                                                                                                                                                  Example from Ansible Playbooks

                                                                                                                                                                  +virt guest=alpha state=running
+

                                                                                                                                                                  +

                                                                                                                                                                  Example guest management with /usr/bin/ansible

                                                                                                                                                                  +ansible host -m virt -a "guest=alpha command=status"
+

                                                                                                                                                                  +

                                                                                                                                                                  Notes

                                                                                                                                                                  +

                                                                                                                                                                  Other non-idempotent commands are: status, pause, unpause, get_xml, autostart, freemem, list_vms, info, nodeinfo, virttype

                                                                                                                                                                  -

                                                                                                                                                                  yum

                                                                                                                                                                  -

                                                                                                                                                                  Will install, upgrade, remove, and list packages with the yum package manager.

                                                                                                                                                                  - ------ - - +

                                                                                                                                                                  yum

                                                                                                                                                                  +

                                                                                                                                                                  Will install, upgrade, remove, and list packages with the yum package manager.

                                                                                                                                                                  +
                                                                                                                                                                  parameter
                                                                                                                                                                  + + + - - - - - - - - - + + + - + + - - - - + + + + + + - -
                                                                                                                                                                  parameter required defaultchoices comments
                                                                                                                                                                  nameyes package name, or package specifier with version, like ‘name-1.0’
                                                                                                                                                                  state 
                                                                                                                                                                  stateno present‘present’, ‘latest’, or ‘absent’.
                                                                                                                                                                  • present
                                                                                                                                                                  • latest
                                                                                                                                                                  • absent
                                                                                                                                                                  		whether to install (present, latest), or remove (absent) a package.
                                                                                                                                                                  list  various non-idempotent commands for usage with /usr/bin/ansible and not -playbooks. See examples below.
                                                                                                                                                                  listno
                                                                                                                                                                    		various non-idempotent commands for usage with /usr/bin/ansible and not playbooks. See examples.
                                                                                                                                                                    -

                                                                                                                                                                    Example action from Ansible Playbooks:

                                                                                                                                                                    -
                                                                                                                                                                    yum name=httpd state=latest
+    
+name
+yes
+
+
                                                                                                                                                                      
+package name, or package specifier with version, like name-1.0.
+
+        
                                                                                                                                                                      +yum name=httpd state=latest
+
                                                                                                                                                                      
+    
                                                                                                                                                                       yum name=httpd state=removed
-yum name=httpd state=installed
                                                                                                                                                                      
-
                                                                                                                                                                      -
                                                                                                                                                                      +

                                                                                                                                                                      + 

                                                                                                                                                                      +yum name=httpd state=installed
+

                                                                                                                                                                      +

                                                                                                                                                                      Additional Contrib Modules

                                                                                                                                                                      In addition to the following built-in modules, community modules are available at Ansible Resources.

                                                                                                                                                                      @@ -2254,7 +2168,7 @@ yum name=httpd state=installed

                                                                                                                                                                      © Copyright 2012 Michael DeHaan.
                                                                                                                                                                      - Last updated on Sep 28, 2012.
                                                                                                                                                                      + Last updated on Oct 03, 2012.

                                                                                                                                                                      diff --git a/patterns.html b/patterns.html index 424974c537..86312b2cce 100644 --- a/patterns.html +++ b/patterns.html @@ -223,9 +223,9 @@ but they are useful.

                                                                                                                                                                      after the hostname with a colon.

                                                                                                                                                                      four.example.com:5309
                                                                                                                                                                      -

                                                                                                                                                                      In 0.6 and later, if you have a lot of hosts following similar patterns you can do this:

                                                                                                                                                                      +

                                                                                                                                                                      In 0.6 and later, if you have a lot of hosts following similar patterns you can do this rather than listing each hostname:

                                                                                                                                                                      [webservers]
-www[01-50].example.com
+www[01:50].example.com

                                                                                                                                                                      Leading zeros can be included or removed, as desired, and the ranges are inclusive.

                                                                                                                                                                      @@ -386,7 +386,7 @@ Ansible 0.7. Ansible 0.6 includes a parameter + required + default + choices + comments + + + purge + no + no + + Will force purging of configuration files if the module state is set to absent. + + + state + no + present + + Indicates the desired package state + + + force + no + no + + If yes, force installs/removes. + + + pkg + yes + + + A package name or package specifier with version, like foo or foo=1.0 + + + update_cache + no + no + + Run the equivalent of apt-get update before the operation. Can be run as part of the package installation or as a seperate step + + + default_release + no + + + Corresponds to the -t option for apt and sets pin priorities + + + install_recommends + no + no + + Corresponds to the --no-install-recommends option for apt, default behavior works as apt's default behavior, no does not install recommended packages. Suggested packages are never installed. + + + +.. raw:: html + +

                                                                                                                                                                      Update repositories cache and install foo package

                                                                                                                                                                           apt pkg=foo update-cache=yes
+

                                                                                                                                                                      +

                                                                                                                                                                      Remove foo package

                                                                                                                                                                           apt pkg=foo state=removed
+

                                                                                                                                                                      +

                                                                                                                                                                      Install the the package foo

                                                                                                                                                                           apt pkg=foo state=installed
+

                                                                                                                                                                      +

                                                                                                                                                                      Install the version '1.00' of package foo

                                                                                                                                                                           apt pkg=foo=1.00 state=installed
+

                                                                                                                                                                      +

                                                                                                                                                                      Update the repository cache and update package ngnix to latest version using default release squeeze-backport

                                                                                                                                                                           apt pkg=nginx state=latest default-release=squeeze-backports update-cache=yes
+

                                                                                                                                                                      +

                                                                                                                                                                      Install latest version of openjdk-6-jdk ignoring install-recomands

                                                                                                                                                                           apt pkg=openjdk-6-jdk state=latest install-recommends=no
+

                                                                                                                                                                      +
                                                                                                                                                                      + diff --git a/rst/modules/apt_repository.rst b/rst/modules/apt_repository.rst index c28e91fbda..c615ee2cb9 100644 --- a/rst/modules/apt_repository.rst +++ b/rst/modules/apt_repository.rst @@ -1,21 +1,51 @@ .. _apt_repository: apt_repository -`````````````` +`````````````````````````````` .. versionadded:: 0.7 -Manages apt repositores +Manages apt repositores (such as for Debian/Ubuntu). -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| repo | yes | | The repository name/value | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | no | present | 'absent' or 'present' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                      repoyes
                                                                                                                                                                        		The repository name/value
                                                                                                                                                                        statenopresent
                                                                                                                                                                        • present
                                                                                                                                                                        • absent
                                                                                                                                                                        		The repository state
                                                                                                                                                                        - apt_repository repo=ppa:nginx/stable +.. raw:: html + +

                                                                                                                                                                        Add nginx stable repository from PPA

                                                                                                                                                                        +    apt_repository repo=ppa://nginx/stable
+

                                                                                                                                                                        +

                                                                                                                                                                        Add specified repository into sources.

                                                                                                                                                                             apt_repository repo='deb http://archive.canonical.com/ubuntu hardy partner'
+

                                                                                                                                                                        +
                                                                                                                                                                        + +.. raw:: html + +

                                                                                                                                                                        Notes

                                                                                                                                                                        +

                                                                                                                                                                        This module works on Debian and Ubuntu only and requires apt-add-repository be available on destination server. To ensure this package is available use the apt module and install the python-software-properties package before using this module.

                                                                                                                                                                        +

                                                                                                                                                                        A bug in apt-add-repository always adds deb and deb-src types for repositories (see the issue on Launchpad https://bugs.launchpad.net/ubuntu/+source/software-properties/+bug/987264), if a repo doesn't have source information (eg MongoDB repo from 10gen) the system will fail while updating repositories.

                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/assemble.rst b/rst/modules/assemble.rst index 5a77f3778e..d0d9f19541 100644 --- a/rst/modules/assemble.rst +++ b/rst/modules/assemble.rst @@ -1,31 +1,56 @@ .. _assemble: assemble -```````` +`````````````````````````````` .. versionadded:: 0.5 -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 -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". +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 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*. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| src | yes | | An already existing directory full of source files | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | A file to create using the concatenation of all of the source files | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| backup | no | no | Create a backup file including the timestamp information so you can | -| | | | get the original file back if you somehow clobbered it incorrectly. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| OTHERS | | | All arguments that the file module takes may also be used | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                        destyes
                                                                                                                                                                          		A file to create using the concatenation of all of the source files.
                                                                                                                                                                          srcyes
                                                                                                                                                                            		An already existing directory full of source files.
                                                                                                                                                                            backupnono
                                                                                                                                                                            • yes
                                                                                                                                                                            • no
                                                                                                                                                                            		Create a backup file (if yes), including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                                                            othersno
                                                                                                                                                                              		all arguments accepted by the file module also work here
                                                                                                                                                                              +.. raw:: html + +

                                                                                                                                                                              Example from Ansible Playbooks

                                                                                                                                                                                   assemble src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf
+

                                                                                                                                                                              +
                                                                                                                                                                              + diff --git a/rst/modules/async_status.rst b/rst/modules/async_status.rst new file mode 100644 index 0000000000..add0add229 --- /dev/null +++ b/rst/modules/async_status.rst @@ -0,0 +1,44 @@ +.. _async_status: + +async_status +`````````````````````````````` + +.. versionadded:: 0.5 + +This module gets the status of an asynchronous task. See: http://ansible.cc/docs/playbooks2.html#asynchronous-actions-and-polling + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                              parameterrequireddefaultchoicescomments
                                                                                                                                                                              jidyes
                                                                                                                                                                                		Job or task identifier
                                                                                                                                                                                modenostatus
                                                                                                                                                                                • status
                                                                                                                                                                                • cleanup
                                                                                                                                                                                		if status, obtain the status; if cleanup, clean up the async job cache located in ~/.ansible_async/ for the specified job jid.
                                                                                                                                                                                + +.. raw:: html + +
                                                                                                                                                                                + +.. raw:: html + +

                                                                                                                                                                                Notes

                                                                                                                                                                                +

                                                                                                                                                                                See http://ansible.cc/docs/playbooks2.html#asynchronous-actions-and-polling

                                                                                                                                                                                + \ No newline at end of file diff --git a/rst/modules/authorized_key.rst b/rst/modules/authorized_key.rst index cacd448245..fd60999cfe 100644 --- a/rst/modules/authorized_key.rst +++ b/rst/modules/authorized_key.rst @@ -1,22 +1,52 @@ .. _authorized_key: authorized_key -`````````````` +`````````````````````````````` .. versionadded:: 0.5 -Adds or removes an authorized key for a user from a remote host. +Adds or removes an SSH authorized key for a user from a remote host. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| user | yes | | Name of the user who should have access to the remote host | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| key | yes | | the SSH public key, as a string | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | no | present | whether the given key should or should not be in the file | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                parameterrequireddefaultchoicescomments
                                                                                                                                                                                statenopresent
                                                                                                                                                                                • present
                                                                                                                                                                                • absent
                                                                                                                                                                                		whether the given key should or should not be in the file
                                                                                                                                                                                useryes
                                                                                                                                                                                  		Name of the user who should have access to the remote host
                                                                                                                                                                                  keyyes
                                                                                                                                                                                    		the SSH public key, as a string
                                                                                                                                                                                    +.. raw:: html + +

                                                                                                                                                                                    Example from Ansible Playbooks

                                                                                                                                                                                         authorized_key user=charlie key="ssh-dss ASDF1234L+8BTwaRYr/rycsBF1D8e5pTxEsXHQs4iq+mZdyWqlW++L6pMiam1A8yweP+rKtgjK2httVS6GigVsuWWfOd7/sdWippefq74nppVUELHPKkaIOjJNN1zUHFoL/YMwAAAEBALnAsQN10TNGsRDe5arBsW8cTOjqLyYBcIqgPYTZW8zENErFxt7ij3fW3Jh/sCpnmy8rkS7FyK8ULX0PEy/2yDx8/5rXgMIICbRH/XaBy9Ud5bRBFVkEDu/r+rXP33wFPHjWjwvHAtfci1NRBAudQI/98DbcGQw5HmE89CjgZRo5ktkC5yu/8agEPocVjdHyZr7PaHfxZGUDGKtGRL2QzRYukCmWo1cZbMBHcI5FzImvTHS9/8B3SATjXMPgbfBuEeBwuBK5EjL+CtHY5bWs9kmYjmeo0KfUMH8hY4MAXDoKhQ7DhBPIrcjS5jPtoGxIREZjba67r6/P2XKXaCZH6Fc= charlie@example.org 2011-01-17"
+

                                                                                                                                                                                    +

                                                                                                                                                                                    Shorthand available in Ansible 0.8 and later

                                                                                                                                                                                    +    authorized_key user=charlie key=$FILE(/home/charlie/.ssh/id_rsa.pub)
+

                                                                                                                                                                                    +
                                                                                                                                                                                    + diff --git a/rst/modules/command.rst b/rst/modules/command.rst index 0f1556ae9f..95502a39a9 100644 --- a/rst/modules/command.rst +++ b/rst/modules/command.rst @@ -1,39 +1,64 @@ .. _command: - command -``````` +`````````````````````````````` -The command module takes the command name followed by a list of -arguments, space delimited. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| (free form) | N/A | N/A | the command module takes a free form command to run | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| creates | no | | a filename, when it already exists, this step will NOT be run | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| chdir | no | | cd into this directory before running the command (0.6 and later) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +The command module takes the command name followed by a list of space-delimited arguments. +The given command will be executed on all selected nodes. It will not be processed through the shell, so variables like ``$HOME`` and operations like ``"<"``, ``">"``, ``"|"``, and ``"&"`` will not work. As such, all paths to commands must be fully qualified -The given command will be executed on all selected nodes. It will not -be processed through the shell, so variables like "$HOME" and -operations like "<", ">", "|", and "&" will not work. As such, all -paths to commands must be fully qualified. +.. raw:: html -.. note:: - If you want to run a command through the shell (say you are using - '<', '>', '|', etc), you actually want the 'shell' module instead. - The 'command' module is much more secure as it's not affected by - the user's environment. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                    parameterrequireddefaultchoicescomments
                                                                                                                                                                                    createsno
                                                                                                                                                                                      		a filename, when it already exists, this step will not be run.
                                                                                                                                                                                      free_formyes
                                                                                                                                                                                        		the command module takes a free form command to run
                                                                                                                                                                                        chdirno
                                                                                                                                                                                          		cd into this directory before running the command (added in Ansible 0.6)
                                                                                                                                                                                          removesno
                                                                                                                                                                                            		a filename, when it does not exist, this step will not be run. (added in Ansible 0.8)
                                                                                                                                                                                            -Example action from Ansible :doc:`playbooks`:: +.. raw:: html +

                                                                                                                                                                                            Example from Ansible Playbooks

                                                                                                                                                                                                 command /sbin/shutdown -t now
-
-creates and chdir can be specified after the command.  For instance, if you only want to run a command if a certain file does not exist, you can do the following::
-
+

                                                                                                                                                                                            +

                                                                                                                                                                                            creates, removes, and chdir can be specified after the command. For instance, if you only want to run a command if a certain file does not exist, use this.

                                                                                                                                                                                                 command /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
+

                                                                                                                                                                                            +
                                                                                                                                                                                            -The `creates=` and `chdir` options will not be passed to the actual executable. +.. raw:: html + +

                                                                                                                                                                                            Notes

                                                                                                                                                                                            +

                                                                                                                                                                                            If you want to run a command through the shell (say you are using <, >, |, etc), you actually want the shell module instead. The command module is much more secure as it's not affected by the user's environment.

                                                                                                                                                                                            + \ No newline at end of file diff --git a/rst/modules/copy.rst b/rst/modules/copy.rst index 3b534d850e..ae23b8f6e5 100644 --- a/rst/modules/copy.rst +++ b/rst/modules/copy.rst @@ -1,30 +1,58 @@ .. _copy: copy -```` +`````````````````````````````` -The copy module moves a file on the local box to remote locations. In addition to the options -listed below, the arguments available to the `file` module can also be passed to the copy -module. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| src | yes | | Local path to a file to copy to the remote server, can be absolute or | -| | | | relative. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | Remote absolute path where the file should end up | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| backup | no | no | Create a backup file including the timestamp information so you can | -| | | | get the original file back if you somehow clobbered it incorrectly. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| OTHERS | | | All arguments the file module takes are also supported | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +The ``copy`` module copies a file on the local box to remote locations. -Example action from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                            parameterrequireddefaultchoicescomments
                                                                                                                                                                                            destyes
                                                                                                                                                                                              		Remote absolute path where the file should be copied to.
                                                                                                                                                                                              srcyes
                                                                                                                                                                                                		Local path to a file to copy to the remote server; can be absolute or relative.
                                                                                                                                                                                                backupnono
                                                                                                                                                                                                • yes
                                                                                                                                                                                                • no
                                                                                                                                                                                                		Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. (added in Ansible 0.7)
                                                                                                                                                                                                othersno
                                                                                                                                                                                                  		all arguments accepted by the file module also work here
                                                                                                                                                                                                  + +.. raw:: html + +

                                                                                                                                                                                                  Example from Ansible Playbooks

                                                                                                                                                                                                       copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644
+

                                                                                                                                                                                                  +

                                                                                                                                                                                                  Copy a new ntp.conf file into place, backing up the original if it differs from the copied version

                                                                                                                                                                                                  +    copy src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes
+

                                                                                                                                                                                                  +
                                                                                                                                                                                                  -Copy a new ntp.conf file into place, backing up the original if it differs from the copied version:: - - copy src=/srv/myfiles/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes diff --git a/rst/modules/easy_install.rst b/rst/modules/easy_install.rst index a3eb4a3f92..40b73fa0ad 100644 --- a/rst/modules/easy_install.rst +++ b/rst/modules/easy_install.rst @@ -1,30 +1,51 @@ .. _easy_install: easy_install -```````````` +`````````````````````````````` .. versionadded:: 0.7 -The easy_install module installs Python libraries. +Installs Python libraries, optionally in a *virtualenv* -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | a Python library name | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| virtualenv | no | | an optional virtualenv directory path to install into, if the virtualenv | -| | | | does not exist it is created automatically | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Please note that the easy_install command can only install Python libraries. -Thus this module is not able to remove libraries. It is generally recommended to -use the :ref:`pip` module which you can first install using easy_install. + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                  parameterrequireddefaultchoicescomments
                                                                                                                                                                                                  virtualenvno
                                                                                                                                                                                                    		an optional virtualenv directory path to install into. If the virtualenv does not exist, it is created automatically
                                                                                                                                                                                                    nameyes
                                                                                                                                                                                                      		A Python library name
                                                                                                                                                                                                      -Also note that `virtualenv `_ must be installed on -the remote host if the `virtualenv` parameter is specified. - -Example action from Ansible :doc:`playbooks`:: +.. raw:: html +

                                                                                                                                                                                                      Examples from Ansible Playbooks

                                                                                                                                                                                                           easy_install name=pip
-    easy_install name=flask==0.8
-    easy_install name=flask virtualenv=/srv/webapps/my_app/venv
+

                                                                                                                                                                                                      +

                                                                                                                                                                                                      Install Flask (http://flask.pocoo.org/) into the specified virtualenv

                                                                                                                                                                                                      +    easy_install name=flask virtualenv=/webapps/myapp/venv
+

                                                                                                                                                                                                      +
                                                                                                                                                                                                      + +.. raw:: html + +

                                                                                                                                                                                                      Notes

                                                                                                                                                                                                      +

                                                                                                                                                                                                      Please note that the easy_install module can only install Python libraries. Thus this module is not able to remove libraries. It is generally recommended to use the pip module which you can first install using easy_install.

                                                                                                                                                                                                      +

                                                                                                                                                                                                      Also note that virtualenv must be installed on the remote host if the virtualenv parameter is specified.

                                                                                                                                                                                                      + \ No newline at end of file diff --git a/rst/modules/facter.rst b/rst/modules/facter.rst index 297c336aa6..992d14bf40 100644 --- a/rst/modules/facter.rst +++ b/rst/modules/facter.rst @@ -1,16 +1,17 @@ .. _facter: facter -`````` +`````````````````````````````` -Runs the discovery program 'facter' on the remote system, returning -JSON data that can be useful for inventory purposes. +.. versionadded:: 0.2 -Requires that 'facter' and 'ruby-json' be installed on the remote end. +Runs the *facter* discovery program (https://github.com/puppetlabs/facter) on the remote system, returning JSON data that can be useful for inventory purposes. -Playbooks do not actually use this module, they use the :ref:`setup` -module behind the scenes. -Example from /usr/bin/ansible:: +.. raw:: html + +

                                                                                                                                                                                                      Example command-line invocation

                                                                                                                                                                                                      +    ansible  www.example.net -m facter
+

                                                                                                                                                                                                      +
                                                                                                                                                                                                      - ansible foo.example.org -m facter diff --git a/rst/modules/fail.rst b/rst/modules/fail.rst new file mode 100644 index 0000000000..d18574e233 --- /dev/null +++ b/rst/modules/fail.rst @@ -0,0 +1,42 @@ +.. _fail: + +fail +`````````````````````````````` + +.. versionadded:: 0.8 + +This module fails the progress with a custom message. It can be useful for bailing out when a certain condition is met using only_if. + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                      msgnoFailed because only_if condition is true
                                                                                                                                                                                                        		The customized message used for failing execution. If ommited, fail will simple bail out with a generic message.
                                                                                                                                                                                                        rcno1
                                                                                                                                                                                                          		The return code of the failure. This is currently not used by Ansible, but might be used in the future.
                                                                                                                                                                                                          + +.. raw:: html + +

                                                                                                                                                                                                          Example of how a playbook may fail when a condition is not met

                                                                                                                                                                                                          +    [{'action': 'fail msg="The system may not be provisioned according to the CMDB status."', 'only_if': "'$cmdb_status' != 'to-be-staged'"}]
+

                                                                                                                                                                                                          +
                                                                                                                                                                                                          + diff --git a/rst/modules/fetch.rst b/rst/modules/fetch.rst index 99da57e0cf..76b79dac58 100644 --- a/rst/modules/fetch.rst +++ b/rst/modules/fetch.rst @@ -1,22 +1,42 @@ .. _fetch: fetch -````` +`````````````````````````````` -This module works like 'copy', but in reverse. It is used for fetching files -from remote machines and storing them locally in a file tree, organized by hostname. +.. versionadded:: 0.2 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| src | yes | | The file on the remote system to fetch. This needs to be a file, not | -| | | | a directory. Recursive fetching may be supported in a later release. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | A directory to save the file into. For example, if the 'dest' directory | -| | | | is '/foo', a src file named '/tmp/bar' on host 'host.example.com', would | -| | | | be saved into '/foo/host.example.com/tmp/bar' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +This module works like ``copy``, but in reverse. It is used for fetching files from remote machines and storing them locally in a file tree, organized by hostname. -Example:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                          parameterrequireddefaultchoicescomments
                                                                                                                                                                                                          destyes
                                                                                                                                                                                                            		A directory to save the file into. For example, if the dest directory is /backup a src file named /etc/profile on host host.example.com, would be saved into /backup/host.example.com/etc/profile
                                                                                                                                                                                                            srcyes
                                                                                                                                                                                                              		The file on the remote system to fetch. This must be a file, not a directory. Recursive fetching may be supported in a later release.
                                                                                                                                                                                                              + +.. raw:: html + +

                                                                                                                                                                                                              Example from Ansible Playbooks

                                                                                                                                                                                                                   fetch src=/var/log/messages dest=/home/logtree
+

                                                                                                                                                                                                              +
                                                                                                                                                                                                              + diff --git a/rst/modules/file.rst b/rst/modules/file.rst index e5ffc57190..5792f8dde7 100644 --- a/rst/modules/file.rst +++ b/rst/modules/file.rst @@ -3,12 +3,9 @@ file `````````````````````````````` -.. versionadded:: 0.1 - Sets attributes of files, symlinks, and directories, or removes files/symlinks/directories. Many other modules support the same options as the file module - including ``copy``, ``template``, and ``assmeble``. - .. raw:: html @@ -19,40 +16,104 @@ Sets attributes of files, symlinks, and directories, or removes files/symlinks/d - - + + + + + + + + + + + + + + + - - + + - - - - - - - + + + + + + - - - - + + + - + - -
                                                                                                                                                                                                              choices comments
                                                                                                                                                                                                              srcno
                                                                                                                                                                                                                		path of the file to link to (applies only to state=link).
                                                                                                                                                                                                                groupno
                                                                                                                                                                                                                  		name of the group that should own the file/directory, as would be fed to chown
                                                                                                                                                                                                                  destTrue[]yes
                                                                                                                                                                                                                    		defines the file being managed, unless when used with state=link, and then sets the destination to create a symbolic link to using src
                                                                                                                                                                                                                    stateFalsefile
                                                                                                                                                                                                                    • file
                                                                                                                                                                                                                    • link
                                                                                                                                                                                                                    • directory
                                                                                                                                                                                                                    • absent
                                                                                                                                                                                                                    		If directory, all immediate subdirectories will be created if they do not exist. If file, the file will NOT be created if it does not exist, see the copy or template module if you want that behavior. If link, the symbolic link will be created or changed. If absent, directories will be recursively deleted, and files or symlinks will be unlinked.
                                                                                                                                                                                                                    selevelnos0
                                                                                                                                                                                                                      		level part of the SELinux file context. This is the MLS/MCS attribute, sometimes known as the range. _default feature works as for seuser.
                                                                                                                                                                                                                      modeFalse
                                                                                                                                                                                                                      seuserno
                                                                                                                                                                                                                        		mode the file or directory should be, such as 0644 as would be fed to chmod. English modes like g+x are not yet supporteduser part of SELinux file context. Will default to system policy, if applicable. If set to _default, it will use the user portion of the the policy if available
                                                                                                                                                                                                                        - + + state + no + file + + If directory, all immediate subdirectories will be created if they do not exist. If file, the file will NOT be created if it does not exist, see the copy or template module if you want that behavior. If link, the symbolic link will be created or changed. If absent, directories will be recursively deleted, and files or symlinks will be unlinked. + + + serole + no + + + role part of SELinux file context, _default feature works as for seuser. + + + mode + no + + + mode the file or directory should be, such as 0644 as would be fed to + + + context + no + + + accepts only default as value. This will restore a file's SELinux context in the policy. Does nothing if no default value is available. + + + owner + no + + + name of the user that should own the file/directory, as would be fed to chown + + + force + no + + + force is required when changing an existing file to a directory, or a link to a directory, and so on. Use this with caution. + + + setype + no + + + type part of SELinux file context, _default feature works as for seuser. + + .. raw:: html - -

                                                                                                                                                                                                                        Example from Ansible Playbooks

                                                                                                                                                                                                                        - 

                                                                                                                                                                                                                        -    file path=/etc/foo.conf owner=foo group=foo mode=0644

                                                                                                                                                                                                                        - +

                                                                                                                                                                                                                        Example from Ansible Playbooks

                                                                                                                                                                                                                        +    file path=/etc/foo.conf owner=foo group=foo mode=0644
+

                                                                                                                                                                                                                        + 

                                                                                                                                                                                                                        +    file src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link
+


                                                                                                                                                                                                                        +.. raw:: html + +

                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                        +

                                                                                                                                                                                                                        See also copy, template, assemble

                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/fireball.rst b/rst/modules/fireball.rst new file mode 100644 index 0000000000..cd6ab4f477 --- /dev/null +++ b/rst/modules/fireball.rst @@ -0,0 +1,61 @@ +.. _fireball: + +fireball +`````````````````````````````` + +.. versionadded:: 0.9 + +This modules launches an ephemeral *fireball* ZeroMQ message bus daemon on the remote node which Ansible can to communicate with nodes at high speed. +The daemon listens on a configurable port for a configurable amount of time. +Starting a new fireball as a given user terminates any existing user fireballs. +Fireball mode is AES encrypted + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                        minutesno30
                                                                                                                                                                                                                          		The fireball listener daemon is started on nodes and will stay around for this number of minutes before turning itself off.
                                                                                                                                                                                                                          portno5099
                                                                                                                                                                                                                            		TCP port for ZeroMQ
                                                                                                                                                                                                                            + +.. raw:: html + +

                                                                                                                                                                                                                            This example playbook has two plays: the first launches fireball mode on all hosts via SSH, and the second actually starts using fireball node for subsequent management over the fireball interface

                                                                                                                                                                                                                            +    - hosts: devservers
+      gather_facts: false
+      connection: ssh
+      sudo: yes
+      tasks:
+          - action: fireball 
+
+    - hosts: devservers
+      connection: fireball
+      tasks:
+          - action: command /usr/bin/anything
+
+

                                                                                                                                                                                                                            +
                                                                                                                                                                                                                            + +.. raw:: html + +

                                                                                                                                                                                                                            Notes

                                                                                                                                                                                                                            +

                                                                                                                                                                                                                            See the advanced playbooks chapter for more about using fireball mode.

                                                                                                                                                                                                                            + \ No newline at end of file diff --git a/rst/modules/get_url.rst b/rst/modules/get_url.rst index eaeec9374e..ca65fed9b0 100644 --- a/rst/modules/get_url.rst +++ b/rst/modules/get_url.rst @@ -5,10 +5,8 @@ get_url .. versionadded:: 0.6 - Downloads files from HTTP, HTTPS, or FTP to the remote server. The remote server must have direct access to the remote resource. - .. raw:: html @@ -19,48 +17,45 @@ Downloads files from HTTP, HTTPS, or FTP to the remote server. The remote server - - + - - + + - - + - - + + - - + - + - + - - + - + - -
                                                                                                                                                                                                                            choices comments
                                                                                                                                                                                                                            urlTrueNoneyes
                                                                                                                                                                                                                              		HTTP, HTTPS, or FTP URL
                                                                                                                                                                                                                              destTrueNoneyes
                                                                                                                                                                                                                                		absolute path of where to download the file to.If dest is a directory, the basename of the file on the remote server will be used. If a directory, thirsty=yes must also be set.
                                                                                                                                                                                                                                thirstyFalseno no
                                                                                                                                                                                                                                • yes
                                                                                                                                                                                                                                • no
                                                                                                                                                                                                                                		if yes, will download the file every time and replace the file if the contents change. if no, the file will only be downloaded if the destination does not exist. Generally should be yes only for small local files. prior to 0.6, acts if yes by default.if yes, will download the file every time and replace the file if the contents change. if no, the file will only be downloaded if the destination does not exist. Generally should be yes only for small local files. prior to 0.6, acts if yes by default. (added in Ansible 0.7)
                                                                                                                                                                                                                                othersFalseno
                                                                                                                                                                                                                                  		all arguments accepted by the file module also work here
                                                                                                                                                                                                                                  - + .. raw:: html - -

                                                                                                                                                                                                                                  Example from Ansible Playbooks

                                                                                                                                                                                                                                  - 

                                                                                                                                                                                                                                  -    get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440

                                                                                                                                                                                                                                  - +

                                                                                                                                                                                                                                  Example from Ansible Playbooks

                                                                                                                                                                                                                                  +    get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440
+


                                                                                                                                                                                                                                  +.. raw:: html + +

                                                                                                                                                                                                                                  Notes

                                                                                                                                                                                                                                  +

                                                                                                                                                                                                                                  This module doesn't yet support configuration for proxies or passwords.

                                                                                                                                                                                                                                  + \ No newline at end of file diff --git a/rst/modules/git.rst b/rst/modules/git.rst index ac372e71bb..26ec13910c 100644 --- a/rst/modules/git.rst +++ b/rst/modules/git.rst @@ -1,26 +1,63 @@ .. _git: git -``` +`````````````````````````````` -Deploys software (or files) from git checkouts. +.. versionadded:: 0.0.1 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| repo | yes | | git, ssh, or http protocol address of the git repo | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | absolute path of where the repo should be checked out to | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| version | no | HEAD | what version to check out -- either the git SHA, the literal string | -| | | | 'HEAD', branch name, or a tag name. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| remote | no | origin | name of the remote branch | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| force | no | yes | (new in 0.7) If yes, any modified files in the working repository will be | -| | | | discarded. Prior to 0.7, this was always 'yes' and could not be disabled. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Manage git checkouts of repositories to deploy files or software. -Example action from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                  parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                  repoyes
                                                                                                                                                                                                                                    		git, ssh, or http protocol address of the git repository.
                                                                                                                                                                                                                                    destyes
                                                                                                                                                                                                                                      		Absolute path of where the repository should be checked out to.
                                                                                                                                                                                                                                      versionnoHEAD
                                                                                                                                                                                                                                        		What version of the repository to check out. This can be the git SHA, the literal string HEAD, branch name, or a tag name.
                                                                                                                                                                                                                                        forcenoyes
                                                                                                                                                                                                                                        • True
                                                                                                                                                                                                                                        • False
                                                                                                                                                                                                                                        		(New in 0.7) If yes, any modified files in the working repository will be discarded. Prior to 0.7, this was always 'yes' and could not be disabled.
                                                                                                                                                                                                                                        remotenoorigin
                                                                                                                                                                                                                                          		Name of the remote branch.
                                                                                                                                                                                                                                          + +.. raw:: html + +

                                                                                                                                                                                                                                          Example git checkout from Ansible Playbooks

                                                                                                                                                                                                                                               git repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22
+

                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                          + diff --git a/rst/modules/group.rst b/rst/modules/group.rst index 20adba7335..fdb6c03897 100644 --- a/rst/modules/group.rst +++ b/rst/modules/group.rst @@ -1,24 +1,56 @@ .. _group: group -````` +`````````````````````````````` -Adds or removes groups. +.. versionadded:: 0.0.2 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | name of the group | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| gid | | | optional git to set for the group | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | | present | 'absent' or 'present' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| system | | no | if 'yes', indicates that the group being created is a system group. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Manage presence of groups on a host. -To control members of the group, see the users resource. +.. raw:: html -Example action from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                          parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                          statenopresent
                                                                                                                                                                                                                                          • present
                                                                                                                                                                                                                                          • absent
                                                                                                                                                                                                                                          		Whether the group should be present or not on the remote host.
                                                                                                                                                                                                                                          gidno
                                                                                                                                                                                                                                            		Optional GID to set for the group.
                                                                                                                                                                                                                                            nameyes
                                                                                                                                                                                                                                              		Name of the group to manage.
                                                                                                                                                                                                                                              systemnono
                                                                                                                                                                                                                                              • True
                                                                                                                                                                                                                                              • False
                                                                                                                                                                                                                                              		If yes, indicates that the group created is a system group.
                                                                                                                                                                                                                                              + +.. raw:: html + +

                                                                                                                                                                                                                                              Example group command from Ansible Playbooks

                                                                                                                                                                                                                                              +    group name=somegroup state=present
+

                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                              - group name=somegroup state=present diff --git a/rst/modules/ini_file.rst b/rst/modules/ini_file.rst index ffa05246d0..4818e3cebc 100644 --- a/rst/modules/ini_file.rst +++ b/rst/modules/ini_file.rst @@ -5,10 +5,8 @@ ini_file .. versionadded:: 0.9 - Manage (add, remove, change) individual settings in an INI-style file without having to manage the file as a whole with, say, ``template`` or ``assemble``. Adds missing sections if they don't exist. - .. raw:: html @@ -19,60 +17,67 @@ Manage (add, remove, change) individual settings in an INI-style file without ha - - + - - + + - - + - + - - + - - + + - - + - - + + - - + - - + + - - + - - + + - -
                                                                                                                                                                                                                                              choices comments
                                                                                                                                                                                                                                              optionFalseNoneno
                                                                                                                                                                                                                                                		if set (required for changing a value), this is the name of the option.May be omitted if adding/removing a whole section.
                                                                                                                                                                                                                                                othersFalseno
                                                                                                                                                                                                                                                  		all arguments accepted by the file module also work here
                                                                                                                                                                                                                                                  destTrueNoneyes
                                                                                                                                                                                                                                                    		Path to the INI-style file; this file is created if required
                                                                                                                                                                                                                                                    sectionTrueNoneyes
                                                                                                                                                                                                                                                      		Section name in INI file. This is added if state=present automatically when a single value is being set.
                                                                                                                                                                                                                                                      backupFalseFalseno
                                                                                                                                                                                                                                                      • yes
                                                                                                                                                                                                                                                      • no
                                                                                                                                                                                                                                                      		 Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                                                                                                                                      valueFalseNoneno
                                                                                                                                                                                                                                                        		the string value to be associated with an option. May be omitted when removing an option.
                                                                                                                                                                                                                                                        - + .. raw:: html +

                                                                                                                                                                                                                                                        Ensure fav=lemonade is in section [drinks] in said file

                                                                                                                                                                                                                                                        +    ini_file dest=/etc/conf section=drinks option=fav value=lemonade mode=0600 backup=true
+

                                                                                                                                                                                                                                                        + 

                                                                                                                                                                                                                                                        +    ini_file dest=/etc/anotherconf
+         section=drinks
+         option=temperature
+         value=cold
+         backup=true
 
+


                                                                                                                                                                                                                                                        +.. raw:: html + +

                                                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                        While it is possible to add an option without specifying a value, this makes no sense.

                                                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/lineinfile.rst b/rst/modules/lineinfile.rst index ed05ebdd19..69bba765bc 100644 --- a/rst/modules/lineinfile.rst +++ b/rst/modules/lineinfile.rst @@ -5,11 +5,9 @@ lineinfile .. versionadded:: 0.7 - This module will search a file for a line, and ensure that it is present or absent. This is primarily useful when you want to change a single line in a file only. For other cases, see the ``copy`` or ``template`` modules. - .. raw:: html @@ -20,68 +18,57 @@ This is primarily useful when you want to change a single line in a file only. F - - + - + - - + - + - - + - + - + - - + - + - + - - + - + - + - - + - - + + - -
                                                                                                                                                                                                                                                        choices comments
                                                                                                                                                                                                                                                        stateFalseno present
                                                                                                                                                                                                                                                        • present
                                                                                                                                                                                                                                                        • absent
                                                                                                                                                                                                                                                        		 Whether the line should be there or not.
                                                                                                                                                                                                                                                        nameTrueyes
                                                                                                                                                                                                                                                          		The file to modify
                                                                                                                                                                                                                                                          insertafterFalseno EOF
                                                                                                                                                                                                                                                          • BOF
                                                                                                                                                                                                                                                          • EOF
                                                                                                                                                                                                                                                          		Used with state=present. If specified, the line will be inserted after the specified regular expression. Two special values are available; BOF for inserting the line at the beginning of the file, and EOF for inserting the line at the end of the file.Used with state=present. If specified, the line will be inserted after the specified regular expression. Two special values are available; BOF for inserting the line at the beginning of the file, and EOF for inserting the line at the end of the file.
                                                                                                                                                                                                                                                          regexpTrueyes
                                                                                                                                                                                                                                                            		The regular expression to look for in the file. For state=present, the pattern to replace. For state=absent, the pattern of the line to remove.The regular expression to look for in the file. For state=present, the pattern to replace. For state=absent, the pattern of the line to remove.
                                                                                                                                                                                                                                                            lineFalseno
                                                                                                                                                                                                                                                              		Required for state=present. The line to insert/replace into the file. Must match the value given to regexp.Required for state=present. The line to insert/replace into the file. Must match the value given to regexp.
                                                                                                                                                                                                                                                              backupFalseFalseno
                                                                                                                                                                                                                                                                		Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                                                                                                                                                - + .. raw:: html - -

                                                                                                                                                                                                                                                                - 

                                                                                                                                                                                                                                                                -    lineinfile name=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled

                                                                                                                                                                                                                                                                - -

                                                                                                                                                                                                                                                                - 

                                                                                                                                                                                                                                                                -    lineinfile name=/etc/sudoers state=absent regexp="^%wheel"

                                                                                                                                                                                                                                                                - + 

                                                                                                                                                                                                                                                                +    lineinfile name=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled
+

                                                                                                                                                                                                                                                                + 

                                                                                                                                                                                                                                                                +    lineinfile name=/etc/sudoers state=absent regexp="^%wheel"
+


                                                                                                                                                                                                                                                                diff --git a/rst/modules/mount.rst b/rst/modules/mount.rst index ba4163121d..f9b522557e 100644 --- a/rst/modules/mount.rst +++ b/rst/modules/mount.rst @@ -1,28 +1,77 @@ .. _mount: mount -````` +`````````````````````````````` .. versionadded:: 0.6 -The mount module controls active and configured mount points (fstab). +This module controls active and configured mount points in ``/etc/fstab``. + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                srcyes
                                                                                                                                                                                                                                                                  		device to be mounted on name.
                                                                                                                                                                                                                                                                  stateyes
                                                                                                                                                                                                                                                                  • present
                                                                                                                                                                                                                                                                  • absent
                                                                                                                                                                                                                                                                  • mounted
                                                                                                                                                                                                                                                                  • unmounted
                                                                                                                                                                                                                                                                  		If mounted or unmounted, the device will be actively mounted or unmounted as well as just configured in fstab. absent and present only deal with fstab.
                                                                                                                                                                                                                                                                  nameyes
                                                                                                                                                                                                                                                                    		path to the mount point, eg: /mnt/files
                                                                                                                                                                                                                                                                    dumpno
                                                                                                                                                                                                                                                                      		dump (see fstab(8))
                                                                                                                                                                                                                                                                      passnono
                                                                                                                                                                                                                                                                        		passno (see fstab(8))
                                                                                                                                                                                                                                                                        optsno
                                                                                                                                                                                                                                                                          		mount options (see fstab(8))
                                                                                                                                                                                                                                                                          fstypeyes
                                                                                                                                                                                                                                                                            		file-system type
                                                                                                                                                                                                                                                                            + +.. raw:: html + +

                                                                                                                                                                                                                                                                            Mount DVD read-only

                                                                                                                                                                                                                                                                            +    mount name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro
+

                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                            -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | path to the mountpoint, ex: /mnt/foo | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| src | yes | | device to be mounted | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| fstype | yes | | fstype | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| opts | no | | mount options (see fstab docs) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dump | no | | dump (see fstab docs) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| passno | no | | passno (see fstab docs) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | yes | | 'present', 'absent', 'mounted', or 'unmounted'. If mounted/unmounted, | -| | | | the device will be actively mounted or unmounted as well as just | -| | | | configured in fstab. 'absent', and 'present' only deal with fstab. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ diff --git a/rst/modules/mysql_db.rst b/rst/modules/mysql_db.rst index b33512272a..9f358bde82 100644 --- a/rst/modules/mysql_db.rst +++ b/rst/modules/mysql_db.rst @@ -1,38 +1,83 @@ .. _mysql_db: mysql_db -```````` +`````````````````````````````` .. versionadded:: 0.6 -Add or remove MySQL databases from a remote host. +Add or remove MySQL databases from a remote host. -Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as -apt-get install python-mysqldb. +.. raw:: html -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+===========+=============================================================================+ -| name | yes | | name of the database to add or remove | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| login_user | no | | user name used to authenticate with | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| login_password | no | | password used to authenticate with | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| login_host | no | localhost | host running the database | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| state | no | present | 'absent' or 'present' | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| collation | no | | collation mode | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ -| encoding | no | | encoding mode | -+--------------------+----------+-----------+-----------------------------------------------------------------------------+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                            parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                            statenopresent
                                                                                                                                                                                                                                                                            • present
                                                                                                                                                                                                                                                                            • absent
                                                                                                                                                                                                                                                                            		The database state
                                                                                                                                                                                                                                                                            nameyes
                                                                                                                                                                                                                                                                              		name of the database to add or remove
                                                                                                                                                                                                                                                                              encodingno
                                                                                                                                                                                                                                                                                		Encoding mode
                                                                                                                                                                                                                                                                                collationno
                                                                                                                                                                                                                                                                                  		Collation mode
                                                                                                                                                                                                                                                                                  login_userno
                                                                                                                                                                                                                                                                                    		The username used to authenticate with
                                                                                                                                                                                                                                                                                    login_hostnolocalhost
                                                                                                                                                                                                                                                                                      		Host running the database
                                                                                                                                                                                                                                                                                      login_passwordno
                                                                                                                                                                                                                                                                                        		The password used to authenticate with
                                                                                                                                                                                                                                                                                        -Both 'login_password' and 'login_username' are required when you are passing credentials. -If none are present, the module will attempt to read the credentials from ~/.my.cnf, and -finally fall back to using the MySQL default login of 'root' with no password. +.. raw:: html -Example action from Ansible :doc:`playbooks`:: +

                                                                                                                                                                                                                                                                                        Create a new database with name 'bobdata'

                                                                                                                                                                                                                                                                                        +    mysql_db db=bobdata state=present
+

                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                        - - name: Create database - action: mysql_db db=bobdata state=present +.. raw:: html + +

                                                                                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                        Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as apt-get install python-mysqldb.

                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                        Both login_password and login_username are required when you are passing credentials. If none are present, the module will attempt to read the credentials from ~/.my.cnf, and finally fall back to using the MySQL default login of 'root' with no password.

                                                                                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/mysql_user.rst b/rst/modules/mysql_user.rst index 7d04458101..78a8054dd0 100644 --- a/rst/modules/mysql_user.rst +++ b/rst/modules/mysql_user.rst @@ -1,47 +1,96 @@ .. _mysql_user: mysql_user -`````````` +`````````````````````````````` .. versionadded:: 0.6 -Adds or removes a user from a MySQL database. +Adds or removes a user from a MySQL database. -Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as -apt-get install python-mysqldb. +.. raw:: html -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+============+============================================================================+ -| name | yes | | name of the user (role) to add or remove | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| password | no | | set the user's password | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| host | no | localhost | the 'host' part of the MySQL username | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| login_user | no | | user name used to authenticate with | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| login_password | no | | password used to authenticate with | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| login_host | no | localhost | host running MySQL. | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| priv | no | | MySQL privileges string in the format: db.table:priv1,priv2 | -+--------------------+----------+------------+----------------------------------------------------------------------------+ -| state | no | present | 'absent' or 'present' | -+--------------------+----------+------------+----------------------------------------------------------------------------+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                        nameyes
                                                                                                                                                                                                                                                                                          		name of the user (role) to add or remove
                                                                                                                                                                                                                                                                                          login_userno
                                                                                                                                                                                                                                                                                            		The username used to authenticate with
                                                                                                                                                                                                                                                                                            login_hostnolocalhost
                                                                                                                                                                                                                                                                                              		Host running the database
                                                                                                                                                                                                                                                                                              hostnolocalhost
                                                                                                                                                                                                                                                                                                		the 'host' part of the MySQL username
                                                                                                                                                                                                                                                                                                statenopresent
                                                                                                                                                                                                                                                                                                • present
                                                                                                                                                                                                                                                                                                • absent
                                                                                                                                                                                                                                                                                                		The database state
                                                                                                                                                                                                                                                                                                login_passwordno
                                                                                                                                                                                                                                                                                                  		The password used to authenticate with
                                                                                                                                                                                                                                                                                                  passwordno
                                                                                                                                                                                                                                                                                                    		set the user's password
                                                                                                                                                                                                                                                                                                    privno
                                                                                                                                                                                                                                                                                                      		MySQL privileges string in the format: db.table:priv1,priv2
                                                                                                                                                                                                                                                                                                      -Both 'login_password' and 'login_username' are required when you are passing credentials. -If none are present, the module will attempt to read the credentials from ~/.my.cnf, and -finally fall back to using the MySQL default login of 'root' with no password. - -Example privileges string format: +.. raw:: html +

                                                                                                                                                                                                                                                                                                      Create database user with name 'bob' and password '12345' with all database privileges

                                                                                                                                                                                                                                                                                                      +    mysql_user name=bob password=12345 priv=*.*:ALL state=present
+

                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                      Ensure no user named 'sally' exists, also passing in the auth credentials.

                                                                                                                                                                                                                                                                                                      +    mysql_user login_user=root login_password=123456 name=sally state=absent
+

                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                      Example privileges string format

                                                                                                                                                                                                                                                                                                           mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL
+

                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                      -Example action from Ansible :doc:`playbooks`:: +.. raw:: html - - name: Create database user - action: mysql_user name=bob password=12345 priv=*.*:ALL state=present - - - name: Ensure no user named 'sally' exists, also passing in the auth credentials. - action: mysql_user login_user=root login_password=123456 name=sally state=absent +

                                                                                                                                                                                                                                                                                                      Notes

                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                      Requires the MySQLdb Python package on the remote host. For Ubuntu, this is as easy as apt-get install python-mysqldb.

                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                      Both login_password and login_username are required when you are passing credentials. If none are present, the module will attempt to read the credentials from ~/.my.cnf, and finally fall back to using the MySQL default login of 'root' with no password.

                                                                                                                                                                                                                                                                                                      + \ No newline at end of file diff --git a/rst/modules/nagios.rst b/rst/modules/nagios.rst index 6545b3731c..017be0e174 100644 --- a/rst/modules/nagios.rst +++ b/rst/modules/nagios.rst @@ -1,124 +1,95 @@ .. _nagios: nagios -`````` +`````````````````````````````` .. versionadded:: 0.7 -Perform common tasks in Nagios related to downtime and notifications. +The ``nagios`` module has two basic functions: scheduling downtime and toggling alerts for services or hosts. +All actions require the ``host`` parameter to be given explicitly. In playbooks you can use the ``$inventory_hostname`` variable to refer to the host the playbook is currently running on. +You can specify multiple services at once by separating them with commas, .e.g., ``services=httpd,nfs,puppet``. +When specifying what service to handle there is a special service value, *host*, which will handle alerts/downtime for the *host itself*, e.g., ``service=host``. This keyword may not be given with other services at the same time. *Setting alerts/downtime for a host does not affect alerts/downtime for any of the services running on it.* +When using the ``nagios`` module you will need to specify your nagios server using the ``delegate_to`` parameter. -The Nagios module has two basic functions: scheduling downtime and -toggling alerts for services or hosts. +.. raw:: html -The following parameters are common to all *actions* in the nagios -module: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                      actionyes
                                                                                                                                                                                                                                                                                                      • downtime
                                                                                                                                                                                                                                                                                                      • enable_alerts
                                                                                                                                                                                                                                                                                                      • disable_alerts
                                                                                                                                                                                                                                                                                                      • silence
                                                                                                                                                                                                                                                                                                      • unsilence
                                                                                                                                                                                                                                                                                                      		Action to take.
                                                                                                                                                                                                                                                                                                      hostyes
                                                                                                                                                                                                                                                                                                        		Host to operate on in Nagios.
                                                                                                                                                                                                                                                                                                        authornoAnsible
                                                                                                                                                                                                                                                                                                          		Author to leave downtime comments as. - Only useable with the downtime action.
                                                                                                                                                                                                                                                                                                          servicesyes
                                                                                                                                                                                                                                                                                                            		What to manage downtime/alerts for. Separate multiple services with commas.service is an alias for services.Required option when using the downtime, enable_alerts, and disable_alerts actions.
                                                                                                                                                                                                                                                                                                            minutesno30
                                                                                                                                                                                                                                                                                                              		Minutes to schedule downtime for.Only useable with the downtime action.
                                                                                                                                                                                                                                                                                                              cmdfilenoauto-detected
                                                                                                                                                                                                                                                                                                                		Path to the nagios command file (FIFO pipe).Only required if auto-detection fails.
                                                                                                                                                                                                                                                                                                                -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| parameter | required | default | comments | -+===============+==========+==================================+==================================================================+ -| action | yes | | one of: 'downtime', 'enable_alerts'/'disable_alerts', or | -| | | | 'silence'/'unsilence' | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| host | yes | | host to operate on in nagios | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| cmdfile | no | auto-detected | path to the nagios *command file* (FIFO pipe) | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ +.. raw:: html -The following parameters may be used with the **downtime** action: +

                                                                                                                                                                                                                                                                                                                set 30 minutes of apache downtime

                                                                                                                                                                                                                                                                                                                +    nagios action=downtime minutes=30 service=httpd host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                schedule an hour of HOST downtime

                                                                                                                                                                                                                                                                                                                +    nagios action=downtime minutes=60 service=host host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                schedule downtime for a few services

                                                                                                                                                                                                                                                                                                                +    nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                enable SMART disk alerts

                                                                                                                                                                                                                                                                                                                +    nagios action=enable_alerts service=smart host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                two services at once: disable httpd and nfs alerts

                                                                                                                                                                                                                                                                                                                +    nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                disable HOST alerts

                                                                                                                                                                                                                                                                                                                +    nagios action=disable_alerts service=host host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                silence ALL alerts

                                                                                                                                                                                                                                                                                                                +    nagios action=silence host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                unsilence all alerts

                                                                                                                                                                                                                                                                                                                +    nagios action=unsilence host=$inventory_hostname
+

                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| parameter | required | default | comments | -+===============+==========+==================================+==================================================================+ -| author | no | Ansible | author to leave downtime comments as | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| minutes | no | 30 | minutes to schedule downtime for | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| services | yes | | what to manage downtime/alerts for. separate multiple services | -| | | | with commas. | -| | | | **service** is an alias for **services** | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ - -The following parameter must be used with the **enable_alerts** and **disable_alerts** actions: - -+---------------+----------+----------------------------------+------------------------------------------------------------------+ -| parameter | required | default | comments | -+===============+==========+==================================+==================================================================+ -| services | yes | | what to manage downtime/alerts for. separate multiple services | -| | | | with commas. | -| | | | **service** is an alias for **services** | -+---------------+----------+----------------------------------+------------------------------------------------------------------+ - -.. note:: - The **silence** and **unsilence** actions have no additional - parameters that may be used with them. - - -All actions require the **host** parameter to be given explicitly. In -playbooks you can use the ``$inventory_hostname`` variable to refer to -the host the playbook is currently running on. - -You can specify multiple services at once by separating them with -commas, .e.g., ``services=httpd,nfs,puppet``. - -When specifying what service to handle there is a special service value, -**host**, which will handle alerts/downtime for the **host itself**, -e.g., ``service=host``. This keyword may *not* be given with other -services at the same time. *Handling alerts/downtime for a host does -not affect alerts/downtime for any of the services running on it.* - -Examples from :doc:`playbooks`:: - - --- - - hosts: webservers - user: root - tasks: - - name: set 30 minutes of apache downtime - action: nagios action=downtime minutes=30 service=httpd host=$inventory_hostname - delegate_to: nagios.example.com - - - name: schedule an hour of HOST downtime - action: nagios action=downtime minutes=60 service=host host=$inventory_hostname - delegate_to: nagios.example.com - - # Use the default of 30 minutes - # Schedule downtime for three services at once - - name: schedule downtime for a few services - action: nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname - delegate_to: nagios.example.com - - - name: enable SMART disk alerts - action: nagios action=enable_alerts service=smart host=$inventory_hostname - delegate_to: nagios.example.com - - # you can disable multiple at once - - name: disable httpd alerts - action: nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname - delegate_to: nagios.example.com - - # host alerts must be disabled as a seperate action - - name: disable HOST alerts - action: nagios action=disable_alerts service=host host=$inventory_hostname - delegate_to: nagios.example.com - - - name: silence ALL alerts - action: nagios action=silence host=$inventory_hostname - delegate_to: nagios.example.com - - - name: unsilence all alerts - action: nagios action=unsilence host=$inventory_hostname - delegate_to: nagios.example.com - -**Troubleshooting Tips** - -The nagios module may not operate for you out of the box. The most -likely problem is with your **cmdfile** permissions/paths. You will -receive this error if that is the case:: - - {"msg": "unable to write to nagios command file", "failed": true, "cmdfile": "/var/spool/nagios/cmd/nagios.cmd"} - -Steps to correct this: - -1. Ensure you are running the nagios module as a user who has - **write** permissions to the **cmdfile**. - -2. Ensure you have **cmdfile** set correctly. diff --git a/rst/modules/ohai.rst b/rst/modules/ohai.rst index 184a2e56ff..f2e53dd6c0 100644 --- a/rst/modules/ohai.rst +++ b/rst/modules/ohai.rst @@ -1,16 +1,17 @@ .. _ohai: ohai -```` +`````````````````````````````` -Similar to the :ref:`facter` module, this returns JSON inventory data. -Ohai data is a bit more verbose and nested than facter. +.. versionadded:: 0.6 -Requires that 'ohai' be installed on the remote end. +Similar to the ``facter`` module, this runs the *ohai* discovery program (http://wiki.opscode.com/display/chef/Ohai) on the remote host and returns JSON inventory data. *Ohai* data is a bit more verbose and nested than *facter*. -Playbooks should not call the ohai module, playbooks call the -:ref:`setup` module behind the scenes instead. -Example:: +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                Retrieve ohai data from all Web servers and store in one-file per host

                                                                                                                                                                                                                                                                                                                +    ansible webservers -m ohai --tree=/tmp/ohaidata
+

                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                - ansible foo.example.org -m ohai diff --git a/rst/modules/pause.rst b/rst/modules/pause.rst new file mode 100644 index 0000000000..8e1f84f494 --- /dev/null +++ b/rst/modules/pause.rst @@ -0,0 +1,57 @@ +.. _pause: + +pause +`````````````````````````````` + +.. versionadded:: 0.8 + +Pauses playbook execution for a set amount of time, or until a prompt is acknowledged. All parameters are optional. The default behavior is to pause with a prompt. +You can use ``ctrl+c`` if you wish to advance a pause earlier than it is set to expire or if you need to abort a playbook run entirely. To continue early: press ``ctrl+c`` and then ``c``. To abort a playbook: press ``ctrl+c`` and then ``a``. +The pause module integrates into async/parallelized playbooks without any special considerations (see also: Rolling Updates). When using pauses with the ``serial`` playbook parameter (as in rolling updates) you are only prompted once for the current group of hosts. + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                secondsno
                                                                                                                                                                                                                                                                                                                  		Number of minutes to pause for.
                                                                                                                                                                                                                                                                                                                  minutesno
                                                                                                                                                                                                                                                                                                                    		Number of minutes to pause for.
                                                                                                                                                                                                                                                                                                                    promptno
                                                                                                                                                                                                                                                                                                                      		Optional text to use for the prompt message.
                                                                                                                                                                                                                                                                                                                      + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                      Pause for 5 minutes to build app cache.

                                                                                                                                                                                                                                                                                                                      +    pause minutes=5
+

                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                      Pause until you can verify updates to an application were successful.

                                                                                                                                                                                                                                                                                                                      +    pause
+

                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                      A helpful reminder of what to look out for post-update.

                                                                                                                                                                                                                                                                                                                      +    pause prompt=Make sure org.foo.FooOverload exception is not present
+

                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                      + diff --git a/rst/modules/ping.rst b/rst/modules/ping.rst index 15ebba2c2b..a852f86d3c 100644 --- a/rst/modules/ping.rst +++ b/rst/modules/ping.rst @@ -1,10 +1,16 @@ .. _ping: ping -```` +`````````````````````````````` -A trivial test module, this module always returns 'pong' on -successful contact. It does not make sense in playbooks, but is useful -from /usr/bin/ansible:: +A trivial test module, this module always returns 'pong' on successful contact. It does not make sense in playbooks, but is useful from ``/usr/bin/ansible`` + + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                      Test 'webservers' status

                                                                                                                                                                                                                                                                                                                           ansible webservers -m ping
+

                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                      + diff --git a/rst/modules/pip.rst b/rst/modules/pip.rst index a820b10825..c07b68e5bd 100644 --- a/rst/modules/pip.rst +++ b/rst/modules/pip.rst @@ -1,34 +1,80 @@ .. _pip: pip -``` +`````````````````````````````` .. versionadded:: 0.7 -Manages Python library dependencies. +Manage Python library dependencies. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | no | | The name of a Python library to install | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| version | no | | The version number to install of the Python library specified in the | -| | | | 'name' parameter | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| requirements | no | | The path to a pip requirements file | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| virtualenv | no | | An optional path to a virtualenv directory to install into | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | no | present | 'present', 'absent' or 'latest' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Please note that `virtualenv `_ must be installed on -the remote host if the `virtualenv` parameter is specified. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                      virtualenvno
                                                                                                                                                                                                                                                                                                                        		An optional path to a virtualenv directory to install into
                                                                                                                                                                                                                                                                                                                        statenopresent
                                                                                                                                                                                                                                                                                                                        • present
                                                                                                                                                                                                                                                                                                                        • absent
                                                                                                                                                                                                                                                                                                                        • latest
                                                                                                                                                                                                                                                                                                                        		The state of module
                                                                                                                                                                                                                                                                                                                        versionno
                                                                                                                                                                                                                                                                                                                          		The version number to install of the Python library specified in the 'name' parameter
                                                                                                                                                                                                                                                                                                                          requirementsno
                                                                                                                                                                                                                                                                                                                            		The path to a pip requirements file
                                                                                                                                                                                                                                                                                                                            nameyes
                                                                                                                                                                                                                                                                                                                              		The name of a Python library to install
                                                                                                                                                                                                                                                                                                                              -Examples:: +.. raw:: html +

                                                                                                                                                                                                                                                                                                                              Install flask python package.

                                                                                                                                                                                                                                                                                                                                   pip name=flask
+

                                                                                                                                                                                                                                                                                                                              +

                                                                                                                                                                                                                                                                                                                              Install flask python package on version 0.8.

                                                                                                                                                                                                                                                                                                                                   pip name=flask version=0.8
+

                                                                                                                                                                                                                                                                                                                              +

                                                                                                                                                                                                                                                                                                                              Install Flask (http://flask.pocoo.org/) into the specified virtualenv

                                                                                                                                                                                                                                                                                                                                   pip name=flask virtualenv=/srv/webapps/my_app/venv
+

                                                                                                                                                                                                                                                                                                                              +

                                                                                                                                                                                                                                                                                                                              Install specified python requirements.

                                                                                                                                                                                                                                                                                                                                   pip requirements=/srv/webapps/my_app/src/requirements.txt
+

                                                                                                                                                                                                                                                                                                                              +

                                                                                                                                                                                                                                                                                                                              Install specified python requirements in indicated virtualenv.

                                                                                                                                                                                                                                                                                                                                   pip requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv
+

                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                              + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                              Notes

                                                                                                                                                                                                                                                                                                                              +

                                                                                                                                                                                                                                                                                                                              Please note that http://www.virtualenv.org/, virtualenv must be installed on the remote host if the virtualenv parameter is specified.

                                                                                                                                                                                                                                                                                                                              + \ No newline at end of file diff --git a/rst/modules/postgresql_db.rst b/rst/modules/postgresql_db.rst index efb7708870..b87d2d754d 100644 --- a/rst/modules/postgresql_db.rst +++ b/rst/modules/postgresql_db.rst @@ -1,39 +1,76 @@ .. _postgresql_db: postgresql_db -````````````` +`````````````````````````````` .. versionadded:: 0.6 -Add or remove PostgreSQL databases from a remote host. +Add or remove PostgreSQL databases from a remote host. -The default authentication assumes that you are either logging in as or -sudo'ing to the postgres account on the host. +.. raw:: html -This module uses psycopg2, a Python PostgreSQL database adapter. You must -ensure that psycopg2 is installed on the host before using this module. If -the remote host is the PostgreSQL server (which is the default case), then -PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, -install the postgresql, libpq-dev, and python-psycopg2 packages on the remote -host before using this module. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                              parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                              statenopresent
                                                                                                                                                                                                                                                                                                                              • present
                                                                                                                                                                                                                                                                                                                              • absent
                                                                                                                                                                                                                                                                                                                              		The database state
                                                                                                                                                                                                                                                                                                                              nameyes
                                                                                                                                                                                                                                                                                                                                		name of the database to add or remove
                                                                                                                                                                                                                                                                                                                                login_passwordno
                                                                                                                                                                                                                                                                                                                                  		The password used to authenticate with
                                                                                                                                                                                                                                                                                                                                  ownerno
                                                                                                                                                                                                                                                                                                                                    		Name of the role to set as owner of the database
                                                                                                                                                                                                                                                                                                                                    login_userno
                                                                                                                                                                                                                                                                                                                                      		The username used to authenticate with
                                                                                                                                                                                                                                                                                                                                      login_hostnolocalhost
                                                                                                                                                                                                                                                                                                                                        		Host running the database
                                                                                                                                                                                                                                                                                                                                        +.. raw:: html -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+==========+============================================================================+ -| name | yes | | name of the database to add or remove | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_user | no | postgres | user (role) used to authenticate with PostgreSQL | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_password | no | | password used to authenticate with PostgreSQL | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_host | no | | host running PostgreSQL. Default (blank) implies localhost | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| owner | no | | name of the role to set as owner of the database | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| state | | present | 'absent' or 'present' | -+--------------------+----------+----------+----------------------------------------------------------------------------+ - -Example action from Ansible :doc:`playbooks`:: - +

                                                                                                                                                                                                                                                                                                                                        Create a new database with name 'acme'

                                                                                                                                                                                                                                                                                                                                             postgresql_db db=acme
+

                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                        + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                                                                        The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host.

                                                                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                                                                        This module uses psycopg2, a Python PostgreSQL database adapter. You must ensure that psycopg2 is installed on the host before using this module. If the remote host is the PostgreSQL server (which is the default case), then PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, install the postgresql, libpq-dev, and python-psycopg2 packages on the remote host before using this module.

                                                                                                                                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/postgresql_user.rst b/rst/modules/postgresql_user.rst index ed6d3b6994..5b554d8fb8 100644 --- a/rst/modules/postgresql_user.rst +++ b/rst/modules/postgresql_user.rst @@ -1,65 +1,108 @@ .. _postgresql_user: postgresql_user -``````````````` +`````````````````````````````` .. versionadded:: 0.6 -Add or remove PostgreSQL users (roles) from a remote host and, optionally, grant the users -access to an existing database or tables. +Add or remove PostgreSQL users (roles) from a remote host and, optionally, grant the users access to an existing database or tables. +The fundamental function of the module is to create, or delete, roles from a PostgreSQL cluster. Privilege assignment, or removal, is an optional step, which works on one database at a time. This allows for the module to be called several times in the same module to modify the permissions on different databases, or to grant permissions to already existing users. +A user cannot be removed untill all the privileges have been stripped from the user. In such situation, if the module tries to remove the user it will fail. To avoid this from happening the fail_on_user option signals the module to try to remove the user, but if not possible keep going; the module will report if changes happened and separately if the user was removed or not. -The default authentication assumes that you are either logging in as or -sudo'ing to the postgres account on the host. +.. raw:: html -This module uses psycopg2, a Python PostgreSQL database adapter. You must -ensure that psycopg2 is installed on the host before using this module. If -the remote host is the PostgreSQL server (which is the default case), then -PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, -install the postgresql, libpq-dev, and python-psycopg2 packages on the remote -host before using this module. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                        nameyes
                                                                                                                                                                                                                                                                                                                                          		name of the user (role) to add or remove
                                                                                                                                                                                                                                                                                                                                          login_usernopostgres
                                                                                                                                                                                                                                                                                                                                            		User (role) used to authenticate with PostgreSQL
                                                                                                                                                                                                                                                                                                                                            login_hostnolocalhost
                                                                                                                                                                                                                                                                                                                                              		Host running PostgreSQL.
                                                                                                                                                                                                                                                                                                                                              dbno
                                                                                                                                                                                                                                                                                                                                                		name of database where permissions will be granted
                                                                                                                                                                                                                                                                                                                                                statenopresent
                                                                                                                                                                                                                                                                                                                                                • present
                                                                                                                                                                                                                                                                                                                                                • absent
                                                                                                                                                                                                                                                                                                                                                		The database state
                                                                                                                                                                                                                                                                                                                                                login_passwordno
                                                                                                                                                                                                                                                                                                                                                  		Password used to authenticate with PostgreSQL
                                                                                                                                                                                                                                                                                                                                                  passwordyes
                                                                                                                                                                                                                                                                                                                                                    		set the user's password
                                                                                                                                                                                                                                                                                                                                                    fail_on_usernoTrue
                                                                                                                                                                                                                                                                                                                                                    • yes
                                                                                                                                                                                                                                                                                                                                                    • no
                                                                                                                                                                                                                                                                                                                                                    		if yes, fail when user can't be removed. Otherwise just log and continue
                                                                                                                                                                                                                                                                                                                                                    privno
                                                                                                                                                                                                                                                                                                                                                      		PostgreSQL privileges string in the format: table:priv1,priv2
                                                                                                                                                                                                                                                                                                                                                      -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+==========+============================================================================+ -| name | yes | | name of the user (role) to add or remove | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| password | yes | | set the user's password | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| db | no | | name of database where permissions will be granted | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| priv | no | | PostgreSQL privileges string in the format: table:priv1,priv2 | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| fail_on_user | no | yes | if yes, fail when user can't be removed. Otherwise just log and continue | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_user | no | postgres | user (role) used to authenticate with PostgreSQL | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_password | no | | password used to authenticate with PostgreSQL | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| login_host | no | | host running PostgreSQL. Default (blank) implies localhost | -+--------------------+----------+----------+----------------------------------------------------------------------------+ -| state | | present | 'absent' or 'present' | -+--------------------+----------+----------+----------------------------------------------------------------------------+ - -The fundamental function of the module is to create, or delete, roles from a PostgreSQL cluster. -Privilege assignment, or removal, is an optional step, which works on one database at a time. -This allows for the module to be called several times in the same module to modify the permissions on -different databases, or to grant permissions to already existing users. - -A user cannot be removed untill all the privileges have been stripped from the user. In such situation, -if the module tries to remove the user it will fail. To avoid this from happening the *fail_on_user* option -signals the module to try to remove the user, but if not possible keep going; the module will report if changes -happened and separately if the user was removed or not. - -Example privileges string format: +.. raw:: html +

                                                                                                                                                                                                                                                                                                                                                      Create django user and grant access to database and products table

                                                                                                                                                                                                                                                                                                                                                      +    postgresql_user db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL
+

                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                      Remove test user privileges from acme

                                                                                                                                                                                                                                                                                                                                                      +    postgresql_user db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no
+

                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                      Remove test user from test database and the cluster

                                                                                                                                                                                                                                                                                                                                                      +    postgresql_user db=test user=test priv=ALL state=absent
+

                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                      Example privileges string format

                                                                                                                                                                                                                                                                                                                                                           INSERT,UPDATE/table:SELECT/anothertable:ALL
+

                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                      -Example action from Ansible :doc:`playbooks`:: +.. raw:: html - - name: Create django user and grant access to database and products table - postgresql_user db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL - - - name: Remove test user privileges from acme - postgresql_user db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no - - name: Remove test user from test database and the cluster - postgresql_user db=test user=test priv=ALL state=absent +

                                                                                                                                                                                                                                                                                                                                                      Notes

                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                      The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host.

                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                      This module uses psycopg2, a Python PostgreSQL database adapter. You must ensure that psycopg2 is installed on the host before using this module. If the remote host is the PostgreSQL server (which is the default case), then PostgreSQL must also be installed on the remote host. For Ubuntu-based systems, install the postgresql, libpq-dev, and python-psycopg2 packages on the remote host before using this module.

                                                                                                                                                                                                                                                                                                                                                      + \ No newline at end of file diff --git a/rst/modules/raw.rst b/rst/modules/raw.rst index 92fe4f7925..83a49ccf5b 100644 --- a/rst/modules/raw.rst +++ b/rst/modules/raw.rst @@ -4,18 +4,13 @@ raw `````````````````````````````` - Executes a low-down and dirty SSH command, not going through the module subsystem. This is useful and should only be done in two cases. The first case is installing python-simplejson on older (Python 2.4 and before) hosts that need it as a dependency to run modules, since nearly all core modules require it. Another is speaking to any devices such as routers that do not have any Python installed. In any other case, using the ``shell`` or ``command`` module is much more appropriate. Arguments given to ``raw`` are run directly through the configured remote shell and only output is returned. There is no error detection or change handler support for this module - - .. raw:: html - -

                                                                                                                                                                                                                                                                                                                                                      Example from /usr/bin/ansible to bootstrap a legacy python 2.4 host

                                                                                                                                                                                                                                                                                                                                                      - 

                                                                                                                                                                                                                                                                                                                                                      -    ansible newhost.example.com -m raw -a "yum -y install python-simplejson"

                                                                                                                                                                                                                                                                                                                                                      - +

                                                                                                                                                                                                                                                                                                                                                      Example from /usr/bin/ansible to bootstrap a legacy python 2.4 host

                                                                                                                                                                                                                                                                                                                                                      +    ansible newhost.example.com -m raw -a "yum -y install python-simplejson"
+


                                                                                                                                                                                                                                                                                                                                                      diff --git a/rst/modules/seboolean.rst b/rst/modules/seboolean.rst index 10374f317c..1a51dfeea8 100644 --- a/rst/modules/seboolean.rst +++ b/rst/modules/seboolean.rst @@ -1,24 +1,54 @@ .. _seboolean: seboolean -````````` +`````````````````````````````` .. versionadded:: 0.7 -Toggles SELinux booleans. +Toggles SELinux booleans. -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=====================+============================================================================+ -| name | yes | | name of the boolean to configure | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| persistent | no | no | set to 'yes' if the boolean setting should survive a reboot | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| state | yes | | desired boolean value. 'true' or 'false'. | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ +.. raw:: html -Example from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                      stateyes
                                                                                                                                                                                                                                                                                                                                                      • true
                                                                                                                                                                                                                                                                                                                                                      • false
                                                                                                                                                                                                                                                                                                                                                      		Desired boolean value
                                                                                                                                                                                                                                                                                                                                                      nameyes
                                                                                                                                                                                                                                                                                                                                                        		Name of the boolean to configure
                                                                                                                                                                                                                                                                                                                                                        persistentno
                                                                                                                                                                                                                                                                                                                                                        • yes
                                                                                                                                                                                                                                                                                                                                                        • no
                                                                                                                                                                                                                                                                                                                                                        		Set to 'yes' if the boolean setting should survive a reboot
                                                                                                                                                                                                                                                                                                                                                        +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                        Set httpd_can_network_connect SELinux flag to true and persistent

                                                                                                                                                                                                                                                                                                                                                             seboolean name=httpd_can_network_connect state=true persistent=yes
+

                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                        +.. raw:: html +

                                                                                                                                                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                                                                                        Not tested on any debian based system

                                                                                                                                                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/selinux.rst b/rst/modules/selinux.rst index 163d37ed31..9773a7cff7 100644 --- a/rst/modules/selinux.rst +++ b/rst/modules/selinux.rst @@ -1,25 +1,57 @@ .. _selinux: selinux -``````` +`````````````````````````````` .. versionadded:: 0.7 -Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but -will let you know when it is required. +Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but will let you know when it is required. -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=====================+============================================================================+ -| policy | yes | | name of the SELinux policy to use (example: 'targeted') | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| state | yes | | the SELinux mode. 'enforcing', 'permissive', or 'disabled' | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ -| conf | no | /etc/selinux/config | path to the SELinux configuration file, if non-standard | -+--------------------+----------+---------------------+----------------------------------------------------------------------------+ +.. raw:: html -Example from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                        policyyes
                                                                                                                                                                                                                                                                                                                                                          		name of the SELinux policy to use (example: 'targeted')
                                                                                                                                                                                                                                                                                                                                                          stateyes
                                                                                                                                                                                                                                                                                                                                                          • enforcing
                                                                                                                                                                                                                                                                                                                                                          • permissive
                                                                                                                                                                                                                                                                                                                                                          • disabled
                                                                                                                                                                                                                                                                                                                                                          		The SELinux mode
                                                                                                                                                                                                                                                                                                                                                          confno/etc/selinux/config
                                                                                                                                                                                                                                                                                                                                                            		path to the SELinux configuration file, if non-standard
                                                                                                                                                                                                                                                                                                                                                            +.. raw:: html + + 

                                                                                                                                                                                                                                                                                                                                                                 selinux policy=targeted state=enforcing
+

                                                                                                                                                                                                                                                                                                                                                            + 

                                                                                                                                                                                                                                                                                                                                                                 selinux policy=targeted state=disabled
+

                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                            +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                            Notes

                                                                                                                                                                                                                                                                                                                                                            +

                                                                                                                                                                                                                                                                                                                                                            Not tested on any debian based system

                                                                                                                                                                                                                                                                                                                                                            + \ No newline at end of file diff --git a/rst/modules/service.rst b/rst/modules/service.rst index f94f29d103..a6c96aa720 100644 --- a/rst/modules/service.rst +++ b/rst/modules/service.rst @@ -1,32 +1,68 @@ .. _service: service -``````` +`````````````````````````````` -Controls services on remote machines. +.. versionadded:: 0.1 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | name of the service | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | no | started | 'started', 'stopped', 'reloaded', or 'restarted'. Started/stopped are | -| | | | idempotent actions that will not run commands unless neccessary. | -| | | | 'restarted' will always bounce the service, 'reloaded' will always reload. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| pattern | no | | (new in 0.7) if the service does not respond to the status command, | -| | | | name a substring to look for as would be found in the output of the 'ps' | -| | | | command as a stand-in for a status result. If the string is found, the | -| | | | service will be assumed to be running. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| enabled | no | | Whether the service should start on boot. Either 'yes' or 'no'. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Controls services on remote hosts. -Example actions from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                            parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                            patternno
                                                                                                                                                                                                                                                                                                                                                              		If the service does not respond to the status command, name a substring to look for as would be found in the output of the ps command as a stand-in for a status result. If the string is found, the servie will be assumed to be running. (added in Ansible 0.7)
                                                                                                                                                                                                                                                                                                                                                              stateno
                                                                                                                                                                                                                                                                                                                                                              • running
                                                                                                                                                                                                                                                                                                                                                              • started
                                                                                                                                                                                                                                                                                                                                                              • stopped
                                                                                                                                                                                                                                                                                                                                                              • restarted
                                                                                                                                                                                                                                                                                                                                                              • reloaded
                                                                                                                                                                                                                                                                                                                                                              		started, stopped, reloaded, restarted. Started/stopped are idempotent actions that will not run commands unless necessary. restarted will always bounce the service. reloaded will always reload.
                                                                                                                                                                                                                                                                                                                                                              enabledno
                                                                                                                                                                                                                                                                                                                                                              • yes
                                                                                                                                                                                                                                                                                                                                                              • no
                                                                                                                                                                                                                                                                                                                                                              		Whether the service should start on boot.
                                                                                                                                                                                                                                                                                                                                                              nameyes
                                                                                                                                                                                                                                                                                                                                                                		Name of the service.
                                                                                                                                                                                                                                                                                                                                                                + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                Example action from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                     service name=httpd state=started
+

                                                                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                                                                Example action from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                     service name=httpd state=stopped
+

                                                                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                                                                Example action from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                     service name=httpd state=restarted
+

                                                                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                                                                Example action from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                     service name=httpd state=reloaded
+

                                                                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                                                                Example action from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                     service name=foo pattern=/usr/bin/foo state=started
+

                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                diff --git a/rst/modules/setup.rst b/rst/modules/setup.rst index bec96058af..d3874d172b 100644 --- a/rst/modules/setup.rst +++ b/rst/modules/setup.rst @@ -4,18 +4,18 @@ setup `````````````````````````````` - This module is automatically called by playbooks to gather useful variables about remote hosts that can be used in playbooks. It can also be executed directly by ``/usr/bin/ansible`` to check what variables are available to a host. Ansible provides many *facts* about the system, automatically. - - .. raw:: html - -

                                                                                                                                                                                                                                                                                                                                                                Obtain facts from all hosts and store them indexed by hostname at /tmp/facts.

                                                                                                                                                                                                                                                                                                                                                                - 

                                                                                                                                                                                                                                                                                                                                                                -    ansible all -m setup -tree /tmp/facts

                                                                                                                                                                                                                                                                                                                                                                - +

                                                                                                                                                                                                                                                                                                                                                                Obtain facts from all hosts and store them indexed by hostname at /tmp/facts.

                                                                                                                                                                                                                                                                                                                                                                +    ansible all -m setup -tree /tmp/facts
+


                                                                                                                                                                                                                                                                                                                                                                +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                Notes

                                                                                                                                                                                                                                                                                                                                                                +

                                                                                                                                                                                                                                                                                                                                                                More ansible facts will be added with successive releases. If facter or ohai are installed, variables from these programs will also be snapshotted into the JSON file for usage in templating. These variables are prefixed with facter_ and ohai_ so it's easy to tell their source. All variables are bubbled up to the caller. Using the ansible facts and choosing to not install facter and ohai means you can avoid Ruby-dependencies on your remote systems.

                                                                                                                                                                                                                                                                                                                                                                + \ No newline at end of file diff --git a/rst/modules/shell.rst b/rst/modules/shell.rst index 281107eaeb..80bd61e6a0 100644 --- a/rst/modules/shell.rst +++ b/rst/modules/shell.rst @@ -1,31 +1,54 @@ .. _shell: shell -````` +`````````````````````````````` -The shell module takes the command name followed by a list of -arguments, space delimited. It is almost exactly like the command module -but runs the command through the user's configured shell on the remote node. +.. versionadded:: 0.2 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| (free form) | N/A | N/A | the command module takes a free form command to run | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| creates | no | | a filename, when it already exists, this step will NOT be run | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| chdir | no | | cd into this directory before running the command (0.6 and later) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +The shell module takes the command name followed by a list of arguments, space delimited. It is almost exactly like the ``command`` module but runs the command through the user's configured shell on the remote node. -The given command will be executed on all selected nodes. +.. raw:: html -.. note:: - If you want to execute a command securely and predicably, it may be - better to use the 'command' module instead. Best practices when - writing playbooks will follow the trend of using 'command' unless - 'shell' is explicitly required. When running ad-hoc commands, use - your best judgement. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                createsno
                                                                                                                                                                                                                                                                                                                                                                  		a filename, when it already exists, this step will NOT be run
                                                                                                                                                                                                                                                                                                                                                                  chdirno
                                                                                                                                                                                                                                                                                                                                                                    		cd into this directory before running the command (0.6 and later)
                                                                                                                                                                                                                                                                                                                                                                    (free form)no
                                                                                                                                                                                                                                                                                                                                                                      		The command module takes a free form command to run
                                                                                                                                                                                                                                                                                                                                                                      -Example action from a playbook:: +.. raw:: html +

                                                                                                                                                                                                                                                                                                                                                                      Execute the command in remote shell

                                                                                                                                                                                                                                                                                                                                                                           shell somescript.sh >> somelog.txt
+

                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                      + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                      Notes

                                                                                                                                                                                                                                                                                                                                                                      +

                                                                                                                                                                                                                                                                                                                                                                      If you want to execute a command securely and predicably, it may be better to use the command module instead. Best practices when writing playbooks will follow the trend of using command unless shell is explicitly required. When running ad-hoc commands, use your best judgement.

                                                                                                                                                                                                                                                                                                                                                                      + \ No newline at end of file diff --git a/rst/modules/slurp.rst b/rst/modules/slurp.rst new file mode 100644 index 0000000000..1d6989accf --- /dev/null +++ b/rst/modules/slurp.rst @@ -0,0 +1,44 @@ +.. _slurp: + +slurp +`````````````````````````````` + + +This module works like ``fetch``. It is used for fetching a base64- encoded blob containing the data in a remote file. + +.. raw:: html + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                      srcyes
                                                                                                                                                                                                                                                                                                                                                                        		The file on the remote system to fetch. This must be a file, not a directory.
                                                                                                                                                                                                                                                                                                                                                                        + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                        Example using /usr/bin/ansible

                                                                                                                                                                                                                                                                                                                                                                        +    ansible host -m slurp -a 'src=/tmp/xx'
+    host | success >> {
+       "content": "aGVsbG8gQW5zaWJsZSB3b3JsZAo=", 
+       "encoding": "base64"
+    }
+
+

                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                        + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                        Notes

                                                                                                                                                                                                                                                                                                                                                                        +

                                                                                                                                                                                                                                                                                                                                                                        See also: fetch

                                                                                                                                                                                                                                                                                                                                                                        + \ No newline at end of file diff --git a/rst/modules/subversion.rst b/rst/modules/subversion.rst index ec26c5b5ba..5ca2d086ec 100644 --- a/rst/modules/subversion.rst +++ b/rst/modules/subversion.rst @@ -1,23 +1,54 @@ .. _subversion: subversion -`````````` +`````````````````````````````` .. versionadded:: 0.7 -Deploys a subversion repository. +This module is really simple, so for now this checks out from the given branch of a repo at a particular SHA or tag. Latest is not supported, you should not be doing that. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| repo | yes | | The subversion URL to the repository. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | Absolute path where the repository should be deployed. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| force | no | yes | If yes, any modified files in the working repository will be | -| | | | discarded. If no, this module will fail if it encounters modified files. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from Ansible :doc:`playbooks`:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                        parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                        repoyes
                                                                                                                                                                                                                                                                                                                                                                          		The subversion URL to the repository.
                                                                                                                                                                                                                                                                                                                                                                          destyes
                                                                                                                                                                                                                                                                                                                                                                            		Absolute path where the repository should be deployed.
                                                                                                                                                                                                                                                                                                                                                                            forcenoTrue
                                                                                                                                                                                                                                                                                                                                                                            • yes
                                                                                                                                                                                                                                                                                                                                                                            • no
                                                                                                                                                                                                                                                                                                                                                                            		If yes, any modified files in the working repository will be discarded. If no, this module will fail if it encounters modified files.
                                                                                                                                                                                                                                                                                                                                                                            +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                            Export subversion repository in a specified folder

                                                                                                                                                                                                                                                                                                                                                                                 subversion repo=svn+ssh://an.example.org/path/to/repo dest=/src/checkout
+

                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                            + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                            Notes

                                                                                                                                                                                                                                                                                                                                                                            +

                                                                                                                                                                                                                                                                                                                                                                            Requires subversion and grep on the client.

                                                                                                                                                                                                                                                                                                                                                                            + \ No newline at end of file diff --git a/rst/modules/supervisorctl.rst b/rst/modules/supervisorctl.rst index 074808c594..b9b6691334 100644 --- a/rst/modules/supervisorctl.rst +++ b/rst/modules/supervisorctl.rst @@ -1,20 +1,42 @@ .. _supervisorctl: supervisorctl -````````````` +`````````````````````````````` .. versionadded:: 0.7 -Manage the state of a program or group of programs running via Supervisord +Manage the state of a program or group of programs running via Supervisord -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | The name of the supervisord program/process to manage | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | yes | | 'started', 'stopped' or 'restarted' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from a playbook:: + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                            parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                            stateyes
                                                                                                                                                                                                                                                                                                                                                                            • started
                                                                                                                                                                                                                                                                                                                                                                            • stopped
                                                                                                                                                                                                                                                                                                                                                                            • restarted
                                                                                                                                                                                                                                                                                                                                                                            		The state of service
                                                                                                                                                                                                                                                                                                                                                                            nameyes
                                                                                                                                                                                                                                                                                                                                                                              		The name of the supervisord program/process to manage
                                                                                                                                                                                                                                                                                                                                                                              +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                              Manage the state of program my_app to be in started state.

                                                                                                                                                                                                                                                                                                                                                                                   supervisorctl name=my_app state=started
+

                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                              + diff --git a/rst/modules/template.rst b/rst/modules/template.rst index 50002b2f2d..383aabfe1b 100644 --- a/rst/modules/template.rst +++ b/rst/modules/template.rst @@ -1,29 +1,60 @@ .. _template: template -```````` +`````````````````````````````` -Templates a file out to a remote server. -Templates are processed by the -`Jinja2 templating language `_ - -documentation on the template formatting can be found in the -`Template Designer Documentation `_ +Templates are processed by the Jinja2 templating language (http://jinja.pocoo.org/docs/) - documentation on the template formatting can be found in the Template Designer Documentation (http://jinja.pocoo.org/docs/templates/). -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| src | yes | | Path of a Jinja2 formatted template on the local server. This can be | -| | | | a relative or absolute path. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| dest | yes | | Location to render the template on the remote server | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| backup | no | no | Create a backup file including the timestamp information so you can | -| | | | get the original file back if you somehow clobbered it incorrectly. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| OTHERS | | | This module also supports all of the arguments to the file module | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +.. raw:: html -Example action from a playbook:: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                              parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                              destyes
                                                                                                                                                                                                                                                                                                                                                                                		Location to render the template to on the remote machine.
                                                                                                                                                                                                                                                                                                                                                                                srcyes
                                                                                                                                                                                                                                                                                                                                                                                  		Path of a Jinja2 formatted template on the local server. This can be a relative or absolute path.
                                                                                                                                                                                                                                                                                                                                                                                  backupnono
                                                                                                                                                                                                                                                                                                                                                                                  • yes
                                                                                                                                                                                                                                                                                                                                                                                  • no
                                                                                                                                                                                                                                                                                                                                                                                  		Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
                                                                                                                                                                                                                                                                                                                                                                                  othersno
                                                                                                                                                                                                                                                                                                                                                                                    		all arguments accepted by the file module also work here
                                                                                                                                                                                                                                                                                                                                                                                    - template src=/srv/mytemplates/foo.j2 dest=/etc/foo.conf owner=foo group=foo mode=0644 +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                                    Example from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                                    +    template src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644
+

                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                    + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                                    Notes

                                                                                                                                                                                                                                                                                                                                                                                    +

                                                                                                                                                                                                                                                                                                                                                                                    Since Ansible version 0.9, templates are loaded with trim_blocks=True.

                                                                                                                                                                                                                                                                                                                                                                                    + \ No newline at end of file diff --git a/rst/modules/user.rst b/rst/modules/user.rst index 218b3bc41e..710d703e47 100644 --- a/rst/modules/user.rst +++ b/rst/modules/user.rst @@ -1,47 +1,123 @@ .. _user: user -```` +`````````````````````````````` -Creates user accounts, manipulates existing user accounts, and removes user accounts. +.. versionadded:: 0.2 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | name of the user to create, remove, or edit | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| comment | | | optionally sets the description of the user | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| uid | | | optionally sets the uid of the user | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| group | | | optionally sets the user's primary group (takes a group name) | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| groups | | | puts the user in this comma-delimited list of groups | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| append | | no | if 'yes', will only add groups, not set them to just the list in 'groups' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| shell | | | optionally set the user's shell | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| createhome | | yes | unless 'no', a home directory will be made for the user | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| home | | | sets where the user's homedir should be, if not the default | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| password | | | optionally set the user's password to this crypted value. See the user's | -| | | | example in the github examples directory for what this looks like in a | -| | | | playbook | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | | present | when 'absent', removes the user. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| system | | no | only when initially creating, setting this to 'yes' makes the user a | -| | | | system account. This setting cannot be changed on existing users. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| force | | no | when used with state=absent, behavior is as with userdel --force | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| remove | | no | when used with state=absent, behavior is as with userdel --remove | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Manage user accounts and user attributes. -Example action from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                                    parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                                    commentno
                                                                                                                                                                                                                                                                                                                                                                                      		Optionally sets the description (aka GECOS) of user account.
                                                                                                                                                                                                                                                                                                                                                                                      shellno
                                                                                                                                                                                                                                                                                                                                                                                        		Optionally set the user's shell.
                                                                                                                                                                                                                                                                                                                                                                                        forcenono
                                                                                                                                                                                                                                                                                                                                                                                        • True
                                                                                                                                                                                                                                                                                                                                                                                        • False
                                                                                                                                                                                                                                                                                                                                                                                        		When used with state=absent, behavior is as with userdel --force.
                                                                                                                                                                                                                                                                                                                                                                                        nameyes
                                                                                                                                                                                                                                                                                                                                                                                          		Name of the user to create, remove or modify.
                                                                                                                                                                                                                                                                                                                                                                                          createhomenoyes
                                                                                                                                                                                                                                                                                                                                                                                          • True
                                                                                                                                                                                                                                                                                                                                                                                          • False
                                                                                                                                                                                                                                                                                                                                                                                          		Unless set to no, a home directory will be made for the user when the account is created.
                                                                                                                                                                                                                                                                                                                                                                                          systemnono
                                                                                                                                                                                                                                                                                                                                                                                          • True
                                                                                                                                                                                                                                                                                                                                                                                          • False
                                                                                                                                                                                                                                                                                                                                                                                          		When creating an account, setting this to yes makes the user a system account. This setting cannot be changed on existing users.
                                                                                                                                                                                                                                                                                                                                                                                          removenono
                                                                                                                                                                                                                                                                                                                                                                                          • True
                                                                                                                                                                                                                                                                                                                                                                                          • False
                                                                                                                                                                                                                                                                                                                                                                                          		When used with state=absent, behavior is as with userdel --remove.
                                                                                                                                                                                                                                                                                                                                                                                          statenopresent
                                                                                                                                                                                                                                                                                                                                                                                          • present
                                                                                                                                                                                                                                                                                                                                                                                          • absent
                                                                                                                                                                                                                                                                                                                                                                                          		Whether the account should exist. When absent, removes the user account.
                                                                                                                                                                                                                                                                                                                                                                                          groupsno
                                                                                                                                                                                                                                                                                                                                                                                            		Puts the user in this comma-delimited list of groups.
                                                                                                                                                                                                                                                                                                                                                                                            homeno
                                                                                                                                                                                                                                                                                                                                                                                              		Optionally set the user's home directory.
                                                                                                                                                                                                                                                                                                                                                                                              groupno
                                                                                                                                                                                                                                                                                                                                                                                                		Optionally sets the user's primary group (takes a group name).
                                                                                                                                                                                                                                                                                                                                                                                                passwordno
                                                                                                                                                                                                                                                                                                                                                                                                  		Optionally set the user's password to this crypted value. See the user example in the github examples directory for what this looks like in a playbook.
                                                                                                                                                                                                                                                                                                                                                                                                  appendno
                                                                                                                                                                                                                                                                                                                                                                                                    		If yes, will only add groups, not set them to just the list in groups.
                                                                                                                                                                                                                                                                                                                                                                                                    uidno
                                                                                                                                                                                                                                                                                                                                                                                                      		Optionally sets the UID of the user.
                                                                                                                                                                                                                                                                                                                                                                                                      + +.. raw:: html + +
                                                                                                                                                                                                                                                                                                                                                                                                      - user name=mdehaan comment=awesome password=awWxVV.JvmdHw createhome=yes - user name=mdehaan groups=wheel,skynet - user name=mdehaan state=absent force=yes diff --git a/rst/modules/virt.rst b/rst/modules/virt.rst index 06348f99be..8f2f643677 100644 --- a/rst/modules/virt.rst +++ b/rst/modules/virt.rst @@ -1,43 +1,57 @@ .. _virt: virt -```` +`````````````````````````````` -Manages virtual machines supported by libvirt. Requires that libvirt be installed -on the managed machine. +.. versionadded:: 0.2 -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | name of the guest VM being managed | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | | | 'running', 'shutdown', 'destroyed', or 'undefined'. Note that there may | -| | | | be some lag for state requests like 'shutdown' since these refer only to | -| | | | VM states. After starting a guest, it may not be immediately accessible. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| command | | | in addition to state management, various non-idempotent commands are | -| | | | available. See examples below. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Manages virtual machines supported by *libvirt*. -Example action from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                                                      parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                                                      statenono
                                                                                                                                                                                                                                                                                                                                                                                                      • running
                                                                                                                                                                                                                                                                                                                                                                                                      • shutdown
                                                                                                                                                                                                                                                                                                                                                                                                      • destroyed
                                                                                                                                                                                                                                                                                                                                                                                                      • undefined
                                                                                                                                                                                                                                                                                                                                                                                                      		Note that there may be some lag for state requests like shutdown since these refer only to VM states. After starting a guest, it may not be immediately accessible.
                                                                                                                                                                                                                                                                                                                                                                                                      commandno
                                                                                                                                                                                                                                                                                                                                                                                                        		in addition to state management, various non-idempotent commands are available. See examples
                                                                                                                                                                                                                                                                                                                                                                                                        nameyes
                                                                                                                                                                                                                                                                                                                                                                                                          		name of the guest VM being managed
                                                                                                                                                                                                                                                                                                                                                                                                          + +.. raw:: html + +

                                                                                                                                                                                                                                                                                                                                                                                                          Example from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                                                               virt guest=alpha state=running
-    virt guest=alpha state=shutdown
-    virt guest=alpha state=destroyed
-    virt guest=alpha state=undefined
+

                                                                                                                                                                                                                                                                                                                                                                                                          +

                                                                                                                                                                                                                                                                                                                                                                                                          Example guest management with /usr/bin/ansible

                                                                                                                                                                                                                                                                                                                                                                                                          +    ansible host -m virt -a "guest=alpha command=status"
+

                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                          -Example guest management commands from /usr/bin/ansible:: +.. raw:: html - ansible host -m virt -a "guest=foo command=status" - ansible host -m virt -a "guest=foo command=pause" - ansible host -m virt -a "guest=foo command=unpause" - ansible host -m virt -a "guest=foo command=get_xml" - ansible host -m virt -a "guest=foo command=autostart" - -Example host (hypervisor) management commands from /usr/bin/ansible:: - - ansible host -m virt -a "command=freemem" - ansible host -m virt -a "command=list_vms" - ansible host -m virt -a "command=info" - ansible host -m virt -a "command=nodeinfo" - ansible host -m virt -a "command=virttype" +

                                                                                                                                                                                                                                                                                                                                                                                                          Notes

                                                                                                                                                                                                                                                                                                                                                                                                          +

                                                                                                                                                                                                                                                                                                                                                                                                          Other non-idempotent commands are: status, pause, unpause, get_xml, autostart, freemem, list_vms, info, nodeinfo, virttype

                                                                                                                                                                                                                                                                                                                                                                                                          + \ No newline at end of file diff --git a/rst/modules/wait_for.rst b/rst/modules/wait_for.rst index d249707869..a66552608c 100644 --- a/rst/modules/wait_for.rst +++ b/rst/modules/wait_for.rst @@ -1,32 +1,63 @@ .. _wait_for: wait_for -```````` +`````````````````````````````` .. versionadded:: 0.7 -Waits for a given port to become accessible (or inaccessible) on a local or remote server. +This is useful for when services are not immediately available after their init scripts return - which is true of certain Java application servers. It is also useful when starting guests with the ``virt`` module and needing to pause until they are ready. -This is useful for when services are not immediately available after their init scripts return -- which is true of certain -Java application servers. It is also useful when starting guests with the virt module and -needing to pause until they are ready. +.. raw:: html -+--------------------+----------+-----------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+===========+============================================================================+ -| host | no | 127.0.0.1 | hostname or IP to wait for | -+--------------------+----------+-----------+----------------------------------------------------------------------------+ -| timeout | no | 300 | maximum number of seconds to wait | -+--------------------+----------+-----------+----------------------------------------------------------------------------+ -| delay | no | 0 | number of seconds to wait before starting to poll | -+--------------------+----------+-----------+----------------------------------------------------------------------------+ -| port | yes | | port to poll for openness or closedness | -+--------------------+----------+-----------+----------------------------------------------------------------------------+ -| state | no | started | either 'started', or 'stopped' depending on whether the module should poll | -| | | | for the port being open or closed. | -+--------------------+----------+-----------+----------------------------------------------------------------------------+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                                                          parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                                                          delayno
                                                                                                                                                                                                                                                                                                                                                                                                            		number of seconds to wait before starting to poll
                                                                                                                                                                                                                                                                                                                                                                                                            hostno127.0.0.1
                                                                                                                                                                                                                                                                                                                                                                                                              		hostname or IP address to wait for
                                                                                                                                                                                                                                                                                                                                                                                                              portyes
                                                                                                                                                                                                                                                                                                                                                                                                                		port number to poll
                                                                                                                                                                                                                                                                                                                                                                                                                timeoutno300
                                                                                                                                                                                                                                                                                                                                                                                                                  		maximum number of seconds to wait for
                                                                                                                                                                                                                                                                                                                                                                                                                  statenostarted
                                                                                                                                                                                                                                                                                                                                                                                                                  • started
                                                                                                                                                                                                                                                                                                                                                                                                                  • stopped
                                                                                                                                                                                                                                                                                                                                                                                                                  		either started, or stopped depending on whether the module should poll for the port being open or closed.
                                                                                                                                                                                                                                                                                                                                                                                                                  -Example from Ansible :doc:`playbooks`:: +.. raw:: html - wait_for port=8080 delay=10 +

                                                                                                                                                                                                                                                                                                                                                                                                                  Example from Ansible Playbooks

                                                                                                                                                                                                                                                                                                                                                                                                                  +    wait_for port=8000 delay=10
+

                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                  diff --git a/rst/modules/yum.rst b/rst/modules/yum.rst index c46165606f..ae63998ecf 100644 --- a/rst/modules/yum.rst +++ b/rst/modules/yum.rst @@ -1,23 +1,54 @@ .. _yum: yum -``` +`````````````````````````````` -Will install, upgrade, remove, and list packages with the yum package manager. -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| parameter | required | default | comments | -+====================+==========+=========+============================================================================+ -| name | yes | | package name, or package specifier with version, like 'name-1.0' | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| state | | present | 'present', 'latest', or 'absent'. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ -| list | | | various non-idempotent commands for usage with /usr/bin/ansible and not | -| | | | playbooks. See examples below. | -+--------------------+----------+---------+----------------------------------------------------------------------------+ +Will install, upgrade, remove, and list packages with the *yum* package manager. -Example action from Ansible :doc:`playbooks`:: +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                                                                                                                                                                                                                                                  parameterrequireddefaultchoicescomments
                                                                                                                                                                                                                                                                                                                                                                                                                  statenopresent
                                                                                                                                                                                                                                                                                                                                                                                                                  • present
                                                                                                                                                                                                                                                                                                                                                                                                                  • latest
                                                                                                                                                                                                                                                                                                                                                                                                                  • absent
                                                                                                                                                                                                                                                                                                                                                                                                                  		whether to install (present, latest), or remove (absent) a package.
                                                                                                                                                                                                                                                                                                                                                                                                                  listno
                                                                                                                                                                                                                                                                                                                                                                                                                    		various non-idempotent commands for usage with /usr/bin/ansible and not playbooks. See examples.
                                                                                                                                                                                                                                                                                                                                                                                                                    nameyes
                                                                                                                                                                                                                                                                                                                                                                                                                      		package name, or package specifier with version, like name-1.0.
                                                                                                                                                                                                                                                                                                                                                                                                                      + +.. raw:: html + + 

                                                                                                                                                                                                                                                                                                                                                                                                                           yum name=httpd state=latest
+

                                                                                                                                                                                                                                                                                                                                                                                                                      + 

                                                                                                                                                                                                                                                                                                                                                                                                                           yum name=httpd state=removed
+

                                                                                                                                                                                                                                                                                                                                                                                                                      + 

                                                                                                                                                                                                                                                                                                                                                                                                                           yum name=httpd state=installed
+

                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                      + diff --git a/rst/patterns.rst b/rst/patterns.rst index 658c59b7b1..81ee2072d3 100644 --- a/rst/patterns.rst +++ b/rst/patterns.rst @@ -37,10 +37,10 @@ after the hostname with a colon. four.example.com:5309 -In 0.6 and later, if you have a lot of hosts following similar patterns you can do this:: +In 0.6 and later, if you have a lot of hosts following similar patterns you can do this rather than listing each hostname:: [webservers] - www[01-50].example.com + www[01:50].example.com Leading zeros can be included or removed, as desired, and the ranges are inclusive. diff --git a/search.html b/search.html index 90c2232dba..1d19eb2b24 100644 --- a/search.html +++ b/search.html @@ -200,7 +200,7 @@ s.parentNode.insertBefore(ga, s);

                                                                                                                                                                                                                                                                                                                                                                                                                      © Copyright 2012 Michael DeHaan.
                                                                                                                                                                                                                                                                                                                                                                                                                      - Last updated on Sep 28, 2012.
                                                                                                                                                                                                                                                                                                                                                                                                                      + Last updated on Oct 03, 2012.

                                                                                                                                                                                                                                                                                                                                                                                                                      diff --git a/searchindex.js b/searchindex.js index 2c65207d9b..d98afab839 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{},terms:{facter_operatingsystem:9,kickstart:9,func:[],poorli:[],four:7,prefix:[8,9,6],sleep:9,consider:8,whose:9,tweet:[],ansible_default_ipv4:[],ebuild:0,ansible_default_ipv6:[],aur:0,under:[9,6],spec:6,everi:[1,2,4,6,9,10],risk:9,vastli:6,ansible_virtualization_rol:[],redact:[],upstream:[],affect:[5,4,6],virbr0:[],macaddress:[],ansible_config:10,showcas:5,cmd:4,supervisorctl:4,reg:[],ansible_librari:[],shlex:5,vars_prompt:[9,1],saltstack:[],x86_64:8,awwxvv:4,seper:[7,9,4,6],direct:[4,6],chef:[],second:[9,8,4,10],tag_key_valu:8,even:[0,8,9,6,7],hide:9,thunder:[],scp:10,constrast:[],"new":4,net:[0,2,4,5,7,8,10],ever:[7,8,5,6],told:6,elimin:[9,10],manipul:[4,10],facter_hostnam:6,controlmast:0,eckersberg:2,hera:[],never:[5,8,4],here:[0,1,4,5,6,8,9,10],herd:[],"malm\u00f6":[],path:[1,4,5,6,7,8,9,10],interpret:7,datetim:5,permit:[],aka:9,ansible_ssh_arg:0,somethingels:9,brought:[],substr:4,unix:[],cobblerd:8,ec2_:8,total:6,univ:[],unit:5,highli:5,describ:[1,6],would:[0,1,4,5,6,7,8,9,10],h3d850bdf:[],ansible_memtotal_mb:[],noarch:0,dehaan:[],overhead:[],until:[9,4],typo:5,recommend:[5,4,1],type:[9,8,5],tell:[7,10],notif:4,notic:[],warn:5,phone:[],exce:[],ec2_architectur:8,relai:6,loss:[],ansible_transport:0,must:[5,9,8,4,6],join:[],restor:[],setup:[0,1,4,5,6,8,9],work:[0,1,4,6,7,8,9,10],anotherdb:4,erb:[],virttyp:4,cento:[0,9],root:[0,1,4,6,9,10],overrid:[0,8,9],os_default:9,give:2,rpath:[],indic:[4,6],app_serv:9,somefil:6,want:[0,1,2,4,5,6,8,9,10],end:[5,4,6],hoc:[4,6,10],quot:[9,10],"1pm":[],how:[1,2,4,5,6,7,8,9,10],hop:[],yum:[0,1,4,5,6,9,10],perspect:8,updat:[9,4,10],dialect:[],recogn:[6,10],passwordless:10,after:[1,4,5,6,7,8,10],lab:[],diagram:[],befor:[0,4,5,6,9,10],ohai_:6,ec2_image_id:8,arch:0,parallel:[9,6,10],attempt:[0,4,6],ansible_product_seri:[],bootstrap:4,credenti:[4,10],exclud:7,greek:[],unpaus:4,maintain:[0,8,5],environ:[0,9,8,4,10],enter:9,exclus:9,idontknow:[],order:[9,4,6,10],oper:[0,9,4,6,10],frontend:9,softwar:[9,8,4,1,10],over:[0,8,9,10,7],fall:[9,4],orang:2,becaus:[9,8,5,1,2],fifo:4,ec2_previous_st:8,rpmbuild:0,ansible_interfac:[],privileg:4,zeu:[],gather_fact:9,vari:9,myfil:4,streamlin:9,shorter:5,cli:[8,10],img:[],fix:0,better:[0,4,10],offic:[],persist:4,mydb:4,easier:[5,1,2,10],them:[0,1,2,4,5,6,7,9],thei:[4,5,6,7,8,9,10],fragment:4,etc_acme_conf_acm:1,safe:6,ec2_ten:8,"break":6,band:[],glorifi:[],jinja2:[0,9,4,6],ec2_ip_address:8,mgmt:8,httpd_sys_content_t:[],ec2_region:8,choic:[0,5,4],vidal:[],bonu:8,timeout:[9,4],each:[1,2,4,5,6,7,8,9],debug:2,side:[],mean:[2,4,5,6,8,9],colleagu:[],exactli:[5,9,4],playbooks2:[],logo:[],some_password:9,contend:[],network:9,dss:4,content:[0,1,3,4,5,6,7,8,9,10],dsl:[],pool:9,adapt:[8,4],got:[],forth:6,a1b1c1d1:8,site_fact:[9,5],ntp:[7,4],nightmar:[],situat:4,free:[0,9,8,4],standard:[5,4,7],dotnet:2,fixm:[],md5:5,reconfigur:[9,1],openssh:0,traceback:5,isv:[],ansible_form_factor:[],isn:[],suppos:[7,9,5,6,10],rang:[7,10],render:4,clariti:[],wast:[],restrict:5,hook:[],unlik:6,alreadi:[0,4,5,6,8,9],van_halen_port:6,apt_repositori:4,massiv:[],primari:4,rewritten:[],top:[9,5,1,6],sometim:9,destination_vari:8,master:8,too:[8,5,2],similarli:[8,9],john:2,outag:9,iptabl:[],ansible_memfree_mb:[],tool:[0,8,9,10],took:[],"80ghz":[],somewhat:8,technic:[0,8,4],freemem:4,basho:[],target:[10,7,4,1,6],keyword:[9,4],provid:[1,2,4,5,6,8,9],tree:[5,8,4],project:[0,1,2,5,6,9],matter:10,ansible_distribution_releas:[],minut:[4,10],uses_cv:2,recheck:5,provis:[],fashion:[],yesno:[],"_authorized_kei":[],runner:8,ram:[],mind:5,raw:[0,4],aforement:7,seem:[9,6],seek:4,someapp:4,sudo_us:6,contact:[0,8,4],expens:8,blue:9,though:[0,1,4,5,6,8,9],bruce:0,limitless:9,deleg:9,regular:[4,6],specifi:[0,2,4,5,6,8,9,10],bsd:0,boxsubscrib:[],simplic:[],don:[0,1,4,5,6,7,9,10],doc:[8,4],doe:[0,4,5,6,7,8,9,10],declar:6,wildcard:7,libpq:4,came:8,cobbler_external_inventori:[],ffff:[],random:6,syntax:[3,1,2,6,9,10],kerber:0,pkg:[9,4,6,10],radic:[],identifi:[],pki:[],ec2_private_ip_address:8,priv:4,involv:5,absolut:[4,10],northeast:7,acquir:[],explain:5,configur:[0,1,2,4,6,7,8,9,10],apach:[9,4,6,10],ec2_instance_typ:8,version:[0,1,4,6,7,9,10],ldap:8,stop:[0,1,2,4,5,6,7,8,9,10],amazon:8,report:4,saturn:[],cellspac:[],bar:[7,8,4,6],host_var:7,excel:[7,9],"public":[9,8,4],reload:4,bad:5,respond:[8,4,6],daemonless:[],resist:1,result:[5,9,8,4,6],openstack:8,fail:[5,9,8,4,6],themselv:[],load_balanc:6,hammer:[],best:[3,1,4,5,6,8,9],subject:9,brazil:[],heterogen:1,databas:[9,8,4,6],discoveri:4,figur:[],simplest:[8,5],awai:9,irc:[0,2,4,5,7,8,10],approach:[8,9],attribut:[9,4],login_us:4,manpag:[],extens:[],unabl:4,kitchen:[],easi:[0,1,4,5,7,9,10],howev:[0,5,10,7],against:[7,9,6],logic:[],somelist:9,login:[4,6],com:[0,5,8,4,7],compromis:[],assur:[9,6],foobar:4,height:[],written:[0,9,8,5,6],eucalyptu:8,guid:[],assum:[7,8,4],ether:[],speak:4,multiplay:[],ansible_library_path:5,three:[7,4],been:[8,4,10],much:[2,4,6,8,9,10],interest:[0,8],basic:[0,1,2,4,5,6,7,8,9,10],ansible_bios_d:[],tini:9,quickli:10,life:[],recomend:5,ani:[0,1,4,5,6,8,9,10],add_back_to_pool:9,mysql_us:4,dave:[],enterprisei:8,child:[],emploi:2,ugli:9,exception:[],east:8,servic:[1,4,5,6,7,8,9,10],ec2_security_group_id:8,vars_fil:[9,1,6],aim:[],ain:[],visit:[],tabl:[7,8,4],includedir:[],conf:[9,8,4,1,6],module_nam:[7,8],somekei:5,sever:[8,4,6,2],inventori:[0,1,3,4,6,7,8,9,10],incorrectli:4,perform:[0,9,4,6],suggest:4,make:[0,1,4,5,6,7,8,9,10],mayb:[],complex:[9,6],split:[7,5],complet:[8,9,1,2,6],wheel:[9,4],ansible_arch2:[],fragil:[],selevel:[],rail:[],hand:9,rais:[9,5],ownership:10,refin:[],tune:[9,10],speakerdeck:[],kept:6,scenario:8,thu:4,ansible_:9,hypothet:[],tho:[],client:[],"_concatenated_valu":[],thi:[0,1,2,4,5,6,7,8,9,10],endif:9,programm:8,everyth:[0,9],left:[],protocol:4,just:[0,1,2,4,5,6,8,9,10],photo:[],laptop:8,human:[6,2],braces_syntax:[],yet:[0,8,4,10],languag:[0,2,4,5,6,7,8,9],expos:1,had:9,spread:[],board:8,els:[0,9,5,6],ffffff:5,save:[5,9,4,6],hat:[],gave:[],opt:4,applic:[9,8,4,6],supervisord:4,quirk:2,wai:[0,1,4,5,6,7,8,9],fusion:[],background:10,daemon:[],specif:[1,5,6,7,8,9,10],arbitrari:9,manual:6,remind:[9,5,1],el6:[],unnecessari:[],groups_logo_sm:[],www:7,right:[],deal:[5,4],maxim:[],dead:[],born:[],intern:[8,5],heritag:[],successfulli:8,txt:[4,10],forcibl:[],bottom:6,cnf:4,tracker:0,condit:[9,6,10],foo:[4,6,7,8,9,10],localhost:4,core:[5,4,10],plu:[],sensibl:0,web2:8,web1:8,promot:[],repositori:[8,4,1],peer:[],"super":[],chapter:6,sshd:[],postgresql:4,surround:[],simul:9,"2ydx8":4,commit:1,produc:[5,4],match:[5,4,6],duke:[],ppa:[0,4],basenam:4,contriv:[],halon_system_timeout:7,wrap:[],seboolean:4,install_recommend:4,storag:7,eth0:[],ec2_vpc_id:8,git:[0,1,4,5,7,9,10],fabric:[],suffici:9,support:[0,1,4,5,6,8,9,10],nova:8,happi:[],avail:[0,1,2,4,5,6,7,8,9,10],width:[],reli:9,gid:4,wordpress:6,call:[2,4,5,6,7,8,9],war:[],fork:[8,9,10],head:[4,10],python26:0,form:[5,9,4,6,2],offer:[],altogeth:[],batman:0,forg:4,somehow:4,groupfil:7,"true":[5,9,4,6,2],freenod:[0,2,4,5,7,8,10],absent:[5,4,1,10],inquir:5,maximum:[9,4],mtu:[],ansible_fqdn:[],fundament:4,ansible_bios_vers:[],featur:[0,1,6,7,8,9],"abstract":[],fedoraproject:[],plugin:8,cobbler:8,desir:[5,4,6,7],ship:[5,8,4],check:[5,9,4,10],assembl:4,pipe:[4,10],encrypt:[],take_out_of_pool:9,tip:[7,9,4,1,6],role:[9,4,1,6],test:[0,5,8,4,9],tie:8,unlimit:[],maxrequestsperchild:7,node:[0,4,6,8,9,10],relat:4,intend:5,phoenix:7,devop:[],intent:[],consid:[5,1,6],receiv:4,longer:5,anywher:[],ignor:[9,5,6],time:[0,2,4,5,6,7,8,9,10],push:[9,6],concept:[8,9,1,10],vpc:8,chain:[],"5rxgmiicbrh":4,skip:[9,6],consum:[],invent:[],skim:[],operatingsystem:9,decid:[9,8,5,6,10],middl:[],depend:[0,5,9,4],zone:8,flask:4,graph:[],readabl:[1,6],decis:9,downtim:4,southwest:7,sourc:[0,1,2,4,5,6,8,9,10],string:[5,4,6],somelog:4,word:[8,9],brows:5,ansible_virbr0:[],jdk:4,administr:[],level:[6,2],did:[9,8,5],passno:4,item:[8,9,2],team:[],quick:0,ansible_product_nam:[],prevent:5,slower:0,trend:4,ec2_platform:8,anaconda:9,port:[7,4,10],favcolor:[9,8,5],ansible_distribution_vers:[],current:[0,5,9,4,10],suspect:[],ceec4eif7ya:4,deriv:[],gener:[0,4,5,6,8,9],httpd_can_network_connect:4,address:[1,4,5,7,8,9,10],along:[5,6],wait:[9,4],box:[4,10],precursor:[],alta:[],extrem:[0,9,5],bob:[4,6],bof:4,ourselv:6,scpnmy8rks7fyk8ulx0pei:4,love:[],extra:[9,1],tweak:1,modul:[0,1,3,4,5,6,8,9,10],userdel:4,prefer:[7,9,5,10],mzdywqlw:4,leav:[5,9,4,1],instal:[0,4,5,6,9,10],mobil:[],httpd:[7,9,4,6,10],hyperspac:[],priv1:4,priv2:4,prove:9,is_cento:9,univers:[],fail_json:5,perl:10,live:[0,9,10],handler:[10,4,1,6],criteria:9,msg:[5,8,4],scope:[],checkout:[0,5,9,4],ntpserver:8,plug:8,idempot:[5,4,6,10],share:[0,9,8,5],claus:9,enhanc:8,accept:[5,4],easiest:[0,8,9],get_xml:4,ibm:[],module_arg:8,prepar:[],uniqu:8,cat:9,insertaft:4,whatev:[9,5],purpos:[7,4,1,6],boilerpl:5,claim:1,hostvar:9,argument_spec:5,chip:[],agent:[0,10],critic:[],occur:6,alwai:[5,4,1,6],multipl:[1,4,6,7,8,9,10],ping:[0,8,4],uptim:8,write:[1,2,4,5,6,8,9],purg:4,pure:[],somevalu:[9,5],parameter:[9,6],map:[8,6],product:[9,4],mar:[],book:[],max:10,clone:[0,5],usabl:6,membership:[9,10],pattern:[0,1,3,4,6,7,8,9,10],mai:[0,1,2,4,5,6,8,9,10],underscor:8,data:[2,4,5,6,7,8,9],man:[],poseidon:[],practic:[3,1,2,4,6,9],seuser:[],explicit:[],predic:4,inform:[9,8,4,6,10],"switch":[],preced:9,combin:2,talk:[10,0,8,6,7],ender:[],ec2_statu:8,nbsp:[],ec2_id:8,still:[0,9,8,5,6],pointer:5,ec2_virtualization_typ:8,facter_:6,jid:10,overlord:[],group:[0,1,2,4,5,6,7,8,9,10],monitor:8,polici:4,yaml:[3,1,2,6,7,9],window:9,curli:[],pythonpath:[],mail:[0,1,2,4,5,6,7,8,9,10],job_statu:[],main:[9,5,1,6],xyz:10,security_group_pete_s_fancy_group:8,non:[5,4,6,7],hassl:[],env:0,encod:4,ansible_all_ipv4_address:[],initi:4,l6pmiam1a8ywep:4,half:[],now:[0,4,5,6,8,9,10],discuss:[],setyp:[],shoudl:[],down:[8,4,6],term:[5,10],name:[0,1,2,4,5,6,7,8,9,10],config:[8,4,6,10],didn:10,crypto:[],separ:[8,4,1,6],rock:[],domain:[],arg1:4,laserllama:[],yeah:[],ensur:[0,9,4,6,10],contrib:[5,4],backport:[0,4],facter:[9,4,6],happen:[5,8,4],subnet:8,shown:5,space:4,infrar:[],profil:8,intermix:[],skylin:[],internet:[],correct:[9,8,4,6,2],ksmeta:8,lag:4,migrat:[],argv:5,args_fil:5,theori:6,org:[0,4,10,7],grab:[],card:[],care:[4,6],reusabl:5,couldn:[],frequenc:9,synchron:[9,6],thing:[0,1,2,5,6,7,9,10],place:[5,9,4],raleigh:[7,10],router:4,think:[9,5,1],frequent:[8,9],first:[0,4,5,7,9,10],origin:4,directli:[4,5,6,7,8,10],onc:[1,4,5,6,7,9],arrai:9,yourself:6,"long":[0,9,10],oppos:10,open:[5,9,4,6],tomorrow:[],somegroup:4,given:[9,4,1,10],unlink:4,convent:[8,5],gif:[],fierc:[],silenc:4,white:5,friend:[],especi:[9,1],copi:[0,9,8,4,10],motd_cont:9,retyp:0,netmask:[],github:[0,1,2,4,5,6,8,9],mostli:1,than:[0,1,2,4,5,6,8,9,10],cmdb:8,serv:[],wide:[],ec2_private_dns_nam:8,balanc:9,were:[9,6,10],pre:4,sai:[0,9,4,6,10],nicer:[],id_webservergroup:8,argument:[5,8,4,6,7],dash:[8,2],loki:[],collat:4,sat:[],engin:[],squar:[],alias:5,destroi:4,note:[0,4,5,6,8,9,10],forc:4,ideal:9,denomin:1,take:[5,9,4,6,10],noth:[6,2],channel:[0,2,4,5,7,8,10],begin:[4,10,2],sure:[8,9,6,10],normal:[8,10],track:[7,9,10],beta:[],pair:[8,5,2],adopt:[],meanwhil:[],runtim:9,mysql_db:4,show:[9,5,6,10],cheat:[],aggregr:5,geographi:1,permiss:[0,4,10],hack:[0,5],rotat:6,xml:2,onli:[0,4,5,6,8,9,10],explicitli:[4,6],transact:9,activ:4,enough:[7,10],dict:5,analyz:9,analyt:[],nearli:[4,2],variou:[9,8,4,6,10],get:[0,2,3,4,5,6,8,9,10],soon:[],repo:[5,8,4,10,7],ssl:[],cannot:[9,4,6],ssh:[0,4,7,8,9,10],requir:[0,1,4,5,8,9,10],some_file_path_foo:1,through:[0,4,10],where:[0,1,4,5,8,9],summari:6,wiki:[],hour:4,hierachi:[],testserv:[],ansible_product_vers:[],fff:[],ansible_distribut:9,concern:6,detect:4,ansible_ssh_host_key_dsa_publ:[],innov:[],review:[9,4,1,6],enumer:9,estat:[],ansible_system_vendor:[],between:[0,9,1,6],my_app:4,"import":[9,8,5,6,10],across:8,rerun:6,guitar:[],cycl:0,come:[5,6],timmi:6,region:[8,10],contract:8,tutori:5,abc123:8,mani:[4,5,6,8,9,10],setenforc:6,among:9,color:[9,5],overview:2,inspir:[],period:9,colon:[7,6],inventory_hostnam:[9,4],webapp:[4,10],poll:[9,4,10],other_vari:9,coupl:[],west:8,rebuild:[],rubi:[5,9,4,10,2],those:[8,9,6,10],"case":[4,5,6,8,9,10],mount:4,md5sum:[],straighten:[],trick:6,cast:5,invok:[],exist:[4,6,7,8,9,10],default_releas:4,newhost:4,advantag:[9,10],ec2_stat:8,canon:4,worri:9,destin:[8,4],cluster:4,myapp:[9,10],rktgjk2httvs6gigvsuwwfod7:4,chkconfig:[],trival:5,http_port:[7,6],develop:[0,1,2,3,4,5,6,8,9],ansible_architectur:[],author:[4,1],media:[],econom:[],same:[0,1,2,4,6,7,8,9,10],binari:0,html:[],pad:[],pai:10,document:[1,2,4,5,6,8,9,10],week:[],webserv:[1,4,6,7,8,9,10],closest:[],ec2_subnet_id:8,nest:[5,9,4],driven:[],capabl:1,fruit:2,interventori:[],improv:5,extern:[8,9,1],appropri:[9,8,4],choos:[0,4,6],markup:[],clobber:4,without:[0,5,4],promis:[],model:[],roughli:0,execut:[0,4,5,6,8,9,10],when:[1,4,5,6,8,9,10],rest:5,kill:6,speed:0,aws_access_key_id:8,versu:[0,1],europ:[],miscellan:1,except:[8,5],littl:[],otherus:10,blob:[],notori:[],vulner:[],real:[0,9,6],ignore_error:9,around:[],ohai:[9,4,6],read:[0,2,4,5,8,10],dark:8,grid:[],mon:[],world:[0,9,6],intel:[],whitespac:1,realtim:[],ak123:8,integ:[],server:[4,6,7,8,9,10],rycsbf1d8e5ptxesxhqs4iq:4,output:[5,8,4,6],manag:[0,2,4,6,7,8,9,10],ec2_kernel:8,assmebl:4,sneaker:[],jquery_directori:[],titan:[],altalang:[],server01:[],loopback:[],ansible_processor:[],noon:[],definit:[],legal:[5,1],moon:[],exit:[8,5,6],complic:[],refer:[9,8,4,6,10],ansible_swaptotal_mb:[],power:[0,1,5,6,8,9],broken:1,found:[5,9,8,4],regexp:4,"throw":5,earlier:[0,6],src:[9,8,4,6,10],stone:5,central:9,greatli:[],get_url:4,acm:[7,9,4,1,10],wolf:8,stand:4,act:4,industri:[],mytempl:4,backup:4,effici:9,terminolog:8,anothert:4,somescript:4,multinod:[],puppetmast:[],your:[0,1,4,5,6,7,8,9,10],charli:4,stare:5,log:[5,9,8,4,6],area:[],aren:[],catn:[],privileged_us:[],start:[0,1,2,3,4,6,8,10],interfac:8,low:4,lot:[7,9,5,1,10],ipv6:[],ansible_all_ipv6_address:[],bundl:1,vpc_destination_vari:8,congratul:0,faster:[9,5],strawberri:2,dirti:[0,4],possibl:[1,4,5,6,7,8,9,10],"default":[0,4,5,7,8,9,10],ansible_fact:5,stacktrac:5,connect:[0,9,8,4],tasti:2,uid:4,creat:[0,4,6,8,9,10],certain:[9,4,6],deep:6,strongli:1,deferenc:[],file:[0,1,2,4,5,6,7,8,9,10],my_custom_fact_can_be_used_now:9,again:[8,5,6],beyond:9,googl:[0,1,2,4,5,6,7,8,9,10],compel:[],repositor:4,event:[5,8,4,6],valid:5,you:[0,1,2,4,5,6,7,8,9,10],external_var:9,poor:5,sequenc:[],symbol:4,signficantli:0,briefli:6,"60k":[],postgresql_us:4,directori:[1,2,4,5,6,8,9,10],invest:[],descript:[4,1,6],chown:[],potenti:9,appl:2,qeuz:4,cpu:[],all:[0,1,2,4,5,6,7,8,9,10],forget:9,selinux:[4,6],lack:[],mnt:4,month:0,scalar:5,abil:6,follow:[0,4,7,8,9,10],alt:[],disk:4,children:7,nors:[],articl:[5,4],init:4,program:[5,9,4,6,2],mcollect:[],arbitari:2,introduc:[],sound:8,liter:4,tag_name_redi:8,song:[],fals:[5,9,4,2],faq:[],util:[],mechan:[],failur:[9,8,5,6],veri:[0,1,4,5,6,8,9,10],condition:6,database_serv:7,list:[0,1,2,4,5,6,7,8,9,10],pbx:[],sane:[],stderr:5,small:[9,8,4,2],testuser2:9,testuser1:9,enterpris:0,yetanotherdb:4,strung:10,zero:[7,5,6],design:[7,4,10],pass:[0,4,5,6,8,9,10],further:[9,10,2],ec2_spot_instance_request_id:8,what:[0,1,2,4,5,6,8,9,10],sub:[],section:[0,1,4,6,7,8,9,10],abl:[9,4],delet:[4,6,10],abbrevi:2,ec2_state_reason:8,method:[8,10],movement:[],hasn:[],full:[9,4,6],hash:[7,9,8,5,2],filelinkdirectoryabs:[],shouldn:9,recip:0,first_available_fil:9,strong:[],modifi:[5,8,4],fail_on_us:4,valu:[2,4,5,6,8,9,10],search:4,ahead:[0,6],likin:[],memcach:[9,6],prior:[9,4],amount:8,pick:10,action:[9,8,4,6],via:[0,9,8,4],shorthand:[9,5],factnam:9,ec2_state_cod:8,managememnt:[],href:[],select:[1,4,5,6,7,9,10],distinct:[],stdout:[8,9],regist:9,two:[7,8,4,6],rhel:0,demo:10,taken:6,toggl:4,more:[0,1,4,6,7,8,9,10],flat:6,door:[],hundr:[],flag:[0,6,10],particular:[4,6,7,8,9,10],known:[],compani:5,cach:[8,4],none:[0,8,4],pkgbuild:0,hous:[],launch:[9,6],dev:4,remain:[],learn:[0,1,2,5,6,7,9],deb:4,nagio:4,instantan:[],prompt:[9,6,10],yamllint:2,moduledev:[],templat:[1,4,5,6,8,9,10],minimum:[9,5,6],explor:[0,8],pong:4,cygat:[],cours:[9,1],newlin:[],secur:[9,8,4],rather:[9,5],anoth:[1,2,4,6,9,10],simpl:[1,2,5,6,8,9,10],css:[],distro:8,resourc:[5,9,4,6],referenc:[7,9,6],variant:0,fstype:4,ff0000:5,neccesssari:[],args_data:5,associ:[8,4,2],spool:4,"short":[0,9],django:4,caus:0,callback:8,help:[0,1,2,4,5,6,7,8,9,10],xmpp:[],mission:[],uvh:0,scott:[],hierarchi:[],hell:[],suffer:[],paramet:[0,1,4,5,6,9,10],presentabs:[],style:[5,9,4],psycopg2:4,cowsai:[9,6],pend:[],rapidli:[8,9],might:[7,9,8,5,6],wouldn:8,good:[0,9,8,5,6],"return":[5,9,8,4,6],lineinfil:4,food:2,timestamp:4,framework:8,botnet:[],odin:[],neccessari:[9,4],troubleshoot:4,instruct:0,authent:4,mysteri:9,easili:[0,8,9,10],achiev:5,fulli:[0,4],only_if:[9,6],ansible_kernel:[],subsystem:4,harm:[],mental:[],hard:5,idea:[0,1,2,4,5,6,7,8,9,10],crontab:9,realli:[5,8,4,6,2],expect:[8,9,6],variablenam:[],halen:[],orient:6,hostnam:[7,9,8,4,6],ftp:4,safeti:[],pigeon:8,research:[],bubbl:[9,6],print:[8,5],yaml_to_ini:7,qualifi:4,postgr:[4,6],proxi:[7,9],advanc:[0,1,3,6,8,9],pub:10,reason:[9,8,5,6],base:[9,4,1],believ:[],ask:[0,6,10],bash:[0,5,10],basi:6,thrown:[],pyyaml:0,sytem:[],daisi:[],drupal:[],omit:[4,1],american:[],ansible_system:[],assign:[7,9,4,1],feed:[],sdwippefq74nppvuelhpkkaiojjnn1zuhfol:4,notifi:[10,5,4,1,6],obviou:[],feel:[8,9,2],exchang:9,number:[7,9,4],placehold:[9,6],done:[0,9,4,1,7],construct:[8,9,6],blank:4,stabl:[0,4],fiction:[],miss:4,differ:[0,1,4,6,7,8,9,10],list_vm:4,guest:4,script:[4,5,7,8,9,10],interact:[8,10],least:[9,1],camelot:9,make_databas:4,statement:[9,5,6],cfg:10,banana:[],store:[7,9,4],option:[0,1,4,5,6,7,8,9,10],behind:4,selector:10,part:[5,9,4],ec2_key_nam:8,consult:8,reinstal:[],jump:0,kind:5,grep:[],whenev:5,remot:[0,4,6,8,9,10],gotten:[],remov:[7,9,4,10],jqueri:[],reus:[9,6],architect:[],str:5,jvmdhw:4,toward:9,cleaner:9,comput:8,well:[0,1,4,5,6,7,8,9,10],group_var:7,packag:[0,1,4,5,6,9,10],wait_for:4,imagin:[],createhom:4,equival:[9,4],self:5,"123i":[],also:[0,1,2,4,5,6,7,8,9,10],build:[0,5,8,4],brace:[],distribut:[0,1],passwd:[],english:4,reach:1,most:[0,1,2,4,6,8,9,10],plai:[9,6],plan:[],alpha:4,bug:0,filesystem:9,clear:1,cover:[8,9],dereferenc:[],clojur:5,clean:[],add:[0,1,4,5,8,9,10],pars:5,usual:[6,10],awesom:4,commerc:[],ansible_processor_count:[],alphanumer:8,devolv:[],mpd_ring:[],particularli:[8,9,6],fine:[0,5],find:[9,8,5,6,10],impact:[],firewal:9,nosql:[],pretti:[8,9],solut:[],security_group_default:8,olympu:[],ansible_selinux:[],yml:[9,1,6],remedi:9,long_running_oper:10,financ:[],nativ:[0,8,9],silli:[],him:[],restart:[10,7,4,1,6],mdehaan:[4,10],dollar_sign_syntax:[],common:[1,2,4,5,8,9],wrote:5,set:[0,1,4,5,6,7,8,9,10],dump:[5,4],creator:[],security_group_webserv:8,see:[0,1,2,4,5,6,7,8,9,10],sec:9,arg:5,transpar:0,close:[5,4],setsebool:6,analog:[],expert:[],someth:[9,8,5,1,6],restructur:6,hold:9,experi:[],altern:[9,10],solo:[],numer:[],aserv:0,solv:[],tag_aws_cloudformation_log:8,foo_port:[],popul:8,both:[0,4,5,8,9,10],last:0,delimit:4,boto:8,thor:[],uncrypt:6,context:[],whole:4,load:9,simpli:[8,4,1,6],point:[9,4,1],instanti:5,schedul:4,etc_other_conf_oth:1,header:7,shutdown:[9,4],suppli:[],asdf:[],backend:[],unsuccess:6,java:4,instrument:[],devic:4,due:[0,5],empti:8,ran:[],host4:8,enable_alert:4,escape_pod:7,strategi:[],wish:[0,8,9,6,2],fire:9,imag:[],convert:[8,5],append:4,gap:[],understand:[9,6],comprimis:[],educ:5,look:[4,5,6,7,8,9,10],straight:10,batch:10,"while":[9,1,6],unifi:[],smart:[4,10],abov:[9,8,5,6,10],error:[5,9,4],loop:[9,6],pack:8,gimm:[],pragmat:[],motd:[8,9,6],max_client:6,readi:4,readm:[],jpg:[],itself:[0,8,4],ansible_ssh_host_key_rsa_publ:[],unmount:4,fedora:0,grant:4,login_usernam:4,belong:8,exit_json:5,higher:[0,9],optim:1,painless:[],alert:4,moment:8,temporari:[],user:[0,1,4,5,6,8,9,10],yesterdai:[],recent:[],lower:[],task:[10,9,4,1,6],lib:5,older:4,entri:10,lizenzfrei:[],spent:[],commonli:[10,2],endfor:9,spend:[],explan:5,ec2_monitor:8,mysql:4,regardless:[6,2],centos6:8,shortcut:5,async_wrapp:5,appli:[7,9,6],input:[9,5],bin:[0,4,5,6,7,8,9,10],march:5,format:[7,8,4,6,2],judgement:4,nginx:4,game:[],quest:9,bobdata:4,bit:[9,4,6],abduct:[],ec2_ownerid:8,xaby9ud5brbfvkedu:4,name_of_fact:[],knock:[],capital_of_assyria:[],signal:[8,4],"98dbcgqw5hme89cjgzro5ktkc5yu":4,manifest:[],"boolean":[5,4,2],popular:[],cmdfile:4,postgresql_db:4,encount:4,often:[9,8,4,1],simplifi:10,creation:10,some:[0,1,4,5,6,7,8,9,10],back:[0,9,4,6,10],sampl:10,mirror:[],virtualenv:4,scale:9,ec2_tag_kei:8,per:[8,9],pem:0,substitut:6,mathemat:[],larg:9,either:[9,8,4],machin:[0,1,4,5,6,8,9,10],previou:9,run:[0,2,4,5,6,7,8,9,10],step:[0,3,4,6,7,9,10],squeez:4,meantim:[],frob:4,major:8,impor:[],ec2_launch_tim:8,othervar:[],ansible_eth0:9,block:9,fulfil:6,steelhous:[],primarili:4,unreach:6,intl:[],within:[7,8,9,6],contributor:[],chang:[1,4,5,6,7,9,10],subvers:4,bserver:0,rxp33wfphjwjwvhatfci1nrbaudqi:4,inclus:7,span:4,ansible_python_vers:[],group_nam:9,question:[0,1,2,4,5,6,7,8,9,10],fast:0,custom:9,includ:[1,4,5,6,7,8,9,10],suit:6,forward:[],datastructur:8,foosbal:[7,4],lint:2,link:[5,4],translat:[],newer:0,line:[0,2,3,4,5,6,7,8,9,10],info:[8,4,10],concaten:4,consist:5,caller:[],planet:[],schmooz:[],ec2_dns_nam:8,highlight:[],similar:[7,9,8,4,10],curv:[],module_common:5,constant:1,parser:5,doesn:[8,9,10,2],repres:[8,6,2],chat:[0,2,4,5,7,8,10],behavior:[0,9,4,10],bracket:7,coder:[],crypt:[4,10],chgrp:[],disable_alert:4,likes_emac:2,transport:[0,8],peopl:9,nice:6,draw:[],asciidoc:[],meaning:[],svn:4,happier:[],bofeof:[],depth:8,far:[10,2],hello:0,jupit:[],local_act:9,pluggabl:[],code:[1,4,5,6,8,9,10],alien:[],async_statu:10,privat:[0,8,9],sensit:9,elsewher:[],friendli:[],send:[8,9],autostart:4,sens:[0,8,4,6],fatal:[5,6],blindingli:[],sent:5,sensic:[],logtre:4,whichev:[],signfic:5,asdf1234l:4,implicitli:[],ec2_root_device_typ:8,relev:[9,5],tri:4,magic:[9,5,6],roll:9,id_rsa:[0,10],michael:[],fewer:9,"try":[0,4,5,6,8,9],p2xkxaczh6fc:4,pleas:[0,8,4],malici:[],impli:4,natur:[],focu:[],cron:9,gmbh:[],mysqldb:4,download:[0,4],ansible_python_interpret:7,folk:[0,10],index:[8,4],turn:[9,5],compar:[],access:[0,9,8,4],experiment:9,can:[0,1,2,4,5,6,7,8,9,10],chose:[],let:[0,2,4,5,6,8,10],ubuntu:[0,8,4],becom:[9,4],sinc:[8,4,1,10],great:[9,5,1,6],convers:7,hypervisor:4,technolog:[],"_some_str":6,later:[0,4,5,6,7,9,10],unsil:4,typic:[6,10],maker:[],hardi:4,fstab:4,heart:8,win:[],app:9,gatewai:[],apt:[9,4,1,10],austria:[],api:[3,5,8,4],cloud:[],fed:[4,6],from:[0,1,2,4,5,6,7,8,9,10],usa:7,commun:[8,4,6],"8b3satjxmpgbfbueebwubk5ejl":4,doubl:10,upgrad:[4,6,10],next:[0,3,4,6,7,9,10],few:[8,4],usr:[0,4,5,6,7,8,9,10],remaind:8,sort:4,dbserver:[10,7,9,1,6],impress:9,sbin:[9,4,6,10],trail:1,train:[],login_password:4,ansible_nocolor:9,starter:[5,6],account:[0,4,6,10],chdir:4,retriev:9,scalabl:[],tunnel:[],alia:[5,4,7],openjdk:4,alic:6,halt:[],obvious:9,ec2_ramdisk:8,fetch:[9,4],proof:5,employe:2,thirsti:4,tar:0,process:[4,6,10],lock:9,sudo:[0,4,6,10],mango:2,high:[5,10],knows_oop:2,tag:[0,9,8,4,6],tab:6,tarbal:[],onlin:2,serial:9,delai:4,surfac:[],orson:[],lame:2,mysql_root_password:[],"_assembl":[],lepton:5,carrier:8,subdirectori:4,srv:[9,8,4,6,10],panic:9,stock:[],express:[2,4,5,6,8,9],gentoo:0,watch:[],attent:10,tier:[],philosophi:[],ansible_host:0,drop:[8,5],orchestr:6,correspond:4,element:[9,8,5],issu:[0,4],allow:[0,1,4,5,6,8,9,10],aws_secret_access_kei:8,move:[9,4,6],elit:2,comma:[8,4],loginpass:[],release_vers:9,bunch:[],somecommand:6,taboot:[],infrastructur:[0,7,1,6],anyon:[],therefor:9,ansible_product_uuid:[],dag:[],greater:7,python:[0,2,4,5,7,8,9,10],auto:[5,8,4],dai:[],auth:4,devel:[],mention:[10,9,5,1,6],rubygem:[],instead:[0,9,4,1,10],surviv:4,strive:5,multiprocess:[],somewher:9,anyth:[5,8,4],edit:[0,8,4],slide:[],mode:[0,9,4,6,10],subset:[],grok:[],bump:[],strip:4,usernam:[4,10],ec2:8,our:[10,2],patch:[],pitfal:5,special:[8,4],out:[1,4,5,6,7,8,9,10],variabl:[0,1,4,5,6,7,8,9,10],twice:[],reboot:[4,6,10],security_group_:8,rel:[7,4,1],inaccess:4,"_default":[],leverag:0,ref:[],login_host:4,red:[8,5],clarifi:[],insid:[9,8,5,6],unpars:5,ansible_machin:[],control:[1,4,5,6,7,8,9,10],dictionari:[9,8,5,2],releas:[0,9,4,6],include_ansible_module_common:5,indent:2,could:[5,9,8,4,6],put:[0,1,4,6,7,9],fqdn:9,keep:[0,1,4,5,7,8,9],enforc:4,outsid:[8,5],adrian:[],retain:[],stuck:6,localdomain:[],delegate_to:[9,4],thessaloniki:[],qualiti:5,scene:4,echo:[0,8,9,6,10],exact:[],date:[0,5],puppet:[8,4],submit:5,owner:[4,10],facil:[],prioriti:[9,4],ansible_lo:[],perfectli:[],mkdir:10,system:[0,1,4,5,6,7,8,9,10],messag:[5,8,4],attack:[],pattern_goes_her:7,termin:10,"final":4,ipv4:9,shell:[4,5,6,8,9,10],ec2_descript:8,"var":[7,9,4,1,6],rst:[],nobodi:5,priveledg:[],dive:6,richer:[],intervert:9,charact:[8,2],sweden:[],favorit:9,deprec:7,sysadmin:[],ansible_processor_cor:[],have:[0,1,2,4,5,6,7,8,9,10],disadvantag:[],need:[0,1,2,4,5,6,7,8,9,10],cfengin:[],border:[],paramiko:[0,8],unexpect:[],min:[],mix:[7,9,6],baisc:[],tag_name_web:8,which:[0,1,2,4,5,6,7,8,9,10],datacent:[7,1,10],with_item:9,divers:[],singl:[9,8,4,6,10],ec2_security_group_nam:8,unless:[9,4,6],clash:[],deploy:[0,6,10],who:[8,4,6],salli:4,discov:[9,6],deploi:[9,4,6,10],comparison:[],why:1,serol:[],urg:1,inventory_hostname_short:9,url:4,gather:[9,4,6],request:[8,4],self_destruct_countdown:7,snapshot:[],determin:9,built:[0,9,8,4,10],constrain:10,fact:[5,9,4,6],text:[],verbos:[5,4,6],bring:6,playbook:[0,1,2,3,4,5,6,7,8,9,10],trivial:[0,5,8,4,9],anywai:7,varnam:6,redirect:10,locat:[7,9,4,6],tire:[],should:[0,1,2,4,5,6,8,9],ansible_swapfree_mb:[],won:[6,10],ec2_root_device_nam:8,"5px":[],local:[9,8,4],something_els:5,contribut:[0,5,4,10],notat:[],familiar:8,pave:[],autom:[1,10],somevar:9,increas:9,ansible_ssh_port:[],enabl:[5,4],organ:[4,1],bounc:[4,6],sudoer:4,sha:4,stuff:10,integr:[3,8,4],contain:[0,1,5,6,8,9],ymwaaaebalnasqn10tngsrde5arbsw8ctojqlyybciqgpytzw8zenerfxt7ij3fw3jh:4,view:[],legaci:4,cthy5bws9kmyjmeo0kfumh8hy4maxdokhq7dhbpircjs5jptogxirezjba67r6:4,nodeinfo:4,skynet:4,stack:9,gmail:[],statu:[5,9,4,10],wire:[],extend:[8,9,1,6],correctli:4,mainli:9,state:[1,4,5,6,7,9,10],viper:9,closed:4,progress:[],email:1,kei:[0,2,4,5,6,8,9,10],homedir:4,tempfil:6,job:[10,2],entir:[7,9,8,5,6],homebrew:0,"2pm":[],addit:[1,4,5,6,7,8,9],instant:[],southeast:7,admin:8,goal:[6,10],equal:[5,10],ohai_foo:[],etc:[0,4,6,7,8,9,10],instanc:[7,9,8,4,6],comment:[5,8,4,1],venv:4,guidelin:5,chmod:[5,8,4,6],distil:[],aristotl:[],rpm:[0,5,10],ini_fil:4,mailto:[],quit:[5,1],evalu:[9,10],platform:9,addition:[9,6,10],decent:[],compos:6,compon:8,json:[5,9,8,4,2],besid:5,treat:[5,1],ungroup:[],immedi:[9,4,6],"2677m":[],yournam:6,capistrano:[],global_var:1,vmware:[],togeth:[4,1,10],minim:[0,5],ador:[],atlanta:[7,8,10],present:[5,9,4,1,10],authorized_kei:[0,4],multi:6,plain:[],align:[],ansible_virtualization_typ:[],defin:[9,8,4,6],glossari:[],ultra:[],layer:8,almost:4,virt:4,site:[9,1],archiv:4,lightweight:8,partner:4,revis:[],michaeldehaan:[],surprisingli:[],scienc:[],welcom:8,parti:[],cross:[],member:[4,2],handl:[5,9,4],inc:[],ansibl:[0,1,2,3,4,5,6,7,8,9,10],difficult:[],policyv:[],http:4,structur:[9,4],denot:7,upon:[],effect:8,libvirt:4,php:10,distutil:0,pull:[8,9],audit:[9,1],off:[9,1],center:[],seth:[],object:5,exampl:[0,1,2,3,4,5,6,7,8,9,10],command:[0,3,4,5,6,7,8,9,10],interpol:9,undefin:4,latest:[0,9,4,6,10],lest:[],tunabl:1,distanc:[],paus:4,less:0,additon:0,obtain:4,starbuck:9,heavili:[],skill:2,simultan:10,web:[8,9,10],host5:8,cleanup:9,host3:[7,8],host2:[7,8],host1:[7,8],introduct:[4,6],kick:[9,10],knob:1,branch:[0,4],xmlrpc:8,dest:[9,8,4,6,10],piec:8,know:[2,4,5,7,8,9],nor:[],password:[0,9,4,6,10],recurs:[4,10],python3:0,python2:0,insert:4,motorola:[],like:[0,1,2,4,5,6,7,8,9,10],success:[5,4,6],amazonaw:8,necessari:10,lose:10,async:9,architectur:9,page:[0,10,2],ansible_hostnam:9,shed:[],revers:4,captur:5,twitter:[],linux:0,"export":[0,8],home:4,librari:[4,1,2],tmp:[8,4,6,10],lead:7,avoid:[0,4,6],thank:[],overlap:[],update_cach:4,encourag:[9,5,1,6],slight:8,importerror:[],usag:[1,4,5,7,9,10],symlink:[0,4],vhost:6,host:[0,1,4,5,6,7,8,9,10],although:5,simpler:[],about:[0,1,2,4,5,6,8,9,10],actual:[0,5,9,4],swear:[],discard:4,disabl:[4,6],ntp_server:7,own:[1,4,5,6,8,9],easy_instal:4,automat:[5,8,4,1,10],ec2_public_dns_nam:8,some_serv:7,hang:6,merg:5,van:[],transfer:[5,4,6,10],snmp:8,intention:[],trigger:[4,6],"8agepocvjdhyzr7pahfxzgudgktgrl2qzryukcmwo1czbmbhci5fzimvths9":4,replac:4,biggest:[],individu:[7,4,1],"function":[5,4],simplejson:[0,4],subscrib:[],nnwugi:[],continu:[5,9,4],ec2_plac:8,eas:[],inlin:8,eat:10,count:[9,6],succe:5,made:[5,9,4,6,7],config_mod:[],whether:[5,9,8,4,1],arg2:4,writeabl:6,asynchron:[9,6],record:2,below:[0,8,4,6],limit:[9,10],otherwis:[5,9,4],problem:[4,2],epel:0,pin:4,is_favcolor_blu:9,filenam:[9,4],ec2_tag_nam:8,implement:[8,5],ini:[7,8,4],mountpoint:4,pip:4,ing:4,probabl:[0,5,1,6],boot:4,detail:[8,5,6,10],virtual:[4,6],capabilit:[],other:[0,2,4,5,6,7,8,9,10],futur:[9,5],rememb:[6,10],varieti:[8,5],riak:[],servernam:[],ec2_external_inventori:8,repeat:[9,1],"class":[5,8,4,6],ansiblemodul:5,debian:[0,9,4],stai:9,sphinx:[],eof:4,amp:[7,8],scientif:0,reliabl:[],rule:[9,1,10],portion:7,emerg:[],name_of_host:[],"8btwaryr":4},objtypes:{},titles:["Getting Started","Best Practices","YAML Syntax","Contents","Ansible Modules","Module Development","Playbooks","Inventory & Patterns","API & Integrations","Advanced Playbooks","Command Line Examples And Next Steps"],objnames:{},filenames:["gettingstarted","bestpractices","YAMLSyntax","index","modules","moduledev","playbooks","patterns","api","playbooks2","examples"]}) \ No newline at end of file +Search.setIndex({objects:{},terms:{facter_operatingsystem:9,kickstart:9,comprimis:[],poorli:[],four:7,prefix:[9,8,4,6],sleep:9,forget:9,whose:9,tweet:[],ansible_default_ipv4:[],ebuild:0,ansible_default_ipv6:[],aur:0,under:[9,6],spec:6,everi:[1,2,4,6,9,10],risk:9,vastli:6,ansible_virtualization_rol:[],redact:[],upstream:[],affect:[5,4,6],virbr0:[],macaddress:[],ansible_config:10,showcas:5,cmd:[],supervisorctl:4,ansible_librari:[],shlex:5,vars_prompt:[9,1],saltstack:[],x86_64:8,awwxvv:[],seper:[7,9,4,6],direct:[4,6],chef:4,second:[9,8,4,10],tag_key_valu:8,blue:9,hide:9,thunder:[],children:7,constrast:[],"new":4,net:[0,2,4,5,7,8,10],ever:[7,8,5,6],told:6,elimin:[9,10],unpars:5,abov:[9,8,5,6,10],controlmast:0,eckersberg:2,hera:[],never:[5,8,4],here:[0,1,4,5,6,8,9,10],herd:[],"malm\u00f6":[],path:[1,4,5,6,7,8,9,10],interpret:7,datetim:5,permit:[],aka:[9,4],ansible_ssh_arg:0,somethingels:9,brought:[],substr:4,unix:[],cobblerd:8,ec2_:8,total:6,univ:[],unit:5,highli:5,describ:[1,6],would:[0,1,4,5,6,7,8,9,10],h3d850bdf:[],ansible_memtotal_mb:[],noarch:0,program:[5,9,4,6,2],overhead:[],until:[9,4],typo:5,recommend:[5,4,1],type:[5,9,8,4],tell:[7,4,10],notif:[],notic:[],warn:5,phone:[],exce:[],ec2_architectur:8,relai:6,ansible_transport:0,must:[5,9,8,4,6],join:[],restor:4,setup:[0,1,4,5,6,8,9],work:[0,1,4,6,7,8,9,10],anotherdb:4,erb:[],virttyp:4,ansible_ssh_host_key_rsa_publ:[],root:[0,1,4,6,9,10],scpnmy8rks7fyk8ulx0pei:4,os_default:9,give:2,rpath:[],indic:[4,6],app_serv:9,somefil:6,caution:4,want:[0,1,2,4,5,6,8,9,10],end:[5,4,6],hoc:[4,6,10],quot:[9,10],song:[],how:[1,2,4,5,6,7,8,9,10],hop:[],yum:[0,1,4,5,6,9,10],perspect:8,updat:[9,4,10],dialect:[],recogn:[6,10],passwordless:10,after:[1,4,5,6,7,8,10],lab:[],diagram:[],befor:[0,4,5,6,9,10],ohai_:[4,6],ec2_image_id:8,arch:0,parallel:[9,6,10],attempt:[0,4,6],interpol:9,ansible_product_seri:[],bootstrap:4,credenti:[4,10],exclud:7,greek:[],unpaus:4,maintain:[0,8,5],environ:[0,9,8,4,10],enter:9,exclus:9,idontknow:[],order:[9,4,6,10],oper:[0,9,4,6,10],frontend:9,over:[0,8,9,10,7],failur:[9,8,5,6],orang:2,becaus:[9,8,5,1,2],fifo:4,ec2_previous_st:8,rpmbuild:0,ansible_interfac:[],privileg:4,zeu:[],gather_fact:9,vari:9,myfil:4,streamlin:9,exit_json:5,cli:[8,10],img:[],fix:0,better:[0,4,10],offic:[],persist:4,mydb:4,easier:[5,1,2,10],them:[0,1,2,4,5,6,7,9],thei:[4,5,6,7,8,9,10],fragment:4,etc_acme_conf_acm:1,safe:6,ec2_ten:8,"break":6,band:[],glorifi:[],jinja2:[0,9,4,6],ec2_ip_address:8,mgmt:8,httpd_sys_content_t:[],ec2_region:8,choic:[0,5,4],vidal:[],bonu:8,timeout:[9,4],each:[1,2,4,5,6,7,8,9],debug:2,side:[],mean:[2,4,5,6,8,9],list:[0,1,2,4,5,6,7,8,9,10],playbooks2:[],logo:[],some_password:9,contend:[],network:9,dss:4,content:[0,1,3,4,5,6,7,8,9,10],dsl:[],adapt:[8,4],got:[],forth:6,a1b1c1d1:8,site_fact:[9,5],ntp:[7,4],nightmar:[],situat:4,free:[0,9,8,4],standard:[5,4,7],dotnet:2,fixm:[],md5:5,reconfigur:[9,1],openssh:0,traceback:5,isv:[],isn:[],rang:[7,4,10],render:4,clariti:[],wast:[],restrict:5,hook:[],instruct:0,alreadi:[0,4,5,6,8,9],van_halen_port:6,apt_repositori:4,massiv:[],primari:4,rewritten:[],top:[9,5,1,6],sometim:[9,4],destination_vari:8,master:8,too:[8,5,2],similarli:[8,9],john:2,outag:9,servi:4,iptabl:[],ansible_memfree_mb:[],tool:[0,8,9,10],took:[],"80ghz":[],somewhat:8,technic:[0,8,4],freemem:4,basho:[],target:[10,7,4,1,6],keyword:[9,4],provid:[1,2,4,5,6,8,9],tree:[5,8,4],project:[0,1,2,5,6,9],matter:10,ansible_distribution_releas:[],minut:[4,10],uses_cv:2,recheck:5,provis:[],fashion:[],yesno:[],close:[5,4],"_authorized_kei":[],runner:8,ram:[],mind:5,mine:4,raw:[0,4],aforement:7,seem:[9,6],seek:4,someapp:4,ec2_spot_instance_request_id:8,contact:[0,8,4],even:[0,8,9,6,7],though:[0,1,4,5,6,8,9],bruce:0,limitless:9,what:[0,1,2,4,5,6,8,9,10],regular:[4,6],motd_cont:9,bsd:0,boxsubscrib:[],simplic:[],don:[0,1,4,5,6,7,9,10],doc:[8,4],doe:[0,4,5,6,7,8,9,10],declar:6,wildcard:7,libpq:4,came:8,cobbler_external_inventori:[],abl:[9,4],random:6,syntax:[3,1,2,6,9,10],kerber:0,pkg:[9,4,6,10],radic:[],identifi:[],pki:[],ec2_private_ip_address:8,priv:4,involv:5,absolut:[4,10],northeast:7,acquir:[],explain:5,configur:[0,1,2,4,6,7,8,9,10],apach:[9,4,6,10],ec2_instance_typ:8,ec2_state_reason:8,ldap:8,folder:4,stop:[0,1,2,4,5,6,7,8,9,10],amazon:8,report:4,saturn:[],cellspac:[],bar:[7,8,6],host_var:7,excel:[7,9],method:[8,10],reload:4,bad:5,thessaloniki:[],richer:[],resist:1,result:[5,9,8,4,6],fail:[5,9,8,4,6],hash:[7,9,8,5,2],load_balanc:6,hammer:[],best:[3,1,4,5,6,8,9],subject:9,brazil:[],said:4,heterogen:1,databas:[9,8,4,6],discoveri:4,figur:[],simplest:[8,5],awai:9,irc:[0,2,4,5,7,8,10],approach:[8,9],attribut:[9,4],login_us:4,manpag:[],extens:[],unabl:[],kitchen:[],easi:[0,1,4,5,7,9,10],howev:[0,5,10,7],against:[7,9,6],logic:[],somelist:9,login:[4,6],com:[0,5,8,4,7],compromis:[],assur:[9,6],foobar:4,height:[],guid:[],assum:[7,8,4],ether:[],speak:4,recomand:4,multiplay:[],ansible_library_path:5,three:[7,4],been:[8,4,10],much:[2,4,6,8,9,10],interest:[0,8],basic:[0,1,2,4,5,6,7,8,9,10],ansible_bios_d:[],tini:9,quickli:10,life:[],recomend:5,nobodi:5,ani:[0,1,4,5,6,8,9,10],add_back_to_pool:9,mysql_us:4,dave:[],enterprisei:8,child:[],emploi:2,ugli:9,exception:[],east:8,servic:[1,4,5,6,7,8,9,10],properti:4,ec2_security_group_id:8,vars_fil:[9,1,6],aim:[],ain:[],contributor:[],conf:[9,8,4,1,6],module_nam:[7,8],somekei:5,sever:[8,4,6,2],cfengin:[],inventori:[0,1,3,4,6,7,8,9,10],incorrectli:4,perform:[0,9,6],suggest:4,make:[0,1,4,5,6,7,8,9,10],mayb:[],complex:[9,6],split:[7,5],complet:[8,9,1,2,6],wheel:[9,4],ansible_arch2:[],fragil:[],selevel:4,rail:[],hand:9,rais:[9,5],ownership:10,refin:[],tune:[9,10],speakerdeck:[],kept:6,scenario:8,thu:4,ansible_:9,hypothet:[],deal:[5,4],tho:[],client:4,"_concatenated_valu":[],thi:[0,1,2,4,5,6,7,8,9,10],endif:9,programm:8,everyth:[0,9],left:[],protocol:4,just:[0,1,2,4,5,6,8,9,10],photo:[],laptop:8,human:[6,2],braces_syntax:[],yet:[0,8,4,10],languag:[0,2,4,5,6,7,8,9],reboot:[4,6,10],expos:1,had:9,spread:[],board:8,els:[0,9,5,6],ffffff:5,save:[5,9,4,6],hat:[],gave:[],opt:4,applic:[9,8,4,6],supervisord:4,quirk:2,wai:[0,1,4,5,6,7,8,9],fusion:[],background:10,daemon:[],specif:[1,5,6,7,8,9,10],arbitrari:9,manual:6,remind:[9,5,1],unstabl:[],el6:[],unnecessari:[],groups_logo_sm:[],www:[7,4],right:[],ansible_form_factor:[],maxim:[],dead:[],born:[],intern:[8,5],heritag:[],successfulli:8,txt:[4,10],forcibl:[],bottom:6,cnf:4,tracker:0,somelog:4,foo:[4,6,7,8,9,10],localhost:4,core:[5,4,10],plu:[],sensibl:0,web2:8,web1:8,promot:[],repositori:[8,4,1],peer:[],"super":[],plug:8,sshd:[],postgresql:4,eat:10,surround:[],simul:9,"2ydx8":4,commit:1,produc:[5,4],duke:[],ppa:[0,4],xyz:10,encod:4,down:[8,4,6],contrib:[5,4],seboolean:4,install_recommend:4,storag:7,eth0:[],ec2_vpc_id:8,git:[0,1,4,5,7,9,10],fabric:[],suffici:9,support:[0,1,4,5,6,8,9,10],nova:8,happi:[],avail:[0,1,2,4,5,6,7,8,9,10],gif:[],reli:9,gid:4,wordpress:6,call:[2,4,5,6,7,8,9],war:[],fork:[8,9,10],head:[4,10],python26:0,form:[5,9,4,6,2],offer:[],forc:4,batman:0,forg:[],somehow:4,groupfil:7,"true":[5,9,4,6,2],freenod:[0,2,4,5,7,8,10],absent:[5,4,1,10],inquir:5,maximum:[9,4],mtu:[],ansible_fqdn:[],rerun:6,ansible_bios_vers:[],featur:[0,1,4,6,7,8,9],"abstract":[],fedoraproject:[],exist:[4,6,7,8,9,10],door:[],ship:[5,8,4],check:[5,9,4,10],assembl:4,self_destruct_countdown:7,encrypt:[],meanwhil:[],tip:[7,9,1,6],role:[9,4,1,6],test:[0,5,8,4,9],tie:8,unlimit:[],maxrequestsperchild:7,assmebl:4,relat:[],intend:5,phoenix:7,devop:[],intent:[],consid:[5,1,6],doubl:10,receiv:[],faster:[9,5],anywher:[],ignor:[5,9,4,6],time:[0,2,4,5,6,7,8,9,10],push:[9,6],concept:[8,9,1,10],ansible_hostnam:9,vpc:8,chain:[],"5rxgmiicbrh":4,skip:[9,6],consum:[],invent:[],skim:[],fail_json:5,operatingsystem:9,decid:[9,8,5,6,10],middl:[],depend:[0,5,9,4],lemonad:4,zone:8,flask:4,graph:[],readabl:[1,6],decis:9,downtim:4,southwest:7,sourc:[0,1,2,4,5,6,8,9,10],string:[5,4,6],condit:[9,6,10],word:[8,9],brows:5,ansible_virbr0:[],jdk:4,administr:[],level:[4,6,2],did:[9,8,5],passno:4,item:[8,9,2],team:[],quick:0,ansible_product_nam:[],prevent:5,slower:0,trend:4,ec2_platform:8,anaconda:9,port:[7,4,10],favcolor:[9,8,5],ansible_distribution_vers:[],current:[0,5,9,4,10],suspect:[],ceec4eif7ya:4,deriv:[],gener:[0,4,5,6,8,9],httpd_can_network_connect:4,address:[1,4,5,7,8,9,10],along:[5,6],wait:[9,4],box:[4,10],precursor:[],alta:[],extrem:[0,9,5],bob:[4,6],bof:4,ourselv:6,overrid:[0,8,9],love:[],extra:[9,1],tweak:1,modul:[0,1,3,4,5,6,8,9,10],userdel:4,prefer:[7,9,5,10],mzdywqlw:4,baisc:[],instal:[0,4,5,6,9,10],mobil:[],httpd:[7,9,4,6,10],hyperspac:[],yamllint:2,priv2:4,prove:9,is_cento:9,univers:[],visit:[],perl:10,live:[0,9,10],handler:[10,4,1,6],criteria:9,msg:[8,5],scope:[],checkout:[0,5,9,4],ntpserver:8,chapter:6,idempot:[5,4,6,10],share:[0,9,8,5],claus:9,enhanc:8,templat:[1,4,5,6,8,9,10],easiest:[0,8,9],get_xml:4,ibm:[],module_arg:8,prepar:[],uniqu:8,cat:9,insertaft:4,respond:[8,4,6],whatev:[9,5],purpos:[7,4,1,6],boilerpl:5,claim:1,hostvar:9,argument_spec:5,pkgbuild:0,chip:[],agent:[0,10],critic:[],occur:6,alwai:[5,4,1,6],multipl:[1,4,6,7,8,9,10],ping:[0,8,4],uptim:8,write:[1,2,4,5,6,8,9],purg:4,pure:[],somevalu:[9,5],parameter:[9,6],map:[8,6],product:[9,4],mar:[],max:10,clone:[0,5],usabl:6,membership:[9,10],mai:[0,1,2,4,5,6,8,9,10],underscor:8,data:[2,4,5,6,7,8,9],man:[],poseidon:[],practic:[3,1,2,4,6,9],seuser:4,explicit:[],predic:4,inform:[9,8,4,6,10],"switch":[],preced:9,combin:2,talk:[10,0,8,6,7],ender:[],ec2_statu:8,nbsp:[],ec2_id:8,cold:4,still:[0,9,8,5,6],pointer:5,ec2_virtualization_typ:8,facter_:[4,6],jid:10,overlord:[],group:[0,1,2,4,5,6,7,8,9,10],monitor:8,polici:4,yaml:[3,1,2,6,7,9],window:9,curli:[],intl:[],mail:[0,1,2,4,5,6,7,8,9,10],job_statu:[],main:[9,5,1,6],basenam:4,security_group_pete_s_fancy_group:8,non:[5,4,6,7],env:0,contriv:[],ansible_all_ipv4_address:[],initi:[],l6pmiam1a8ywep:4,half:[],now:[0,4,5,6,8,9,10],discuss:[],setyp:4,shoudl:[],halon_system_timeout:7,term:[5,10],name:[0,1,2,4,5,6,7,8,9,10],config:[8,4,6,10],didn:10,crypto:[],separ:[8,4,1,6],rock:[],domain:[],arg1:4,laserllama:[],ngnix:4,yeah:[],wrap:[],backport:[0,4],facter:[9,4,6],happen:[5,8,4],likes_emac:2,subnet:8,shown:5,space:4,infrar:[],profil:[8,4],intermix:[],skylin:[],internet:[],correct:[8,9,6,2],ksmeta:8,lag:4,state:[1,4,5,6,7,9,10],migrat:[],argv:5,args_fil:5,theori:6,org:[0,4,10,7],ymwaaaebalnasqn10tngsrde5arbsw8ctojqlyybciqgpytzw8zenerfxt7ij3fw3jh:4,card:[],care:[4,6],reusabl:5,couldn:[],frequenc:9,synchron:[9,6],thing:[0,1,2,5,6,7,9,10],place:[5,9,4],raleigh:[7,10],router:4,think:[9,5,1],frequent:[8,9],first:[0,4,5,7,9,10],origin:4,directli:[4,5,6,7,8,10],onc:[1,4,5,6,7,9],arrai:9,yourself:6,fast:0,oppos:10,open:[5,9,4,6],tomorrow:[],somegroup:4,given:[9,4,1,10],args_data:5,convent:[8,5],width:[],fierc:[],silenc:4,white:5,friend:[],includ:[1,4,5,6,7,8,9,10],especi:[9,1],copi:[0,9,8,4,10],specifi:[0,2,4,5,6,8,9,10],retyp:0,netmask:[],github:[0,1,2,4,5,6,8,9],mostli:1,than:[0,1,2,4,5,6,7,8,9,10],cmdb:8,serv:[],wide:[],ec2_private_dns_nam:8,balanc:9,were:[9,6,10],pre:4,sai:[0,9,4,6,10],nicer:[],id_webservergroup:8,argument:[5,8,4,6,7],dash:[8,2],loki:[],sat:[],engin:[],squar:[],alias:5,destroi:4,southeast:7,note:[0,4,5,6,8,9,10],altogeth:[],ideal:9,includedir:[],take:[5,9,4,6,10],noth:[4,6,2],channel:[0,2,4,5,7,8,10],begin:[4,10,2],sure:[8,9,6,10],normal:[8,10],track:[7,9,10],beta:[],pair:[8,5,2],adopt:[],take_out_of_pool:9,runtim:9,mysql_db:4,show:[9,5,6,10],cheat:[],aggregr:5,geographi:1,permiss:[0,4,10],hack:[0,5],help:[0,1,2,4,5,6,7,8,9,10],xml:2,onli:[0,4,5,6,8,9,10],explicitli:[4,6],transact:9,activ:4,enough:[7,10],dict:5,analyz:9,analyt:[],nearli:[4,2],variou:[9,8,4,6,10],get:[0,2,3,4,5,6,8,9,10],soon:[],repo:[5,8,4,10,7],ssl:[],cannot:[9,4,6],ssh:[0,4,7,8,9,10],requir:[0,1,4,5,8,9,10],some_file_path_foo:1,through:[0,4,10],where:[0,1,4,5,8,9],summari:6,wiki:4,hierachi:[],testserv:[],ansible_product_vers:[],fff:[],ansible_distribut:9,concern:6,detect:4,kei:[0,2,4,5,6,8,9,10],innov:[],review:[9,4,1,6],enumer:9,estat:[],ansible_system_vendor:[],between:[0,9,1,6],my_app:4,"import":[9,8,5,6,10],across:8,fundament:4,guitar:[],cycl:0,come:[5,6],timmi:6,region:[8,10],contract:8,tutori:5,abc123:8,mani:[4,5,6,8,9,10],setenforc:6,among:9,color:[9,5],overview:2,inspir:[],period:9,colon:[7,6],inventory_hostnam:[9,4],homebrew:0,typic:[6,10],poll:[9,4,10],other_vari:9,coupl:[],west:8,rebuild:[],rubi:[5,9,4,10,2],those:[8,9,6,10],"case":[4,5,6,8,9,10],mount:4,md5sum:[],straighten:[],trick:6,cast:5,invok:[],cobbler:8,invoc:4,default_releas:4,newhost:4,advantag:[9,10],stdout:[8,9],canon:4,worri:9,destin:[8,4],cluster:4,myapp:[9,4,10],rktgjk2httvs6gigvsuwwfod7:4,chkconfig:[],trival:5,http_port:[7,6],develop:[0,1,2,3,4,5,6,8,9],ansible_architectur:[],author:[4,1],media:[],econom:[],same:[0,1,2,4,6,7,8,9,10],binari:0,html:[],pad:[],pai:10,document:[1,2,4,5,6,8,9,10],week:[],webserv:[1,4,6,7,8,9,10],closest:[],ec2_subnet_id:8,nest:[5,9,4],driven:[],capabl:1,fruit:2,interventori:[],improv:5,extern:[8,9,1],appropri:[9,8,4],markup:[],clobber:4,without:[0,5,4],promis:[],model:[],roughli:0,execut:[0,4,5,6,8,9,10],when:[1,4,5,6,8,9,10],rest:5,kill:6,speed:0,aws_access_key_id:8,versu:[0,1],europ:[],miscellan:1,trigger:[4,6],except:[8,5],littl:[],otherus:10,blob:[],notori:[],vulner:[],real:[0,9,6],ignore_error:9,around:[],ohai:[9,4,6],read:[0,2,4,5,8,10],dark:8,temperatur:4,grid:[],mon:[],world:[0,9,6],intel:[],whitespac:1,realtim:[],ak123:8,integ:[],server:[4,6,7,8,9,10],rycsbf1d8e5ptxesxhqs4iq:4,output:[5,8,4,6],manag:[0,2,4,6,7,8,9,10],ec2_kernel:8,node:[0,4,6,8,9,10],sneaker:[],jquery_directori:[],titan:[],altalang:[],server01:[],loopback:[],ansible_processor:[],noon:[],definit:[],legal:[5,1],moon:[],sr0:4,exit:[8,5,6],complic:[],refer:[9,8,4,6,10],ansible_swaptotal_mb:[],power:[0,1,5,6,8,9],broken:1,fulli:[0,4],regexp:4,"throw":5,earlier:[0,6],src:[9,8,4,6,10],stone:5,central:9,greatli:[],get_url:4,acm:[7,9,4,1,10],wolf:8,stand:4,act:4,industri:[],mytempl:4,backup:4,other:[0,2,4,5,6,7,8,9,10],effici:9,terminolog:8,anothert:4,somescript:4,multinod:[],puppetmast:[],your:[0,1,4,5,6,7,8,9,10],charli:4,stare:5,log:[5,9,8,4,6],area:[],aren:[],catn:[],privileged_us:[],start:[0,1,2,3,4,6,8,10],interfac:8,low:4,lot:[7,9,5,1,10],ipv6:[],ansible_all_ipv6_address:[],bundl:1,vpc_destination_vari:8,denomin:1,congratul:0,longer:5,strawberri:2,dirti:[0,4],possibl:[1,4,5,6,7,8,9,10],"default":[0,4,5,7,8,9,10],ansible_fact:5,stacktrac:5,connect:[0,9,8,4],tasti:2,uid:4,creat:[0,4,6,8,9,10],certain:[9,4,6],deep:6,strongli:1,mainli:9,deferenc:[],file:[0,1,2,4,5,6,7,8,9,10],my_custom_fact_can_be_used_now:9,again:[8,5,6],halen:[],googl:[0,1,2,4,5,6,7,8,9,10],compel:[],repositor:4,orient:6,valid:5,anotherconf:4,global_var:1,you:[0,1,2,4,5,6,7,8,9,10],external_var:9,poor:5,regardless:[6,2],sequenc:[],symbol:4,signficantli:0,briefli:6,"60k":[],postgresql_us:4,directori:[1,2,4,5,6,8,9,10],invest:[],descript:[4,1,6],chown:4,potenti:9,qeuz:4,cpu:[],all:[0,1,2,4,5,6,7,8,9,10],consider:8,selinux:[4,6],lack:[],mnt:4,month:0,scalar:5,abil:6,follow:[0,4,7,8,9,10],alt:[],disk:4,scp:10,nors:[],articl:[5,4],init:4,dehaan:[],mcollect:[],arbitari:2,introduc:[],sound:8,liter:4,tag_name_redi:8,"1pm":[],fals:[5,9,4,2],faq:[],fav:4,util:[],mechan:[],fall:[9,4],veri:[0,1,4,5,6,8,9,10],condition:6,database_serv:7,colleagu:[],pbx:[],sane:[],stderr:5,small:[9,8,4,2],testuser2:9,testuser1:9,enterpris:0,yetanotherdb:4,strung:10,zero:[7,5,6],design:[7,4,10],pass:[0,4,5,6,8,9,10],further:[9,10,2],sudo_us:6,deleg:9,sub:[],section:[0,1,4,6,7,8,9,10],ffff:[],delet:[4,6,10],abbrevi:2,version:[0,1,4,6,7,9,10],"public":[9,8,4],php:10,movement:[],hasn:[],full:[9,4,6],themselv:[],filelinkdirectoryabs:[],shouldn:9,first_available_fil:9,strong:[],modifi:[5,8,4],fail_on_us:4,valu:[2,4,5,6,8,9,10],search:4,ahead:[0,6],likin:[],memcach:[9,6],prior:[9,4],amount:8,pick:10,action:[9,8,4,6],via:[0,9,8,4],shorthand:[5,9,4],factnam:9,ec2_state_cod:8,managememnt:[],href:4,select:[1,4,5,6,7,9,10],distinct:[],ec2_stat:8,regist:9,two:[7,8,4,6],rhel:0,virt:4,taken:6,kick:[9,10],toggl:4,more:[0,1,4,6,7,8,9,10],flat:6,desir:[5,4,6,7],hundr:[],flag:[0,4,6,10],particular:[4,6,7,8,9,10],known:4,compani:5,cach:[8,4],none:[0,8,4],hour:4,hous:[],launch:[9,6],dev:4,remain:[],learn:[0,1,2,5,6,7,9],deb:4,nagio:4,instantan:[],prompt:[9,6,10],useabl:4,moduledev:[],accept:[5,4],minimum:[9,5,6],explor:[0,8],pong:4,cygat:[],cours:[9,1],newlin:[],secur:[9,8,4],rather:[7,9,5],anoth:[1,2,4,6,9,10],scienc:[],simpl:[1,2,4,5,6,8,9,10],css:[],distro:8,resourc:[5,9,4,6],referenc:[7,9,6],variant:0,fstype:4,ff0000:5,neccesssari:[],unlink:4,associ:[8,4,2],signfic:5,"short":[0,9],django:4,caus:0,callback:8,opscod:4,rotat:6,xmpp:[],mission:[],uvh:0,commonli:[10,2],scott:[],hierarchi:[],hell:[],suffer:[],paramet:[0,1,4,5,6,9,10],style:[5,9,4],psycopg2:4,cowsai:[9,6],pend:[],rapidli:[8,9],might:[7,9,8,5,6],wouldn:8,good:[0,9,8,5,6],"return":[5,9,8,4,6],lineinfil:4,food:2,timestamp:4,framework:8,botnet:[],odin:[],neccessari:9,troubleshoot:[],unlik:6,authent:4,mysteri:9,easili:[0,8,9,10],achiev:5,found:[5,9,8,4],only_if:[9,6],id_rsa:[0,4,10],subsystem:4,harm:[],mental:[],hard:5,idea:[0,1,2,4,5,6,7,8,9,10],crontab:9,realli:[5,8,4,6,2],expect:[8,9,6],variablenam:[],beyond:9,event:[5,8,4,6],ftp:4,safeti:[],pigeon:8,research:[],bubbl:[9,4,6],print:[8,5],yaml_to_ini:7,qualifi:4,postgr:[4,6],proxi:[7,9,4],advanc:[0,1,3,6,8,9],pub:[4,10],reason:[9,8,5,6],base:[9,4,1],believ:[],ask:[0,6,10],bash:[0,5,10],basi:6,thrown:[],pyyaml:0,sytem:[],daisi:[],drupal:[],omit:[4,1],american:[],ansible_system:[],assign:[7,9,4,1],feed:[],sdwippefq74nppvuelhpkkaiojjnn1zuhfol:4,notifi:[10,5,4,1,6],obviou:[],feel:[8,9,2],exchang:9,number:[7,9,4],placehold:[9,6],done:[0,9,4,1,7],least:[9,1],blank:[],stabl:[0,4],fiction:[],miss:4,differ:[0,1,4,6,7,8,9,10],list_vm:4,guest:4,script:[4,5,7,8,9,10],interact:[8,10],construct:[8,9,6],camelot:9,make_databas:4,statement:[9,5,6],natur:[],banana:[],store:[7,9,4],option:[0,1,4,5,6,7,8,9,10],behind:[],selector:10,part:[5,9,4],ec2_key_nam:8,consult:8,reinstal:[],cron:9,kind:5,grep:4,whenev:5,remot:[0,4,6,8,9,10],gotten:[],remov:[7,9,4,10],jqueri:[],reus:[9,6],architect:[],str:5,jvmdhw:[],toward:9,cleaner:9,comput:8,seth:[],group_var:7,biggest:[],packag:[0,1,4,5,6,9,10],wait_for:4,imagin:[],createhom:4,equival:[9,4],self:5,"123i":[],also:[0,1,2,4,5,6,7,8,9,10],build:[0,5,8,4],brace:[],distribut:[0,1],passwd:[],english:[],reach:1,most:[0,1,2,6,8,9,10],plai:[9,6],plan:[],alpha:4,filesystem:9,clear:1,cover:[8,9],dereferenc:[],clojur:5,clean:[],pars:5,latest:[0,9,4,6,10],awesom:[],commerc:[],ansible_processor_count:[],tri:4,alphanumer:8,devolv:[],mpd_ring:[],particularli:[8,9,6],fine:[0,5],find:[9,8,5,6,10],impact:[],firewal:9,nosql:[],pretti:[8,9],solut:[],security_group_default:8,olympu:[],ansible_selinux:[],yml:[9,1,6],remedi:9,long_running_oper:10,financ:[],nativ:[0,8,9],silli:[],him:[],restart:[10,7,4,1,6],mdehaan:10,puppetlab:4,dollar_sign_syntax:[],common:[9,8,5,1,2],wrote:5,set:[0,1,4,5,6,7,8,9,10],dump:[5,4],creator:[],security_group_webserv:8,see:[0,1,2,4,5,6,7,8,9,10],sec:9,arg:5,transpar:0,disadvantag:[],setsebool:6,analog:[],expert:[],someth:[9,8,5,1,6],restructur:6,hold:9,experi:[],altern:[9,10],solo:[],numer:[],aserv:0,solv:[],tag_aws_cloudformation_log:8,foo_port:[],popul:8,both:[0,4,5,8,9,10],last:0,delimit:4,boto:8,thor:[],uncrypt:6,context:4,whole:4,ec2_root_device_nam:8,load:[9,4],simpli:[8,4,1,6],point:[9,4,1],instanti:5,schedul:4,etc_other_conf_oth:1,header:7,shutdown:[9,4],suppli:[],asdf:[],backend:[],unsuccess:6,java:4,instrument:[],devic:4,due:[0,5],empti:8,ran:[],enable_alert:4,escape_pod:7,strategi:[],wish:[0,8,9,6,2],fire:9,imag:[],great:[9,5,1,6],gap:[],understand:[9,6],func:[],educ:5,look:[4,5,6,7,8,9,10],straight:10,batch:10,"while":[9,4,1,6],unifi:[],smart:[4,10],facter_hostnam:6,error:[5,9,4],cleanup:9,loop:[9,6],pack:8,gimm:[],pragmat:[],motd:[8,9,6],max_client:6,readi:4,readm:[],jpg:[],itself:[0,8,4],cento:[0,9],unmount:4,fedora:0,grant:4,login_usernam:4,belong:8,shorter:5,higher:[0,9],"10gen":4,optim:1,painless:[],alert:4,moment:8,temporari:[],user:[0,1,4,5,6,8,9,10],yesterdai:[],recent:[],lower:[],task:[10,9,4,1,6],lib:5,older:4,entri:10,lizenzfrei:[],spent:[],expens:8,endfor:9,spend:[],explan:5,ec2_monitor:8,mysql:4,openstack:8,centos6:8,shortcut:5,async_wrapp:5,win:[],input:[9,5],bin:[0,4,5,6,7,8,9,10],march:5,format:[7,8,4,6,2],folk:[0,10],judgement:4,nginx:4,game:[],quest:9,bobdata:4,insert:4,bit:[9,4,6],abduct:[],ec2_ownerid:8,like:[0,1,2,4,5,6,7,8,9,10],name_of_fact:[],knock:[],capital_of_assyria:[],signal:[8,4],"98dbcgqw5hme89cjgzro5ktkc5yu":4,manifest:[],api:[3,5,8,4],popular:[],cmdfile:4,postgresql_db:4,encount:4,often:[9,8,4,1],simplifi:10,creation:10,some:[0,1,4,5,6,7,8,9,10],back:[0,9,4,6,10],sampl:10,mirror:[],virtualenv:4,scale:9,ec2_tag_kei:8,per:[9,8,4],pem:0,substitut:6,mathemat:[],larg:9,either:[9,8,4],machin:[0,1,4,5,6,8,9,10],previou:9,run:[0,2,4,5,6,7,8,9,10],step:[0,3,4,6,7,9,10],squeez:4,meantim:[],major:8,impor:[],ec2_launch_tim:8,priv1:4,othervar:[],ansible_eth0:9,block:9,fulfil:6,steelhous:[],primarili:4,unreach:6,pythonpath:[],within:[7,8,9,6],ensur:[0,9,4,6,10],subvers:4,bserver:0,rxp33wfphjwjwvhatfci1nrbaudqi:4,inclus:7,span:4,few:[8,4],group_nam:9,question:[0,1,2,4,5,6,7,8,9,10],"long":[0,9,10],custom:9,pocoo:4,suit:6,forward:[],datastructur:8,host5:8,foosbal:[7,4],lint:2,link:[5,4],translat:[],newer:0,line:[0,2,3,4,5,6,7,8,9,10],info:[8,4,10],concaten:4,consist:5,caller:4,planet:[],schmooz:[],ec2_dns_nam:8,highlight:[],similar:[7,9,8,4,10],curv:[],module_common:5,constant:1,parser:5,doesn:[9,8,4,10,2],repres:[8,6,2],chat:[0,2,4,5,7,8,10],behavior:[0,9,4,10],coder:[],crypt:[4,10],chgrp:[],disable_alert:4,bracket:7,librari:[4,1,2],peopl:9,nice:6,draw:[],mongodb:4,asciidoc:[],meaning:[],svn:4,happier:[],dvd:4,bofeof:[],depth:8,far:[10,2],hello:0,jupit:[],login_host:4,local_act:9,pluggabl:[],code:[1,4,5,6,8,9,10],alien:[],update_cach:4,async_statu:10,privat:[0,8,9],sensit:9,elsewher:[],friendli:[],send:[8,9],autostart:4,sens:[0,8,4,6],fatal:[5,6],blindingli:[],sent:5,sensic:[],logtre:4,whichev:[],spool:[],implicitli:[],ec2_root_device_typ:8,relev:[9,5],recip:0,magic:[9,5,6],roll:9,ansible_kernel:[],michael:[],fewer:9,"try":[0,4,5,6,8,9],p2xkxaczh6fc:4,pleas:[0,8,4],malici:[],impli:[],cfg:10,focu:[],jump:0,gmbh:[],mysqldb:4,download:[0,4],ansible_python_interpret:7,append:4,index:[8,4],turn:[9,5],compar:[],access:[0,9,8,4],experiment:9,can:[0,1,2,4,5,6,7,8,9,10],chose:[],let:[0,2,4,5,6,8,10],ubuntu:[0,8,4],becom:9,sinc:[8,4,1,10],convert:[8,5],convers:7,hypervisor:[],technolog:[],"_some_str":6,later:[0,4,5,6,7,9,10],unsil:4,chang:[1,4,5,6,7,9,10],maker:[],hardi:4,fstab:4,heart:8,appli:[7,9,4,6],app:9,gatewai:[],apt:[9,4,1,10],austria:[],"boolean":[5,4,2],cloud:[],fed:[4,6],from:[0,1,2,4,5,6,7,8,9,10],usa:7,commun:[8,4,6],"8b3satjxmpgbfbueebwubk5ejl":4,frob:4,upgrad:[4,6,10],next:[0,3,4,6,7,9,10],ansible_python_vers:[],usr:[0,4,5,6,7,8,9,10],remaind:8,sort:4,"8agepocvjdhyzr7pahfxzgudgktgrl2qzryukcmwo1czbmbhci5fzimvths9":4,dbserver:[10,7,9,1,6],impress:9,about:[0,1,2,4,5,6,8,9,10],trail:1,train:[],login_password:4,ansible_nocolor:9,starter:[5,6],account:[0,4,6,10],chdir:4,retriev:[9,4],scalabl:[],tunnel:[],alia:[5,4,7],openjdk:4,alic:6,obvious:9,ec2_ramdisk:8,fetch:[9,4],proof:5,employe:2,tab:6,tar:0,process:[4,6,10],lock:9,sudo:[0,4,6,10],high:[5,10],knows_oop:2,tag:[0,9,8,4,6],thirsti:4,tarbal:[],onlin:2,serial:9,delai:4,surfac:[],orson:[],lame:2,mysql_root_password:[],"_assembl":[],lepton:5,swear:[],subdirectori:4,srv:[9,8,4,6,10],panic:9,stock:[],express:[2,4,5,6,8,9],gentoo:0,watch:[],attent:10,tier:[],philosophi:[],ansible_host:0,orchestr:6,correspond:4,element:[9,8,5],issu:[0,4],allow:[0,1,4,5,6,8,9,10],aws_secret_access_kei:8,move:[9,6],elit:2,comma:[8,4],loginpass:[],release_vers:9,bunch:[],somecommand:6,taboot:[],infrastructur:[0,7,1,6],anyon:[],therefor:9,ansible_product_uuid:[],dag:[],greater:7,python:[0,2,4,5,7,8,9,10],auto:[5,8,4],dai:[],auth:4,devel:[],mention:[10,9,5,1,6],rubygem:[],instead:[0,9,4,1,10],surviv:4,strive:5,multiprocess:[],somewher:9,anyth:[5,8,4],edit:[0,8],slide:[],mode:[0,9,4,6,10],subset:[],grok:[],bump:[],strip:4,usernam:[4,10],ec2:8,our:[10,2],patch:[],some_serv:7,special:[8,4],out:[1,4,5,6,7,8,9,10],variabl:[0,1,4,5,6,7,8,9,10],twice:[],presentabs:[],security_group_:8,rel:[7,4,1],inaccess:[],"_default":4,merg:5,ref:[],reg:[],red:[8,5],clarifi:[],insid:[9,8,5,6],manipul:10,ansible_machin:[],control:[1,4,5,6,7,8,9,10],dictionari:[9,8,5,2],releas:[0,9,4,6],include_ansible_module_common:5,indent:2,could:[5,9,8,4,6],put:[0,1,4,6,7,9],fqdn:9,keep:[0,1,4,5,7,8,9],enforc:4,outsid:[8,5],adrian:[],retain:[],stuck:6,localdomain:[],delegate_to:[9,4],softwar:[9,8,4,1,10],qualiti:5,scene:[],echo:[0,8,9,6,10],exact:[],date:[0,5],puppet:[8,4],submit:5,owner:[4,10],facil:[],prioriti:[9,4],ansible_lo:[],perfectli:[],mkdir:10,system:[0,1,4,5,6,7,8,9,10],messag:[5,8,4],attack:[],pattern_goes_her:7,termin:10,"final":4,ipv4:9,shell:[4,5,6,8,9,10],ec2_descript:8,"var":[7,9,4,1,6],rst:[],exactli:[5,9,4],priveledg:[],dive:6,daemonless:[],intervert:9,charact:[8,2],sweden:[],favorit:9,deprec:7,sysadmin:[],ansible_processor_cor:[],have:[0,1,2,4,5,6,7,8,9,10],tabl:[7,8,4],need:[0,1,2,4,5,6,7,8,9,10],asdf1234l:4,border:[],paramiko:[0,8],simplejson:[0,4],min:[],mix:[7,9,6],mango:2,tag_name_web:8,which:[0,1,2,4,5,6,7,8,9,10],datacent:[7,1,10],with_item:9,divers:[],singl:[9,8,4,6,10],ec2_security_group_nam:8,unless:[9,4,6],clash:[],deploy:[0,6,10],who:[8,4,6],salli:4,discov:[9,6],deploi:[9,4,6,10],comparison:[],why:1,serol:4,urg:1,inventory_hostname_short:9,url:4,gather:[9,4,6],request:[8,4],pipe:[4,10],snapshot:4,determin:9,built:[0,9,8,4,10],constrain:10,fact:[5,9,4,6],text:[],verbos:[5,4,6],bring:6,playbook:[0,1,2,3,4,5,6,7,8,9,10],trivial:[0,5,8,4,9],anywai:7,varnam:6,redirect:10,locat:[7,9,4,6],launchpad:4,tire:[],should:[0,1,2,4,5,6,8,9],ansible_swapfree_mb:[],won:[6,10],suppos:[7,9,5,6,10],"5px":[],local:[9,8,4],something_els:5,contribut:[0,5,4,10],notat:[],familiar:8,pave:[],autom:[1,10],somevar:9,increas:9,ansible_ssh_port:[],ohaidata:4,enabl:[5,4],organ:[4,1],bounc:[4,6],sudoer:4,sha:4,stuff:10,integr:[3,8,4],contain:[0,1,5,6,8,9],grab:[],view:[],legaci:4,cthy5bws9kmyjmeo0kfumh8hy4maxdokhq7dhbpircjs5jptogxirezjba67r6:4,nodeinfo:4,skynet:[],stack:9,gmail:[],statu:[5,9,4,10],wire:[],extend:[8,9,1,6],correctli:[],pattern:[0,1,3,4,6,7,8,9,10],written:[0,9,8,5,6],viper:9,closed:[],progress:[],email:1,ansible_ssh_host_key_dsa_publ:[],homedir:[],tempfil:6,job:[10,2],entir:[7,9,8,5,6],webapp:[4,10],"2pm":[],addit:[1,4,5,6,7,8,9],revers:4,instant:[],plugin:8,admin:8,goal:[6,10],equal:[5,10],ohai_foo:[],etc:[0,4,6,7,8,9,10],instanc:[7,9,8,4,6],comment:[5,8,4,1],venv:4,iso9660:4,guidelin:5,chmod:[8,5,6],structur:[9,4],distil:[],aristotl:[],rpm:[0,5,10],ini_fil:4,mailto:[],quit:[5,1],pin:4,platform:9,addition:[9,6,10],decent:[],compos:6,compon:8,json:[5,9,8,4,2],besid:5,treat:[5,1],ungroup:[],immedi:[9,4,6],"2677m":[],yournam:6,capistrano:[],presenc:4,vmware:[],togeth:[4,1,10],minim:[0,5],ador:[],atlanta:[7,8,10],present:[5,9,4,1,10],authorized_kei:[0,4],multi:6,plain:[],align:[],ansible_virtualization_typ:[],defin:[9,8,4,6],glossari:[],ultra:[],layer:8,almost:4,demo:10,site:[9,1],archiv:4,lightweight:8,partner:4,revis:[],michaeldehaan:[],surprisingli:[],halt:[],welcom:8,parti:[],cross:[],member:2,handl:[5,9,4],probabl:[0,5,1,6],ansibl:[0,1,2,3,4,5,6,7,8,9,10],difficult:[],policyv:[],http:4,hostnam:[7,9,8,4,6],denot:7,drink:4,upon:[],effect:8,libvirt:4,collat:4,distutil:0,pull:[8,9],audit:[9,1],off:[9,1],center:[],well:[0,1,4,5,6,7,8,9,10],object:5,exampl:[0,1,2,3,4,5,6,7,8,9,10],command:[0,3,4,5,6,7,8,9,10],choos:[0,4,6],undefin:4,usual:[6,10],lest:[],tunabl:1,distanc:[],paus:4,less:0,additon:0,obtain:4,detail:[8,5,6,10],heavili:[],skill:2,simultan:10,web:[9,8,4,10],jinja:4,add:[0,1,4,5,8,9,10],host4:8,host3:[7,8],host2:[7,8],host1:[7,8],introduct:[4,6],match:[5,4,6],knob:1,rememb:[6,10],xmlrpc:8,dest:[9,8,4,6,10],piec:8,know:[2,4,5,7,8,9],nor:[],password:[0,9,4,6,10],recurs:[4,10],python3:0,python2:0,loss:[],motorola:[],xaby9ud5brbfvkedu:4,success:[5,4,6],amazonaw:8,necessari:[4,10],lose:10,async:9,architectur:9,page:[0,10,2],eucalyptu:8,shed:[],drop:[8,5],captur:5,twitter:[],linux:0,"export":[0,8,4],home:4,transport:[0,8],tmp:[8,4,6,10],lead:7,avoid:[0,4,6],thank:[],overlap:[],leav:[5,9,4,1],encourag:[9,5,1,6],slight:8,importerror:[],usag:[1,4,5,7,9,10],symlink:[0,4],vhost:6,host:[0,1,4,5,6,7,8,9,10],although:5,simpler:[],sbin:[9,4,6,10],actual:[0,5,9,4],free_form:4,carrier:8,discard:4,disabl:[4,6],ntp_server:7,own:[1,4,5,6,8,9],easy_instal:4,automat:[5,8,4,1,10],ec2_public_dns_nam:8,pitfal:5,hang:6,leverag:0,trim_block:4,van:[],transfer:[5,4,6,10],snmp:8,intention:[],appl:2,pool:9,replac:4,hassl:[],individu:[7,4,1],"function":[5,4],unexpect:[],subscrib:[],nnwugi:[],continu:[5,9,4],ec2_plac:8,eas:[],inlin:8,bug:[0,4],count:[9,6],succe:5,made:[5,9,4,6,7],config_mod:[],whether:[5,9,8,4,1],arg2:4,writeabl:6,displai:4,asynchron:[9,6],record:2,below:[0,8,6],limit:[9,10],otherwis:[5,9,4],problem:2,epel:0,evalu:[9,10],is_favcolor_blu:9,filenam:[9,4],ec2_tag_nam:8,implement:[8,5],ini:[7,8,4],mountpoint:[],pip:4,ing:4,inc:[],boot:4,starbuck:9,virtual:[4,6],capabilit:[],book:[],futur:[9,5],branch:[0,4],varieti:[8,5],riak:[],servernam:[],ec2_external_inventori:8,repeat:[9,1],"class":[5,8,4,6],geco:4,ansiblemodul:5,debian:[0,9,4],stai:9,sphinx:[],eof:4,amp:[7,8],scientif:0,reliabl:[],rule:[9,1,10],portion:[7,4],emerg:[],name_of_host:[],"8btwaryr":4},objtypes:{},titles:["Getting Started","Best Practices","YAML Syntax","Contents","Ansible Modules","Module Development","Playbooks","Inventory & Patterns","API & Integrations","Advanced Playbooks","Command Line Examples And Next Steps"],objnames:{},filenames:["gettingstarted","bestpractices","YAMLSyntax","index","modules","moduledev","playbooks","patterns","api","playbooks2","examples"]}) \ No newline at end of file