Bug 1325122

Summary: Document the use of --environment-directory, instead of a list of -e arguments on commandline for Director
Product: Red Hat OpenStack Reporter: Harald Jensås <hjensas>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 8.0 (Liberty)CC: djuran, dmacpher, hjensas, mcornea, sclewis, srevivo, tvignaud
Target Milestone: gaKeywords: Documentation
Target Release: 9.0 (Mitaka)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-08-29 02:59:27 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

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.