<div dir="ltr">Hi TripleO devs,<div><br></div><div>The patches ([1], [2], [3], [4]) implementing the deployment plan import/export feature have been up for review for some time. (The corresponding spec is at [5].) In this email, I'd like to explain how to review this feature.</div><div><br></div><div>Patch [1] adds the import functionality to the create and update plan actions in tripleo-common. Make sure your copy of the tripleo-heat-templates includes the plan-environment.yaml[6] file. On your undercloud, clone a local copy of the tripleo-common repo [7] and cherry-pick the patch [1] on top of it. Then run the steps outlined at [8] in order to install the newly cloned copy of tripleo-common. This will make the updated actions available to Mistral. Then you can use the plan create and plan update commands, then make sure that the contents of the plan-environment.yaml file get correctly imported into the Mistral environment. E.g:</div><div><br></div><div>  $ openstack overcloud plan create --templates /usr/share/openstack-tripleo-heat-templates/ new_plan</div><div>  $ mistral environment-get new_plan</div><div><br></div><div>And similarly for plan update.</div><div><br></div><div>Patch [2] adds an action and a workflow for exporting deployment plans and patch [3] adds a CLI command that triggers the workflow. You can test these two patches together, or if you want to test only [2] you can manually execute the Mistral workflow. For patch [2] the same instructions from above regarding installing a new copy of tripleo-common apply. You will also need to manually update the plan management workbook:</div><div><br></div><div>  $ mistral workbook-update tripleo-common/workbooks/plan_management.yaml<br></div><div><br></div><div>Please note that patch [2] depends on patch [1] - you'll need both of them applied on your local copy of tripleo-common. As far as python-tripleoclient goes, it is enough to simply clone a fresh copy to your undercloud, apply patch [3] and run `python setup.py install`. This will make the new plan export command available to you:</div><div><br></div><div>  $ openstack overcloud plan export new_plan</div><div><br></div><div>If all goes well, that should create a plan export tarball (new_plan.tar.gz) in the directory you ran the command from. You should check that the tarball contains all the relevant plan files, as well as the plan-environment.yaml file whose contents should be imported from the Mistral environment.</div><div><br></div><div>Finally, patch [4] integrates the plan export functionality into the TripleO UI. You will need [1] and [2] applied on your undercloud. Then you can cherry pick [4] on top of your tripleo-ui checkout. Access the UI, navigate to Select Deployment -> Manage Deployments. Next to every plan, there should now be a new Export button which you can use to test the plan export functionality.</div><div><br></div><div>Hope all of this makes sense - if it does not, or you have any other questions regarding this feature, please feel free to respond here or ping me on IRC.</div><div><br></div><div>Thanks for your patience and I'll look forward to the reviews!</div><div><br></div><div><br></div><div>[1] <a href="https://review.openstack.org/#/c/414169/">https://review.openstack.org/#/c/414169/</a></div><div>[2] <a href="https://review.openstack.org/#/c/422789/">https://review.openstack.org/#/c/422789/</a></div><div>[3] <a href="https://review.openstack.org/#/c/425858/">https://review.openstack.org/#/c/425858/</a></div><div>[4] <a href="https://review.openstack.org/#/c/437676/">https://review.openstack.org/#/c/437676/</a></div><div>[5] <a href="https://specs.openstack.org/openstack/tripleo-specs/specs/ocata/gui-plan-import-export.html">https://specs.openstack.org/openstack/tripleo-specs/specs/ocata/gui-plan-import-export.html</a></div><div>[6] <a href="https://github.com/openstack/tripleo-heat-templates/blob/master/plan-environment.yaml">https://github.com/openstack/tripleo-heat-templates/blob/master/plan-environment.yaml</a></div><div>[7] <a href="https://github.com/openstack/tripleo-common">https://github.com/openstack/tripleo-common</a></div><div>[8] <a href="https://docs.openstack.org/developer/tripleo-common/readme.html#action-development">https://docs.openstack.org/developer/tripleo-common/readme.html#action-development</a><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Regards,</div><div>Ana Krivokapic</div><div>Senior Software Engineer</div><div>OpenStack team</div><div>Red Hat Inc.</div></div></div>
</div></div>