Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A common library for TripleO workflows.

Project Description

========================
Team and repository tags
========================

.. image:: https://governance.openstack.org/tc/badges/tripleo-common.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html

.. Change things from this point on

==============
tripleo-common
==============

A common library for TripleO workflows.

* Free software: Apache license
* Documentation: https://docs.openstack.org/tripleo-common/latest/
* Source: http://git.openstack.org/cgit/openstack/tripleo-common
* Bugs: https://bugs.launchpad.net/tripleo-common

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://git.openstack.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



Release History

This version
History Node

8.4.0

History Node

8.3.0

History Node

8.2.0

History Node

8.1.0

History Node

8.0.0

History Node

7.6.9

History Node

7.6.8

History Node

7.6.7

History Node

7.6.6

History Node

7.6.5

History Node

7.6.4

History Node

7.6.3

History Node

7.6.2

History Node

7.6.1

History Node

7.6.0

History Node

7.5.0

History Node

7.4.0

History Node

7.3.0

History Node

7.2.0

History Node

7.1.0

History Node

7.0.0

History Node

7.0.0.0b1

History Node

6.1.5

History Node

6.1.4

History Node

6.1.3

History Node

6.1.2

History Node

6.1.1

History Node

6.1.0

History Node

6.0.0

History Node

5.8.0

History Node

5.7.0

History Node

5.6.0

History Node

5.5.0

History Node

5.4.7

History Node

5.4.6

History Node

5.4.5

History Node

5.4.4

History Node

5.4.3

History Node

5.4.2

History Node

5.4.1

History Node

5.4.0

History Node

5.3.0

History Node

5.2.0

History Node

5.1.0

History Node

5.0.0

History Node

5.0.0.0b2

History Node

5.0.0.0b1

History Node

2.2.0

History Node

2.1.0

History Node

2.0.0

History Node

1.0.0

History Node

0.3.1

History Node

0.3.0

History Node

0.2.1

History Node

0.2.0

History Node

0.1.1

History Node

0.1.0

History Node

0.0.2

History Node

0.0.1

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
tripleo_common-8.4.0-py2-none-any.whl
(330.8 kB) Copy SHA256 Hash SHA256
Wheel py2 Jan 30, 2018
tripleo-common-8.4.0.tar.gz
(245.7 kB) Copy SHA256 Hash SHA256
Source None Jan 30, 2018

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting