From ae49dd65d9b52dea3c5c07c924e7008a8448b67f Mon Sep 17 00:00:00 2001 From: Matt Martz Date: Mon, 15 Jan 2018 12:00:59 -0600 Subject: [PATCH] Add note to 2.4 porting guide about initial playbook relative host/group_vars and inheritance (#34769) * Add note to 2.4 porting guide about initial playbook relative host/group_vars and inheritance --- docs/docsite/rst/porting_guide_2.4.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/docsite/rst/porting_guide_2.4.rst b/docs/docsite/rst/porting_guide_2.4.rst index 84e7c6b1053..0a388104d61 100644 --- a/docs/docsite/rst/porting_guide_2.4.rst +++ b/docs/docsite/rst/porting_guide_2.4.rst @@ -37,6 +37,16 @@ Since there is no longer a single inventory, the 'implicit localhost' doesn't ge A bug was fixed with the inventory path/directory, which was defaulting to the current working directory. This caused ``group_vars`` and ``host_vars`` to be picked up from the current working directory instead of just adjacent to the playbook or inventory directory when a host list (comma separated host names) was provided as inventory. +Initial playbook relative group_vars and host_vars +-------------------------------------------------- + +In Ansible versions prior to 2.4, the inventory system would maintain the context of the initial playbook that was executed. This allowed successively included playbooks from other directories to inherit group_vars and host_vars placed relative to the top level playbook file. + +Due to some behavioral inconsistencies, this functionality will not be included in the new +inventory system starting with Ansible version 2.4. + +Similar functionality can still be achieved by using vars_files, include_vars, or group_vars and host_vars placed relative to the inventory file. + Deprecated ==========