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

Fix roles language in docs (#25811)

Browse source 
* Correct tag behavior with regards to roles

* Remove trailing spaces

* Furthe clarify include vs. import tag behavior
This commit is contained in:
Sam Doran 2017-06-27 02:10:07 -04:00 committed by scottb
parent 36ad934156
commit 67eae347cd
1 changed files with 4 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docs/docsite/rst/playbooks_reuse_roles.rst
View file

@ -152,7 +152,7 @@ You can conditionally execute a role. This is not generally recommended with the
- hosts: webservers
tasks:
- include_role:
- include_role:
name: some_role
when: "ansible_os_family == 'RedHat'"
@ -170,14 +170,14 @@ Or, again, using the newer syntax::
- hosts: webservers
tasks:
- import_role:
- import_role:
name: foo
tags:
- bar
- baz
.. note::
This *tags all of the tasks in that role with the tags specified*, overriding any tags that are specified inside the role. If you find yourself building a role with lots of tags and you want to call subsets of the role at different times, you should consider just splitting that role into multiple roles.
This *tags all of the tasks in that role with the tags specified*, appending to any tags that are specified inside the role. The tags in this example will *not* be added to tasks inside an ``include_role``. Tag the ``include_role`` task directly in order to apply tags to tasks in included roles. If you find yourself building a role with lots of tags and you want to call subsets of the role at different times, you should consider just splitting that role into multiple roles.
Role Duplication and Execution
``````````````````````````````
@ -190,7 +190,7 @@ Ansible will only allow a role to execute once, even if defined multiple times,
- foo
- foo
Given the above, the role ``foo`` will only be run once.
Given the above, the role ``foo`` will only be run once.
To make roles run more than once, there are two options: