RETIRED, A Python library for code common to TripleO CLI and TripleO UI.
Go to file
Tony Breeds 876ef274f3 Uncap jsonschema
We have jsonschema capped at a fairly old version. Other than some
specific releases, it looks like keeping it below 3.0 was added in
I943fd68b9fab3bce1764305a5058df5339470757 without really any explanation
why.

In order to update to a 3.x release we need to:
1. Remove the cap from global-requirements.txt (see Depends-On), leaving
   upper-constraints.txt at a 2.x release
2. Remove the cap from all consumers (this change)
3. Release a new version of consumers that are published to pypi
4. Update upper-constraints.txt with those new releases
5. Update jsonschema in upper-constraints.txt to a 3.X release
   (See: https://review.openstack.org/649789)
6. Test consumers with the change from 5.
7. [Optional] fix issues in consumers that arise from 6.
8. Merge the change from 5.

Change-Id: Ic782c3085fb85634d2ae2b7d5538ae2948d2f9b8
Co-Authored-by: Sean McGinnis <sean.mcginnis@gmail.com>
Depends-On: https://review.openstack.org/649669
2019-04-04 14:01:34 +11:00
ansible_plugins/callback Ansible json error callback plugin 2018-05-31 07:46:10 -04:00
container-images Revert "Stop dumb-init usage" 2019-03-29 12:41:18 +00:00
contrib Rename contrib to container-images for packaging 2017-04-07 16:56:29 +12:00
doc/source Merge "Fix Sphinx warnings on auto generated workbooks docs" 2019-02-19 16:22:56 +00:00
healthcheck Silent file descriptor checks 2019-03-28 08:00:18 +01:00
heat_docker_agent Remove /etc/os-net-config/config.json in os-apply-config 2018-03-22 18:44:00 -04:00
image-yaml Merge "don't install "yum-plugin-priorities" as it part of DNF" 2019-01-23 03:23:32 +00:00
playbooks Merge "Octavia: set selinux contexts on ansible generated configuration" 2019-03-27 19:16:51 +00:00
releasenotes Merge "Fix running the baremetal provide workflow with node names" 2019-03-19 17:21:50 +00:00
roles Merge "Tasks for cleaning up after tripleo_persist and tripleo_transfer" 2019-03-19 14:29:33 +00:00
scripts Make validation inputs configurable via Mistral 2019-04-01 10:43:11 +00:00
tools Add bashate in gate jobs and fix existing errors 2018-09-17 11:36:57 +02:00
tripleo_common Merge "Add passphrase generation for Octavia" 2019-04-03 23:02:11 +00:00
undercloud_heat_plugins Add custom subclass to revert mapping 2018-03-27 12:33:24 +02:00
workbooks Merge "Set the private key for undercloud tripleo-admin" 2019-04-03 16:35:37 +00:00
zuul.d turn voting/gating on scen009 master 2019-04-02 20:14:31 +00: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 Added .gitreview 2015-04-09 13:57:40 +00:00
.mailmap Initial Cookiecutter Commit. 2015-04-29 13:34:49 +02: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 Update README to pass RST strict test 2018-08-24 07:39:52 -04:00
babel.cfg Initial Cookiecutter Commit. 2015-04-29 13:34:49 +02:00
lower-constraints.txt add lower-constraints job 2019-03-26 09:52:39 -06:00
requirements.txt Uncap jsonschema 2019-04-04 14:01:34 +11:00
setup.cfg Merge "nova-less-deploy: implement deploy_roles workflow" 2019-03-13 00:24:31 +00:00
setup.py Updated from global requirements 2017-03-10 03:40:32 +00:00
sudoers Make validation inputs configurable via Mistral 2019-04-01 10:43:11 +00:00
test-requirements.txt Update hacking version 2018-12-31 16:54:36 +00:00
tox.ini add lower-constraints job 2019-03-26 09:52:39 -06: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://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