Merge pull request #13005 from ansible/tgerla-clarify-role-tags

Clarify how tagged roles work
9 years ago · 5ee01d00bb
parent 61ace1d3c4 9008b7b0e7
commit 5ee01d00bb
1 changed files with 1 additions and 0 deletions
--- a/docsite/rst/playbooks_roles.rst
+++ b/docsite/rst/playbooks_roles.rst
@ -238,6 +238,7 @@ Finally, you may wish to assign tags to the roles you specify. You can do so inl
      roles:
        - { role: foo, tags: ["bar", "baz"] }

+Note that 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.

 If the play still has a 'tasks' section, those tasks are executed after roles are applied.