openstack-ansible/doc/source/developer-docs
Nolan Brubaker 7b288eafbe Use in-tree env.d files, provide override support
In past versions, upgrading OpenStack-Ansible lead to contention between
the code base and deployer customizations when env.d files were changed.
Deployers were encouraged to make their customizations, while the
project needed to sometimes adjust architecture. Detecting these
conflicts in an automated way was difficult, since the files were simple
dictionaries and lists, leaving no metadata to describe intent for the
changes.

This change modifies the dynamic inventory system to first use the
in-tree env.d directory as the base environment, then reads in files
from the /etc/openstack_deploy/env.d directory and updates existing keys
with the new values. In this way, the OSA project can modify the
environment and deployers can customize the environment without directly
manipulating the same files.

As part of this change, the env.d directory was moved in to the
playbooks/inventory directory, in order to reduce the path manipulation
done inside of the dynamic_inventory.py script. The example files were
left in the etc/openstack_deploy directory for reference.

Note that this change supports deleting elements by specifying a
empty value, such as an empty list or an empty dictionary.

When overriding, only the path to the values that changed is necessary.
For example, changing the 'is_metal' property for cinder only needs the
following in /etc/openstack_deploy/env.d/cinder.yml:

    container_skel:
      cinder_volumes_container:
        properties:
          is_metal: false

This is instead of the entirity of the container_skel dict or even the
other top-level dicts.

For AIO/gate scenarioes, the env.d copy logic has been removed, as it is
now redundant.

Change-Id: Ic637fa385fd3fec7365fb9bc5e0ff54a7f4c8bee
2016-07-01 16:40:28 +00:00
..
additional-roles.rst Docs: Add role development maturity guidelines 2016-06-14 12:38:59 +01:00
configure-aodh.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-ceilometer.rst Fix typos in openstack-ansible/doc 2016-06-19 17:38:23 +09:00
configure-ceph.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-cinder.rst Fix typos in openstack-ansible/doc 2016-06-19 17:38:23 +09:00
configure-federation-idp-adfs.rst [docs] Address tox errors 2016-06-28 09:48:38 +10:00
configure-federation-idp.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-federation-mapping.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-federation-sp-overview.rst [docs] Address tox errors 2016-06-28 09:48:38 +10:00
configure-federation-sp.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-federation-use-case.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-federation-wrapper.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-federation.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-haproxy.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-horizon.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-hypervisor.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-ironic.rst Fix typos in openstack-ansible/doc 2016-06-19 17:38:23 +09:00
configure-keystone.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-network-services.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
configure-nova.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-rabbitmq.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift-add.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift-config.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift-devices.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift-glance.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift-policies.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
configure-swift.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
contribute.rst Fix install guide link in contributor guide 2016-05-18 11:37:44 +01:00
core-reviewers.rst [DOC] Describe core reviewer team responsibilities 2016-03-18 11:45:46 -04:00
deploy-config.rst [docs] Migrate deployment configuration options 2016-06-15 12:07:47 +10:00
extending.rst Use in-tree env.d files, provide override support 2016-07-01 16:40:28 +00:00
index.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
installation-hosts-limited-connectivity.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
inventory.rst Use in-tree env.d files, provide override support 2016-07-01 16:40:28 +00:00
navigation.txt Initial commit to enable mitaka>newton upgrades 2016-05-13 22:26:19 +01:00
ops-addcomputehost.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-galera-recovery.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-galera-remove.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-galera-start.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-galera.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-logging.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-tips.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops-troubleshooting.rst [docs] Migrate ops and appendix content 2016-06-17 10:13:27 +10:00
ops.rst [docs] Address tox errors 2016-06-28 09:48:38 +10:00
playbooks.rst Various Documentation Updates 2015-10-05 18:16:01 +01:00
quickstart-aio.rst DOC add note about building AIO more than once 2016-06-07 09:13:25 -04:00
scripts.rst Change to using ANSIBLE_FORKS and update related tip 2016-05-20 13:01:26 +01:00