Bug 1325122 - Document the use of --environment-directory, instead of a list of -e arguments on commandline for Director
Summary: Document the use of --environment-directory, instead of a list of -e argument...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 8.0 (Liberty)
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ga
: 9.0 (Mitaka)
Assignee: Dan Macpherson
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-04-08 10:36 UTC by Harald Jensås
Modified: 2016-08-29 02:59 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-08-29 02:59:27 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Harald Jensås 2016-04-08 10:36:36 UTC
Description of problem:
a) By default director will include any envornment file in .tripleo
b) One can specify an --environment-directory, instead of using multiple -e arguments and making sure they are added in the correct order.

Using .tripleo or a different explicit directory for environment files is a "safer" approach. As this should remove the accidental "ooops forgot to include an environment file" and broke my overcloud, or "ooops the ordering of environment files was not identiacal to previous deploy" and broke my overcloud.

.tripleo or --environment-directory are sorted. 

So something like this is a common pattern for unix administrators.

->/home/stack/.tripleo/
|-> 01-network-isolation.yaml
|-> 02-storage-environment.yaml
|-> 03-enable-tls.yaml
|-> 04-enable-tls-key.yaml
|-> 05-inject-trust-anchor.yaml
|-> 50-rabbitmq-filedescriptors.yaml
|-> 80-my-params.yaml


I think this is a better approach than using -e on the command line. I would like to get this into our doc as an option so that the end-user can make an educated choice.

Comment 2 Dan Macpherson 2016-04-11 01:59:59 UTC
I checked the code and command line options for python-tripleoclient on OpenStack 8 and this command line option doesn't appear for OSPd 8. However, this fix is committed upstream, so it might be a future enhancement.

Comment 4 Dan Macpherson 2016-08-19 05:21:40 UTC
Harald,

I've added some documentation on --environment-directory for the OSP 9 release:

https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/single/director-installation-and-usage/#sect-Including_Environment_Files_in_Overcloud_Creation

How does this look to you?

Comment 5 Harald Jensås 2016-08-19 12:41:15 UTC
Dan,

Looks great to me! 

Thank you for making the effort to include this in the docs.

Comment 6 Dan Macpherson 2016-08-22 02:14:04 UTC
No prob, my pleasure. Thanks for reporting this issue.


Note You need to log in before you can comment on or make changes to this bug.