From e2cc510e37ec61d0415145933acb070902aa84a1 Mon Sep 17 00:00:00 2001 From: Hagai Date: Thu, 22 May 2014 15:31:20 +0300 Subject: [PATCH] Update docs to include directories inside group_vars --- docsite/rst/intro_inventory.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docsite/rst/intro_inventory.rst b/docsite/rst/intro_inventory.rst index 789f4ac438a..24a8670cef2 100644 --- a/docsite/rst/intro_inventory.rst +++ b/docsite/rst/intro_inventory.rst @@ -171,6 +171,17 @@ the 'raleigh' group might look like:: It is ok if these files do not exist, as this is an optional feature. +As an advanced use-case, you can create *directories* named after your groups or hosts, and +Ansible will read all the files in these directories. An example with the 'raleigh' group:: + + /etc/ansible/group_vars/raleigh/db_settings + /etc/ansible/group_vars/raleigh/cluster_settings + +All hosts that are in the 'raleigh' group will have the variables defined in these files +available to them. This can be very useful to keep your variables organized when a single +file starts to be too big, or when you want to use :doc:`Ansible Vault` on a part of a group's +variables. + Tip: In Ansible 1.2 or later the group_vars/ and host_vars/ directories can exist in either the playbook directory OR the inventory directory. If both paths exist, variables in the playbook directory will be loaded second.