aboutsummaryrefslogtreecommitdiffstats
path: root/sample-env-generator/README.rst
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2017-06-19 15:27:00 +0000
committerGerrit Code Review <review@openstack.org>2017-06-19 15:27:00 +0000
commit11a97ec7430118bbf4a11c87eceb3adec40ea4ac (patch)
treec6334a938c1764969fe2abc8f36ae69d2b6b8e28 /sample-env-generator/README.rst
parent77eec6867a064e8764745375940cf085be958c2f (diff)
parent204a5820995dd694fcd58d61fc6cf34a8955da92 (diff)
Merge "Add nested sample environments for inject-trust-anchor"
Diffstat (limited to 'sample-env-generator/README.rst')
-rw-r--r--sample-env-generator/README.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/sample-env-generator/README.rst b/sample-env-generator/README.rst
index 55f3bacf..32e94f98 100644
--- a/sample-env-generator/README.rst
+++ b/sample-env-generator/README.rst
@@ -23,6 +23,11 @@ appropriate file in the ``sample-env-generator/`` directory. The existing
entries in the files can be used as examples, and a more detailed
explanation of the different available keys is below:
+Top-level:
+- **environments**: This is the top-level key in the file. All other keys
+ below should appear in a list of dictionaries that define environments.
+
+Environment-specific:
- **name**: the output file will be this name + .yaml, in the
``environments`` directory.
- **title**: a human-readable title for the environment.
@@ -52,6 +57,12 @@ explanation of the different available keys is below:
- **resource_registry**: Many environments also need to pass
resource_registry entries when they are used. This can be used
to specify that in the configuration file.
+- **children**: For environments that share a lot of common values but may
+ need minor variations for different use cases, sample environment entries
+ can be nested. ``children`` takes a list of environments with the same
+ structure as the top-level ``environments`` key. The main difference is
+ that all keys are optional, and any that are omitted will be inherited from
+ the parent environment definition.
Some behavioral notes: