cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Merge pull request #2829 from lorin/per-task-sudo

Browse source 
Document: sudo works per-task too
This commit is contained in:
Michael DeHaan 2013-05-05 09:40:13 -07:00
commit 62453e1d53
1 changed files with 19 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
docsite/latest/rst/playbooks.rst
View file

@ -98,6 +98,16 @@ Support for running things from sudo is also available::
user: yourname
sudo: yes
You can also use sudo on a particular task instead of the whole play::
---
- hosts: webservers
user: yourname
tasks:
- service: name=nginx state=started
sudo: yes
You can also login as you, and then sudo to different users than root::
---
@ -263,8 +273,8 @@ It is also possible to say:
template: src=templates/foo.j2 dest=/etc/foo.conf
The name of the module is simply followed by a colon and the arguments to that module. We think this is a lot more intuitive.
Our documentation has not converted over to this new format just yet as many users may still be using older versions.
The name of the module is simply followed by a colon and the arguments to that module. We think this is a lot more intuitive.
Our documentation has not converted over to this new format just yet as many users may still be using older versions.
You'll be able to use both formats forever.
Running Operations On Change
@ -275,10 +285,10 @@ they have made a change on the remote system. Playbooks recognize this and
have a basic event system that can be used to respond to change.
These 'notify' actions are triggered at the end of each block of tasks in a playbook, and will only be
triggered once even if notified by multiple different tasks.
triggered once even if notified by multiple different tasks.
For instance, multiple resources may indicate
that apache needs to be restarted because they have changed a config file,
that apache needs to be restarted because they have changed a config file,
but apache will only be bounced once to avoid unneccessary restarts.
Here's an example of restarting two services when the contents of a file
@ -374,7 +384,7 @@ which also supports structured variables::
- include: wordpress.yml
vars:
user: timmy
some_list_variable:
some_list_variable:
- alpha
- beta
- gamma
@ -500,13 +510,13 @@ While it's probably not something you should do often, you can also conditionall
- hosts: webservers
roles:
- { role: some_role, when: "ansible_os_family == 'RedHat'" }
This works by applying the conditional to every task in the role. Conditionals are covered later on in
the documentation.
the documentation.
If the play still has a 'tasks' section, those tasks are executed after roles are applied.
If you want to define certain tasks to happen before AND after roles are applied, you can do this::
If you want to define certain tasks to happen before AND after roles are applied, you can do this::
---
- hosts: webservers
@ -516,7 +526,7 @@ If you want to define certain tasks to happen before AND after roles are applied
- { role: some_role }
post_tasks:
- shell: echo 'goodbye'
Executing A Playbook
````````````````````