mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
documented new tag behaviour
This commit is contained in:
parent
65c08d1364
commit
af573db47a
1 changed files with 25 additions and 3 deletions
|
@ -1,8 +1,8 @@
|
|||
Tags
|
||||
====
|
||||
|
||||
If you have a large playbook it may become useful to be able to run a
|
||||
specific part of the configuration without running the whole playbook.
|
||||
If you have a large playbook it may become useful to be able to run a
|
||||
specific part of the configuration without running the whole playbook.
|
||||
|
||||
Both plays and tasks support a "tags:" attribute for this reason.
|
||||
|
||||
|
@ -24,7 +24,7 @@ Example::
|
|||
If you wanted to just run the "configuration" and "packages" part of a very long playbook, you could do this::
|
||||
|
||||
ansible-playbook example.yml --tags "configuration,packages"
|
||||
|
||||
|
||||
On the other hand, if you want to run a playbook *without* certain tasks, you could do this::
|
||||
|
||||
ansible-playbook example.yml --skip-tags "notification"
|
||||
|
@ -40,6 +40,28 @@ And you may also tag basic include statements::
|
|||
|
||||
Both of these have the function of tagging every single task inside the include statement.
|
||||
|
||||
|
||||
Special Tags
|
||||
````````````
|
||||
|
||||
There is a special 'always' tag that will always run a task, unless specifically skipped (--skip-tags always)
|
||||
|
||||
Example::
|
||||
|
||||
tasks:
|
||||
|
||||
- debug: msg="Always runs"
|
||||
tags:
|
||||
- always
|
||||
|
||||
- debug: msg="runs when you use tag1"
|
||||
tags:
|
||||
- tag1
|
||||
|
||||
There are another 3 special keywords for tags, 'tagged', 'untagged' and 'all', which run only tagged, only untagged
|
||||
and all tasks respectively. By default ansible runs as if --tags all had been specified.
|
||||
|
||||
|
||||
.. seealso::
|
||||
|
||||
:doc:`playbooks`
|
||||
|
|
Loading…
Reference in a new issue