A Python library for code common to TripleO CLI and TripleO UI.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Zuul 217985840b Merge "Also write NetworkConfig to role dir" 1 day ago
container-images Remove pika from container builds 4 days ago
contrib Rename contrib to container-images for packaging 2 years ago
doc/source Fix bashate and flake8 errors 1 month ago
healthcheck Fix bashate and flake8 errors 1 month ago
heat_docker_agent Remove /etc/os-net-config/config.json in os-apply-config 1 year ago
image-yaml remove plotnetcfg from overcloud image yaml 2 weeks ago
releasenotes Merge "Ensure that OctaviaServerCertsKeyPassphrase is 32-byte long" 1 week ago
roles Merge "Create <service> _cell_node_names if nova_additional_cell" 1 day ago
scripts Exit 1 when container image prepare fails 1 week ago
tools Add bashate in gate jobs and fix existing errors 10 months ago
tripleo_common Merge "Also write NetworkConfig to role dir" 1 day ago
undercloud_heat_plugins Add custom subclass to revert mapping 1 year ago
workbooks Merge "Added support of overcloud os_cloud" 4 days ago
zuul.d Merge "Remove roles that have been imported into tripleo-ansible" 6 days ago
.ansible-lint Linting hardening via pre-commit 2 weeks ago
.coveragerc Make coverage tests work 3 years ago
.gitignore [Configuration] Remove testrepository. 5 months ago
.gitreview OpenDev Migration Patch 2 months ago
.mailmap Initial Cookiecutter Commit. 4 years ago
.pre-commit-config.yaml Linting hardening via pre-commit 2 weeks ago
.stestr.conf Use stestr for unit tests 7 months ago
CONTRIBUTING.rst Fix non-exiting link to TripleO-common bugs 7 months ago
HACKING.rst Update the documentation link for doc migration 2 years ago
LICENSE Initial Cookiecutter Commit. 4 years ago
README.rst Replace git.openstack.org URLs with opendev.org URLs 1 month ago
babel.cfg Initial Cookiecutter Commit. 4 years ago
bindep.txt Add bindep support to tox 1 month ago
lower-constraints.txt Linting hardening via pre-commit 2 weeks ago
requirements.txt Use oslo_rootwrap subprocess module in order to gain proper eventlet awareness 2 months ago
setup.cfg Merge "Added support of overcloud os_cloud" 4 days ago
setup.py Updated from global requirements 2 years ago
sudoers Add sudo commands for validations tempfile created in Python3 1 week ago
test-requirements.txt Linting hardening via pre-commit 2 weeks ago
tox.ini Linting hardening via pre-commit 2 weeks ago

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