Document: with_file(glob) relative path and roles

Document that with_file and with_fileglob path is relative to
the files directory inside of a role.
This commit is contained in:
Lorin Hochstein 2013-06-14 11:13:38 -04:00
parent cf2ddb6f80
commit d7ba2e06eb
2 changed files with 23 additions and 15 deletions

View file

@ -438,6 +438,8 @@ inside another.
play are going to get the same tasks. ('*when*' provides some play are going to get the same tasks. ('*when*' provides some
ability for hosts to conditionally skip tasks). ability for hosts to conditionally skip tasks).
.. _roles:
Roles Roles
````` `````

View file

@ -467,6 +467,12 @@ be used like this::
with_file: with_file:
- /home/foo/.ssh/id_rsa.pub - /home/foo/.ssh/id_rsa.pub
.. note::
When using ``with_fileglob`` or ``with_file`` with :ref:`roles`, if you
specify a relative path (e.g., :file:`./foo`), Ansible resolves the path
relative to the :file:`roles/<rolename>/files` directory.
.. versionadded: 0.9 .. versionadded: 0.9
Many new lookup abilities were added in 0.9. Remeber lookup plugins are run on the *controlling* machine:: Many new lookup abilities were added in 0.9. Remeber lookup plugins are run on the *controlling* machine::