internet/community.general
3
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-05-06 13:22:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

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
parent 90d17924a4
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