cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

draft playbook path docs

Browse source
This commit is contained in:
Brian Coca 2017-03-15 11:53:52 -04:00
parent 7b0f765a57
commit 7cf16588e8
1 changed files with 11 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
docs/docsite/rst/playbook_pahting.rst Normal file
View file

@ -0,0 +1,11 @@
relative paths get attempted first with a 'files|templates|vars' in path (if not already present) depending on action being taken, 'files' is the default. (i.e include_vars will use vars/).
paths will be searched from most specific to most general (i.e role before play).
dependent roles WILL be traversed (i.e task is in role2, role2 is a dependency of role1, role2 will be looked at first, then role1, then play).
role search path is rolename/{files|vars|templates}/, rolename/tasks/.
play search path is playdir/{files|vars|templates}/, playdir/.
the current working directory (cwd) is not searched. If you see it, it just happens to coincide with one of the paths above.
include of a task file from a role will NOT trigger role behavior, this only happens when running as a role.
new ansible_search_path var will have the search path used, in order.
5 vs (-vvvvv) should show the detail of the search as it happens.
this does NOT affect absolute paths
includes try the path of the included file first and fall back to the play/role that includes them.