ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity

rewrote 1.x section of precedence to prevent promissing specificity to those reading docs for earlier versions

Browse source
This commit is contained in:
Brian Coca 2015-09-15 11:00:38 -04:00
parent 6e34e84417
commit 7f52d909c4
1 changed files with 16 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
docsite/rst/playbooks_variables.rst
View file

@ -732,7 +732,20 @@ However, let's go ahead and get precedence out of the way! It exists. It's a r
a use for it. a use for it.
If multiple variables of the same name are defined in different places, they get overwrriten in a certain order. If multiple variables of the same name are defined in different places, they get overwrriten in a certain order.
The order of precedence is (last one wins):
In 1.x the precedence is:
* extra vars (``-e`` in the command line) always win
* then come connection variables (``ansible_user``, etc)
* then comes "most everything else" (command line switches, vars in play, included vars, role vars, etc)
* then come the variables defined in inventory
* then come the facts discovered about a system
* then "role defaults", which are the most "defaulty" and lose in priority to everything.
.. note:: In versions prior to 1.5.4, facts discovered about a system were in the "most everything else" category above.
In 2.x we have made the order of precedence more specific (last one wins):
* role defaults [1]_ * role defaults [1]_
* inventory vars [2]_ * inventory vars [2]_
@ -760,9 +773,9 @@ The order of precedence is (last one wins):
If multiple groups have the same variable, the last one loaded wins. If multiple groups have the same variable, the last one loaded wins.
If you define a variable twice in a play's vars: section, the 2nd one wins. If you define a variable twice in a play's vars: section, the 2nd one wins.
.. note:: the previous describes the default config `hash_behavior=replace`, switch to 'merge' to only partially overwrite. .. note:: the previous describes the default config `hash_behavior=replace`, switch to 'merge' to only partially overwrite.
.. note:: In versions prior to 1.5.4, facts discovered about a system were in the "most everything else" category above.
Another important thing to consider is that connection spedific variables override config, command line and play specific options and directives. For example::
Another important thing to consider (for all versions) is that connection spedific variables override config, command line and play specific options and directives. For example::
ansible_ssh_user will override `-u <user>` and `remote_user: <user>` ansible_ssh_user will override `-u <user>` and `remote_user: <user>`