Add example.config and main documentation of the roles_path feature.

pull/4278/merge
Michael DeHaan 11 years ago
parent 632232259a
commit fee360f33e

@ -133,6 +133,19 @@ different locations::
Most users will not need to use this feature. See :doc:`developing_plugins` for more details Most users will not need to use this feature. See :doc:`developing_plugins` for more details
.. _deprecation_warnings:
deprecation_warnings
====================
.. versionadded:: 1.3
Allows disabling of deprecating warnings in ansible-playbook output::
deprecation_warnings = True
Deprecation warnings indicate usage of legacy features that are slated for removal in a future release of Ansible.
.. _display_skipped_hosts: .. _display_skipped_hosts:
display_skipped_hosts display_skipped_hosts
@ -390,6 +403,22 @@ always default to the current user::
remote_user = root remote_user = root
.. _roles_path
roles_path
==========
.. version_added: '1.4'
The roles path indicate additional directories beyond the 'roles/' subdirectory of a playbook project to search to find Ansible
roles. For instance, if there was a source control repository of common roles and a different repository of playbooks, you might
choose to establish a convention to checkout roles in /opt/mysite/roles like so::
roles_path = /opt/mysite/roles
Roles will be first searched for in the playbook directory. Should a role not be found, it will indicate all the possible paths
that were searched.
.. _sudo_exe: .. _sudo_exe:
sudo_exe sudo_exe

@ -12,7 +12,6 @@
hostfile = /etc/ansible/hosts hostfile = /etc/ansible/hosts
library = /usr/share/ansible library = /usr/share/ansible
#roles_path = /etc/ansible/roles
remote_tmp = $HOME/.ansible/tmp remote_tmp = $HOME/.ansible/tmp
pattern = * pattern = *
forks = 5 forks = 5
@ -23,6 +22,9 @@ sudo_user = root
transport = smart transport = smart
remote_port = 22 remote_port = 22
# additional paths to search for roles in, colon seperated
#roles_path = /etc/ansible/roles
# uncomment this to disable SSH key host checking # uncomment this to disable SSH key host checking
#host_key_checking = False #host_key_checking = False

Loading…
Cancel
Save