Reformat code: examples consistently

- added terse syntax to modules.rst
 - added description of special variables to template module
reviewable/pr18780/r1
Jan-Piet Mens 12 years ago
parent 728b08ac71
commit d069c57974

12
apt

@ -70,17 +70,17 @@ options:
author: Matthew Williams author: Matthew Williams
notes: [] notes: []
examples: examples:
- code: apt pkg=foo update-cache=yes - code: "apt: pkg=foo update-cache=yes"
description: Update repositories cache and install C(foo) package description: Update repositories cache and install C(foo) package
- code: apt pkg=foo state=removed - code: "apt: pkg=foo state=removed"
description: Remove C(foo) package description: Remove C(foo) package
- code: apt pkg=foo state=installed - code: "apt: pkg=foo state=installed"
description: Install the package C(foo) description: Install the package C(foo)
- code: apt pkg=foo=1.00 state=installed - code: "apt: pkg=foo=1.00 state=installed"
description: Install the version '1.00' of package C(foo) description: Install the version '1.00' of package C(foo)
- code: apt pkg=nginx state=latest default-release=squeeze-backports update-cache=yes - code: "apt: pkg=nginx state=latest default-release=squeeze-backports update-cache=yes"
description: Update the repository cache and update package C(ngnix) to latest version using default release C(squeeze-backport) description: Update the repository cache and update package C(ngnix) to latest version using default release C(squeeze-backport)
- code: apt pkg=openjdk-6-jdk state=latest install-recommends=no - code: "apt: pkg=openjdk-6-jdk state=latest install-recommends=no"
description: Install latest version of C(openjdk-6-jdk) ignoring C(install-recomands) description: Install latest version of C(openjdk-6-jdk) ignoring C(install-recomands)
''' '''

