ansible-collections/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2025-07-22 12:50:22 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Include dependency role names in role_names. (#46483)

Browse source 
* -Change: Include dependency role names in `role_names`.
-Add: `play_role_names` magic variable to include only explicitly named roles (formerly `role_names`).
-Add: `dependent_role_names` magic variable to include all dependency names for all roles.

* -Change: use the ansible_ prefix for new magic variables.
-Change: keep `role_names` as a deprecated variable, using the old functionality.

* -Add: changelog fragment for the role_names rework.

* -Add: Tests for the role_names (and ansible_*role_names) special variables

* -Fix: resolve erroneous documentation snippet that was introduced after rebasing.

* -Fix: explicitly sort to ensure list comparison works in test.
This commit is contained in:
Xaroth 2018-11-15 16:01:29 +01:00 • committed by Brian Coca
commit 87d10b9b78
5 changed files with 65 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

13
docs/docsite/rst/reference_appendices/special_variables.rst
View file

@ -10,6 +10,9 @@ These variables are directly not settable by the user, Ansible will always overr
ansible_check_mode
Boolean that indicates if we are in check mode or not
ansible_dependent_role_names
The names of the roles currently imported into the current play as dependencies of other plays
ansible_diff_mode
Boolean that indicates if we are in diff mode or not
@ -31,9 +34,17 @@ ansible_play_hosts
ansible_play_hosts_all
List of all the hosts that were targeted by the play
ansible_play_role_names
The names of the roles currently imported into the current play. This list does **not** contain the role names that are
implicitly included via dependencies.
ansible_playbook_python
The path to the python interpreter being used by Ansible on the controller
ansible_role_names
The names of the roles currently imported into the current play, or roles referenced as dependencies of the roles
imported into the current play.
ansible_run_tags
Contents of the ``--tags`` CLI option, which specifies which tags will be included for the current run.
@ -86,7 +97,7 @@ role_name:
The name of the currently executed role
role_names
The names of the rules currently imported into the current play.
Deprecated, the same as ansible_play_role_names
role_path
The path to the dir of the currently running role