RETIRED, A Python library for code common to TripleO CLI and TripleO UI.
Go to file
Alex Schultz 43aaaaa119 Switch 55-heat-config to async
If while a task is executing the ssh connection is severed, ansible will
automagically rerun the command under the covers. This causes problems
for long running 55-heat-config tasks as first process may have written
out the deployed json but not the notify.json that we use use to
determine if it was successful or not. This can lead to a failure
because the process either never runs to completion.  This change
switches the execution to always be run async to ensure that ssh
interruptions won't cause inconsistent failures.

We previously saw a similar issue when invoking the NetworkDeployments
using this process. We've moved the network configurations to the
NetworkConfig task in THT/common/deploy-steps.j2 but this code is still
used to invoked with OS::Heat::SoftwareDeploymentGroup

Change-Id: Ic911bb6d999caf2dc4afd4cff3d44047c03dc8e4
Related-Bug: #1792343
Closes-Bug: #1887846
2020-07-28 14:02:53 -06:00
container-images First pass at script cleanup 2020-07-22 07:11:34 -05:00
contrib Rename contrib to container-images for packaging 2017-04-07 16:56:29 +12:00
doc/source Switch to newer openstackdocstheme and reno versions 2020-06-03 20:35:56 +02:00
healthcheck Fix nova-virtlogd container healthcheck 2020-05-28 19:00:10 +05:30
heat_docker_agent Migrate building IPA to ironic-python-agent-builder 2019-09-03 12:48:12 +02:00
image-yaml Replace overcloud-secure with overcloud-partition 2020-07-23 17:22:28 +05:30
releasenotes Merge "Don't assume default tag exists in container repo" 2020-07-16 23:20:18 +00:00
scripts Remove Validations Mistral Workflows 2020-06-22 13:29:43 +00:00
tools tox: Keeping going with docs 2019-11-03 02:36:43 +08:00
tripleo_common Switch 55-heat-config to async 2020-07-28 14:02:53 -06:00
undercloud_heat_plugins Add custom subclass to revert mapping 2018-03-27 12:33:24 +02:00
workbooks Remove Validations Mistral Workflows 2020-06-22 13:29:43 +00:00
zuul.d Switch tripleo-cross-tripleoclient to python 3.7 2020-07-14 13:57:07 -04:00
.coveragerc Make coverage tests work 2015-11-30 23:01:07 +00:00
.gitignore [Configuration] Remove testrepository. 2019-01-23 10:00:19 +01:00
.gitreview OpenDev Migration Patch 2019-04-19 19:36:50 +00:00
.mailmap Initial Cookiecutter Commit. 2015-04-29 13:34:49 +02:00
.pre-commit-config.yaml linters refresh w/ afferent bugfixes 2020-05-12 10:50:20 +00:00
.stestr.conf Use stestr for unit tests 2018-11-18 21:39:33 +00:00
CONTRIBUTING.rst Fix non-exiting link to TripleO-common bugs 2018-11-27 08:29:25 +01:00
HACKING.rst Update the documentation link for doc migration 2017-07-25 15:00:27 +08:00
LICENSE Initial Cookiecutter Commit. 2015-04-29 13:34:49 +02:00
README.rst Replace git.openstack.org URLs with opendev.org URLs 2019-05-31 10:51:20 +08:00
babel.cfg Initial Cookiecutter Commit. 2015-04-29 13:34:49 +02:00
bindep.txt fix linters 2019-10-17 14:53:05 +01:00
lower-constraints.txt Switch to newer openstackdocstheme and reno versions 2020-06-03 20:35:56 +02:00
requirements.txt Add support for python 3.8 2020-05-26 14:13:00 +02:00
setup.cfg Merge "Remove Validations Mistral Workflows" 2020-06-23 11:44:13 +00:00
setup.py Cleanup py27 support 2020-04-13 20:01:42 +02:00
sudoers Remove Validations Mistral Workflows 2020-06-22 13:29:43 +00:00
test-requirements.txt Switch to newer openstackdocstheme and reno versions 2020-06-03 20:35:56 +02:00
tox.ini Add ensure_global_symlinks: true 2020-06-19 09:02:25 +00:00

README.rst

Team and repository tags

image

tripleo-common

A common library for TripleO workflows.

Action Development

When developing new actions, you will checkout a copy of tripleo-common to an undercloud machine and add actions as needed. To test the actions they need to be installed and selected services need to be restarted. Use the following code to accomplish these tasks. :

sudo rm -Rf /usr/lib/python2.7/site-packages/tripleo_common*
sudo python setup.py install
sudo cp /usr/share/tripleo-common/sudoers /etc/sudoers.d/tripleo-common
sudo systemctl restart openstack-mistral-executor
sudo systemctl restart openstack-mistral-engine
# this loads the actions via entrypoints
sudo mistral-db-manage populate
# make sure the new actions got loaded
mistral action-list | grep tripleo

Workflow Development

When developing new workflows, you will need to reload the modified workflows, e.g the following will reload all the workflows from the default packaged location, or you can use a similar approach to replace only a single workbook while under development. :

for workbook in $(openstack workbook list -f value -c Name | grep tripleo); do
    openstack workbook delete $workbook
done
for workflow in $(openstack workflow list -f value -c Name | grep tripleo); do
    openstack workflow delete $workflow
done
for workbook in $(ls /usr/share/openstack-tripleo-common/workbooks/*); do
    openstack workbook create $workbook
done

Validations

Prerequisites

If you haven't installed the undercloud with the enable_validations set to true, you will have to prepare your undercloud to run the validations:

$ sudo pip install git+https://opendev.org/openstack/tripleo-validations
$ sudo yum install ansible
$ sudo useradd validations

Finally you need to generate an SSH keypair for the validation user and copy it to the overcloud's authorized_keys files:

$ mistral execution-create tripleo.validations.v1.copy_ssh_key

Running validations using the mistral workflow

Create a context.json file containing the arguments passed to the workflow:

{
  "validation_names": ["512e", "rabbitmq-limits"]
}

Run the tripleo.validations.v1.run_validations workflow with mistral client:

mistral execution-create tripleo.validations.v1.run_validations context.json

Running groups of validations

Create a context.json file containing the arguments passed to the workflow:

{
  "group_names": ["network", "post-deployment"]
}

Run the tripleo.validations.v1.run_groups workflow with mistral client:

mistral execution-create tripleo.validations.v1.run_groups context.json