@ -48,9 +48,9 @@ notes:
- A bug in C(apt-add-repository) always adds C(deb) and C(deb-src) types for repositories (see the issue on Launchpad U(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. - A bug in C(apt-add-repository) always adds C(deb) and C(deb-src) types for repositories (see the issue on Launchpad U(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.
author: Matt Wright author: Matt Wright
examples: examples:
- code: apt_repository repo=ppa://nginx/stable - code: "apt_repository: repo=ppa://nginx/stable"
description: Add nginx stable repository from PPA description: Add nginx stable repository from PPA
- code: apt_repository repo='deb http://archive.canonical.com/ubuntu hardy partner' - code: "apt_repository: repo='deb http://archive.canonical.com/ubuntu hardy partner'"
description: Add specified repository into sources. description: Add specified repository into sources.
''' '''

@ -61,7 +61,7 @@ options:
- all arguments accepted by the M(file) module also work here - all arguments accepted by the M(file) module also work here
required: false required: false
examples: examples:
- code: assemble src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf - code: "assemble: src=/etc/someapp/fragments dest=/etc/someapp/someapp.conf"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
author: Stephen Fromm author: Stephen Fromm
''' '''

@ -47,9 +47,9 @@ options:
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
default: "present" default: "present"
examples: examples:
- code: 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" - code: '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"'
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
- code: "authorized_key user=charlie key=$FILE(/home/charlie/.ssh/id_rsa.pub)" - code: "authorized_key: user=charlie key=$FILE(/home/charlie/.ssh/id_rsa.pub)"
description: "Shorthand available in Ansible 0.8 and later" description: "Shorthand available in Ansible 0.8 and later"
author: Brad Olson author: Brad Olson
''' '''

@ -61,9 +61,9 @@ options:
required: false required: false
default: null default: null
examples: examples:
- code: command /sbin/shutdown -t now - code: "command: /sbin/shutdown -t now"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
- code: command /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database - code: "command: /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database"
description: "I(creates), I(removes), and I(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." description: "I(creates), I(removes), and I(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."
notes: notes:
- If you want to run a command through the shell (say you are using C(<), - If you want to run a command through the shell (say you are using C(<),

@ -53,9 +53,9 @@ options:
- all arguments accepted by the M(file) module also work here - all arguments accepted by the M(file) module also work here
required: false required: false
examples: examples:
- code: copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644 - code: "copy: src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
- code: copy src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes - code: "copy: src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes"
description: "Copy a new C(ntp.conf) file into place, backing up the original if it differs from the copied version" description: "Copy a new C(ntp.conf) file into place, backing up the original if it differs from the copied version"
author: Michael DeHaan author: Michael DeHaan
''' '''

@ -99,9 +99,9 @@ options:
default: "*" default: "*"
aliases: [] aliases: []
examples: examples:
- code: cron name="check dirs" hour="5,2" job="ls -alh > /dev/null" - code: 'cron: name="check dirs" hour="5,2" job="ls -alh > /dev/null"'
description: Ensure a job that runs at 2 and 5 exists. Creates an entry like "* 5,2 * * ls -alh > /dev/null" description: Ensure a job that runs at 2 and 5 exists. Creates an entry like "* 5,2 * * ls -alh > /dev/null"
- code: cron name="an old job" cron job="/some/dir/job.sh" state=absent - code: 'cron: name="an old job" cron job="/some/dir/job.sh" state=absent'
description: 'Ensure an old job is no longer present. Removes any job that is preceded by "#Ansible: an old job" in the crontab' description: 'Ensure an old job is no longer present. Removes any job that is preceded by "#Ansible: an old job" in the crontab'
requirements: cron requirements: cron
author: Dane Summers author: Dane Summers

@ -40,9 +40,9 @@ options:
required: false required: false
default: null default: null
examples: examples:
- code: easy_install name=pip - code: "easy_install: name=pip"
description: "Examples from Ansible Playbooks" description: "Examples from Ansible Playbooks"
- code: easy_install name=flask virtualenv=/webapps/myapp/venv - code: "easy_install: name=flask virtualenv=/webapps/myapp/venv"
description: "Install I(Flask) (U(http://flask.pocoo.org/)) into the specified I(virtualenv)" description: "Install I(Flask) (U(http://flask.pocoo.org/)) into the specified I(virtualenv)"
notes: notes:
- Please note that the M(easy_install) module can only install Python - Please note that the M(easy_install) module can only install Python

@ -41,7 +41,7 @@ options:
default: 1 default: 1
examples: examples:
- code: | - code: |
action: fail msg="The system may not be provisioned according to the CMDB status." rc=100 fail: msg="The system may not be provisioned according to the CMDB status." rc=100
only_if: "'$cmdb_status' != 'to-be-staged'" only_if: "'$cmdb_status' != 'to-be-staged'"
description: "Example playbook using fail and only_if together" description: "Example playbook using fail and only_if together"

@ -26,7 +26,7 @@ options:
required: true required: true
default: null default: null
examples: examples:
- code: fetch src=/var/log/messages dest=/home/logtree - code: "fetch: src=/var/log/messages dest=/home/logtree"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
requirements: [] requirements: []
author: Michael DeHaan author: Michael DeHaan

@ -114,9 +114,9 @@ options:
- accepts only C(default) as value. This will restore a file's SELinux context - accepts only C(default) as value. This will restore a file's SELinux context
in the policy. Does nothing if no default value is available. in the policy. Does nothing if no default value is available.
examples: examples:
- code: file path=/etc/foo.conf owner=foo group=foo mode=0644 - code: "file: path=/etc/foo.conf owner=foo group=foo mode=0644"
description: Example from Ansible Playbooks description: Example from Ansible Playbooks
- code: file src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link - code: "file: src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link"
notes: notes:
- See also M(copy), M(template), M(assemble) - See also M(copy), M(template), M(assemble)
requirements: [ ] requirements: [ ]

@ -54,7 +54,7 @@ examples:
- hosts: devservers - hosts: devservers
connection: fireball connection: fireball
tasks: tasks:
- action: command /usr/bin/anything - command: /usr/bin/anything
description: "This example playbook has two plays: the first launches I(fireball) mode on all hosts via SSH, and the second actually starts using I(fireball) node for subsequent management over the fireball interface" description: "This example playbook has two plays: the first launches I(fireball) mode on all hosts via SSH, and the second actually starts using I(fireball) node for subsequent management over the fireball interface"
notes: notes:
- See the advanced playbooks chapter for more about using fireball mode. - See the advanced playbooks chapter for more about using fireball mode.

@ -60,7 +60,7 @@ options:
- all arguments accepted by the M(file) module also work here - all arguments accepted by the M(file) module also work here
required: false required: false
examples: examples:
- code: get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440 - code: "get_url: url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
notes: notes:
- This module doesn't yet support configuration for proxies or passwords. - This module doesn't yet support configuration for proxies or passwords.

2
git

@ -56,7 +56,7 @@ options:
repository will be discarded. Prior to 0.7, this was always repository will be discarded. Prior to 0.7, this was always
'yes' and could not be disabled. 'yes' and could not be disabled.
examples: examples:
- code: git repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22 - code: "git: repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22"
description: Example git checkout from Ansible Playbooks description: Example git checkout from Ansible Playbooks
''' '''

@ -49,7 +49,7 @@ options:
description: description:
- If I(yes), indicates that the group created is a system group. - If I(yes), indicates that the group created is a system group.
examples: examples:
- code: group name=somegroup state=present - code: "group: name=somegroup state=present"
description: Example group command from Ansible Playbooks description: Example group command from Ansible Playbooks
''' '''

@ -63,14 +63,14 @@ options:
- all arguments accepted by the M(file) module also work here - all arguments accepted by the M(file) module also work here
required: false required: false
examples: examples:
- code: ini_file dest=/etc/conf section=drinks option=fav value=lemonade mode=0600 backup=true - code: "ini_file: dest=/etc/conf section=drinks option=fav value=lemonade mode=0600 backup=true"
description: Ensure C(fav=lemonade) is in section C([drinks]) in said file description: Ensure C(fav=lemonade) is in section C([drinks]) in said file
- code: | - code: |
ini_file dest=/etc/anotherconf ini_file: dest=/etc/anotherconf
section=drinks section=drinks
option=temperature option=temperature
value=cold value=cold
backup=true backup=true
notes: notes:
- While it is possible to add an I(option) without specifying a I(value), this makes - While it is possible to add an I(option) without specifying a I(value), this makes
no sense. no sense.

@ -72,8 +72,8 @@ options:
- Create a backup file including the timestamp information so you can - Create a backup file including the timestamp information so you can
get the original file back if you somehow clobbered it incorrectly. get the original file back if you somehow clobbered it incorrectly.
examples: examples:
- code: lineinfile dest=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled - code: "lineinfile: dest=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled"
- code: lineinfile dest=/etc/sudoers state=absent regexp="^%wheel" - code: 'lineinfile: dest=/etc/sudoers state=absent regexp="^%wheel"'
''' '''
def present(module, dest, regexp, line, insertafter, backup): def present(module, dest, regexp, line, insertafter, backup):

@ -68,7 +68,7 @@ options:
choices: [ "present", "absent", "mounted", "unmounted" ] choices: [ "present", "absent", "mounted", "unmounted" ]
default: null default: null
examples: examples:
- code: mount name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro - code: "mount: name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro"
description: "Mount DVD read-only" description: "Mount DVD read-only"
notes: [] notes: []
requirements: [] requirements: []

@ -68,7 +68,7 @@ options:
- Where to dump/get the .sql file - Where to dump/get the .sql file
required: true required: true
examples: examples:
- code: mysql_db db=bobdata state=present - code: "mysql_db: db=bobdata state=present"
description: Create a new database with name 'bobdata' description: Create a new database with name 'bobdata'
notes: notes:
- Requires the MySQLdb Python package on the remote host. For Ubuntu, this - Requires the MySQLdb Python package on the remote host. For Ubuntu, this

@ -68,9 +68,9 @@ options:
default: present default: present
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
examples: examples:
- code: mysql_user name=bob password=12345 priv=*.*:ALL state=present - code: "mysql_user: name=bob password=12345 priv=*.*:ALL state=present"
description: Create database user with name 'bob' and password '12345' with all database privileges description: Create database user with name 'bob' and password '12345' with all database privileges
- code: mysql_user login_user=root login_password=123456 name=sally state=absent - code: "mysql_user: login_user=root login_password=123456 name=sally state=absent"
description: Ensure no user named 'sally' exists, also passing in the auth credentials. description: Ensure no user named 'sally' exists, also passing in the auth credentials.
- code: mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL - code: mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL
description: Example privileges string format description: Example privileges string format

@ -68,21 +68,21 @@ author: Tim Bielawa
requirements: [ "Nagios" ] requirements: [ "Nagios" ]
examples: examples:
- description: set 30 minutes of apache downtime - description: set 30 minutes of apache downtime
code: nagios action=downtime minutes=30 service=httpd host=$inventory_hostname code: "nagios: action=downtime minutes=30 service=httpd host=$inventory_hostname"
- description: schedule an hour of HOST downtime - description: schedule an hour of HOST downtime
code: nagios action=downtime minutes=60 service=host host=$inventory_hostname code: "nagios: action=downtime minutes=60 service=host host=$inventory_hostname"
- description: schedule downtime for a few services - description: schedule downtime for a few services
code: nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname code: "nagios: action=downtime services=frob,foobar,qeuz host=$inventory_hostname"
- description: enable SMART disk alerts - description: enable SMART disk alerts
code: nagios action=enable_alerts service=smart host=$inventory_hostname code: "nagios: action=enable_alerts service=smart host=$inventory_hostname"
- description: "two services at once: disable httpd and nfs alerts" - description: "two services at once: disable httpd and nfs alerts"
code: nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname code: "nagios: action=disable_alerts service=httpd,nfs host=$inventory_hostname"
- description: disable HOST alerts - description: disable HOST alerts
code: nagios action=disable_alerts service=host host=$inventory_hostname code: "nagios: action=disable_alerts service=host host=$inventory_hostname"
- description: silence ALL alerts - description: silence ALL alerts
code: nagios action=silence host=$inventory_hostname code: "nagios: action=silence host=$inventory_hostname"
- description: unsilence all alerts - description: unsilence all alerts
code: nagios action=unsilence host=$inventory_hostname code: "nagios: action=unsilence host=$inventory_hostname"
''' '''
import ConfigParser import ConfigParser

@ -28,9 +28,9 @@ options:
author: Tim Bielawa author: Tim Bielawa
examples: examples:
- description: Pause for 5 minutes to build app cache. - description: Pause for 5 minutes to build app cache.
code: pause minutes=5 code: "pause: minutes=5"
- description: Pause until you can verify updates to an application were successful. - description: Pause until you can verify updates to an application were successful.
code: pause code: "pause:"
- description: A helpful reminder of what to look out for post-update. - description: A helpful reminder of what to look out for post-update.
code: pause prompt="Make sure org.foo.FooOverload exception is not present" code: 'pause: prompt="Make sure org.foo.FooOverload exception is not present"'
''' '''

10
pip

@ -54,15 +54,15 @@ options:
default: present default: present
choices: [ "present", "absent", "latest" ] choices: [ "present", "absent", "latest" ]
examples: examples:
- code: pip name=flask - code: "pip: name=flask"
description: Install I(flask) python package. description: Install I(flask) python package.
- code: pip name=flask version=0.8 - code: "pip: name=flask version=0.8"
description: Install I(flask) python package on version 0.8. description: Install I(flask) python package on version 0.8.
- code: pip name=flask virtualenv=/srv/webapps/my_app/venv - code: "pip: name=flask virtualenv=/srv/webapps/my_app/venv"
description: "Install I(Flask) (U(http://flask.pocoo.org/)) into the specified I(virtualenv)" description: "Install I(Flask) (U(http://flask.pocoo.org/)) into the specified I(virtualenv)"
- code: pip requirements=/srv/webapps/my_app/src/requirements.txt - code: "pip: requirements=/srv/webapps/my_app/src/requirements.txt"
description: Install specified python requirements. description: Install specified python requirements.
- code: pip requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv - code: "pip: requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv"
description: Install specified python requirements in indicated virtualenv. description: Install specified python requirements in indicated virtualenv.
notes: notes:
- Please note that U(http://www.virtualenv.org/, virtualenv) must be installed on the remote host if the virtualenv parameter is specified. - Please note that U(http://www.virtualenv.org/, virtualenv) must be installed on the remote host if the virtualenv parameter is specified.

@ -56,7 +56,7 @@ options:
default: present default: present
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
examples: examples:
- code: postgresql_db db=acme - code: "postgresql_db: db=acme"
description: Create a new database with name 'acme' description: Create a new database with name 'acme'
notes: notes:
- The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host. - The default authentication assumes that you are either logging in as or sudo'ing to the postgres account on the host.

@ -91,13 +91,13 @@ options:
default: present default: present
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
examples: examples:
- code: postgresql_user db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL - code: "postgresql_user: db=acme user=django password=ceec4eif7ya priv=CONNECT/products:ALL"
description: Create django user and grant access to database and products table description: Create django user and grant access to database and products table
- code: postgresql_user user=rails password=secret role_attr_flags=CREATEDB,NOSUPERUSER - code: "postgresql_user: user=rails password=secret role_attr_flags=CREATEDB,NOSUPERUSER"
description: Create rails user, grant privilege to create other databases and demote rails from super user status description: Create rails user, grant privilege to create other databases and demote rails from super user status
- code: postgresql_user db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no - code: "postgresql_user: db=acme user=test priv=ALL/products:ALL state=absent fail_on_user=no"
description: Remove test user privileges from acme description: Remove test user privileges from acme
- code: postgresql_user db=test user=test priv=ALL state=absent - code: "postgresql_user: db=test user=test priv=ALL state=absent"
description: Remove test user from test database and the cluster description: Remove test user from test database and the cluster
- code: INSERT,UPDATE/table:SELECT/anothertable:ALL - code: INSERT,UPDATE/table:SELECT/anothertable:ALL
description: Example privileges string format description: Example privileges string format

@ -43,7 +43,7 @@ options:
default: null default: null
choices: [ "true", "false" ] choices: [ "true", "false" ]
examples: examples:
- code: seboolean name=httpd_can_network_connect state=true persistent=yes - code: "seboolean: name=httpd_can_network_connect state=true persistent=yes"
description: Set I(httpd_can_network_connect) SELinux flag to I(true) and I(persistent) description: Set I(httpd_can_network_connect) SELinux flag to I(true) and I(persistent)
notes: notes:
- Not tested on any debian based system - Not tested on any debian based system

@ -43,9 +43,9 @@ options:
required: false required: false
default: "/etc/selinux/config" default: "/etc/selinux/config"
examples: examples:
- code: selinux policy=targeted state=enforcing - code: "selinux: policy=targeted state=enforcing"
- code: selinux policy=targeted state=permissive - code: "selinux: policy=targeted state=permissive"
- code: selinux state=disabled - code: "selinux: state=disabled"
notes: notes:
- Not tested on any debian based system - Not tested on any debian based system
requirements: [ libselinux-python ] requirements: [ libselinux-python ]

@ -53,15 +53,15 @@ options:
description: description:
- Whether the service should start on boot. - Whether the service should start on boot.
examples: examples:
- code: service name=httpd state=started - code: "service: name=httpd state=started"
description: Example action from Ansible Playbooks description: Example action from Ansible Playbooks
- code: service name=httpd state=stopped - code: "service: name=httpd state=stopped"
description: Example action from Ansible Playbooks description: Example action from Ansible Playbooks
- code: service name=httpd state=restarted - code: "service: name=httpd state=restarted"
description: Example action from Ansible Playbooks description: Example action from Ansible Playbooks
- code: service name=httpd state=reloaded - code: "service: name=httpd state=reloaded"
description: Example action from Ansible Playbooks description: Example action from Ansible Playbooks
- code: service name=foo pattern=/usr/bin/foo state=started - code: "service: name=foo pattern=/usr/bin/foo state=started"
description: Example action from Ansible Playbooks description: Example action from Ansible Playbooks
''' '''

@ -28,7 +28,7 @@ options:
required: false required: false
default: null default: null
examples: examples:
- code: shell somescript.sh >> somelog.txt - code: "shell: somescript.sh >> somelog.txt"
description: Execute the command in remote shell description: Execute the command in remote shell
notes: notes:
- If you want to execute a command securely and predicably, it may be - If you want to execute a command securely and predicably, it may be

@ -43,7 +43,7 @@ options:
default: yes default: yes
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
examples: examples:
- code: subversion repo=svn+ssh://an.example.org/path/to/repo dest=/src/checkout - code: "subversion: repo=svn+ssh://an.example.org/path/to/repo dest=/src/checkout"
description: Export subversion repository in a specified folder description: Export subversion repository in a specified folder
notes: notes:
- Requires subversion and grep on the client. - Requires subversion and grep on the client.

@ -39,7 +39,7 @@ options:
default: null default: null
choices: [ "started", "stopped", "restarted" ] choices: [ "started", "stopped", "restarted" ]
examples: examples:
- code: supervisorctl name=my_app state=started - code: "supervisorctl: name=my_app state=started"
description: Manage the state of program I(my_app) to be in I(started) state. description: Manage the state of program I(my_app) to be in I(started) state.
requirements: [ ] requirements: [ ]
author: Matt Wright author: Matt Wright

@ -9,6 +9,12 @@ description:
(U(http://jinja.pocoo.org/docs/)) - documentation on the template (U(http://jinja.pocoo.org/docs/)) - documentation on the template
formatting can be found in the Template Designer Documentation formatting can be found in the Template Designer Documentation
(U(http://jinja.pocoo.org/docs/templates/)). (U(http://jinja.pocoo.org/docs/templates/)).
- "Four additional variables can be used in templates: C(ansible_managed)
(configurable via the C(defaults) section of C(ansible.cfg)) contains a string
which can be used to describe the template name, host, modification time of the
template file and the owner uid, C(template_host) contains the node name of
the template's machine, C(template_uid) the owner, and C(template_path) the
file name."
options: options:
src: src:
description: description:
@ -33,7 +39,7 @@ options:
- all arguments accepted by the M(file) module also work here - all arguments accepted by the M(file) module also work here
required: false required: false
examples: examples:
- code: template src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644 - code: "template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
notes: notes:
- Since Ansible version 0.9, templates are loaded with C(trim_blocks=True). - Since Ansible version 0.9, templates are loaded with C(trim_blocks=True).

@ -137,11 +137,11 @@ options:
passphrase is provided, the SSH key will default to passphrase is provided, the SSH key will default to
having no passphrase. having no passphrase.
examples: examples:
- code: user name=johnd comment="John Doe" uid=1040 - code: 'user: name=johnd comment="John Doe" uid=1040'
description: "Add the user 'johnd' with a specific uid and a primary group of 'admin'" description: "Add the user 'johnd' with a specific uid and a primary group of 'admin'"
- code: user name=johnd state=absent remove=yes - code: "user: name=johnd state=absent remove=yes"
description: "Remove the user 'johnd'" description: "Remove the user 'johnd'"
- code: user name=jsmith ssh_key=generate ssh_key_bits=2048 - code: 'user: name=jsmith ssh_key=generate ssh_key_bits=2048'
description: "Create a 2048-bit SSH key for user jsmith" description: "Create a 2048-bit SSH key for user jsmith"
''' '''

@ -42,7 +42,7 @@ options:
- in addition to state management, various non-idempotent commands are available. See examples - in addition to state management, various non-idempotent commands are available. See examples
required: false required: false
examples: examples:
- code: virt guest=alpha state=running - code: "virt: guest=alpha state=running"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
- code: ansible host -m virt -a "guest=alpha command=status" - code: ansible host -m virt -a "guest=alpha command=status"
description: "Example guest management with C(/usr/bin/ansible)" description: "Example guest management with C(/usr/bin/ansible)"

@ -61,7 +61,7 @@ options:
choices: [ "started", "stopped" ] choices: [ "started", "stopped" ]
default: "started" default: "started"
examples: examples:
- code: wait_for port=8000 delay=10 - code: "wait_for: port=8000 delay=10"
description: "Example from Ansible Playbooks" description: "Example from Ansible Playbooks"
notes: [] notes: []
requirements: null requirements: null

6
yum

@ -50,9 +50,9 @@ options:
choices: [ "present", "latest", "absent" ] choices: [ "present", "latest", "absent" ]
default: "present" default: "present"
examples: examples:
- code: yum name=httpd state=latest - code: "yum: name=httpd state=latest"
- code: yum name=httpd state=removed - code: "yum: name=httpd state=removed"
- code: yum name=httpd state=installed - code: "yum: name=httpd state=installed"
notes: [] notes: []
# informational: requirements for nodes # informational: requirements for nodes
requirements: [ yum, rpm ] requirements: [ yum, rpm ]

Loading…
Cancel
Save