Files
07663d76e4605194270c8b823cd122297246a5c6
puppet-openstack-integration /README.md

145 lines
7.7 KiB
Markdown
Raw Normal View History

========================
[![Team and repository tags](https://governance.openstack.org/tc/badges/puppet-openstack-integration.svg)](https://governance.openstack.org/tc/reference/tags/index.html)
<!-- Change things from this point on -->
============================
#### Table of Contents
1. [Overview - What is Puppet OpenStack Integration?](#overview)
2. [Description - What does the project do?](#description)
3. [Development - Guide for contributing](#development)
Overview
--------
Puppet OpenStack Integration makes sure we can continuously test and validate
OpenStack setups deployed with Puppet modules. The repository itself contains
some scripts and Puppet manifests that help to deploy OpenStack in OpenStack
Infrastructure environment.
Description
-----------
OpenStack Infrastructure is deploying 5 jobs per supported Operating System
scenario005.
The manifest files under the fixtures directory is used to compose the required
services for each senario. The manifest files under the manifests directory
is used to set up basic set of a single component (like nova, cinder and so on).
OpenStack services are balanced between 5 scenarios because OpenStack
Infastructure Jenkins slaves can not afford the load of running everything on
the same node.
|:----------:|:-----------:|:-----------:|:-----------:|:-----------:|:-----------:|:------------:|
| ssl | yes | yes | yes | yes | yes | no |
| ipv6 | centos9 | centos9 | centos9 | centos9 | centos9 | no |
| keystone | X | X | X | X | X | X |
| placement | X | X | X | X | X | X |
| neutron | ovs | ovs | ovn | ovs | ovn | ovs |
| ceilometer | X | X | | | | |
| aodh | X | X | | | | |
| designate | | | bind | | | |
| heat | X | | X | | | |
| swift | | X | | | | |
| trove | | | X | | | |
| zaqar | | X | | | | |
| magnum | | | X | | | |
| mistral | | | X | | | |
| barbican | | X | X | | | |
| ceph | X | | | X | | |
| ceph mds | | | | X | | |
| ceph rgw | | | | X | | |
| vitrage | X | | | | | |
| bgp-dr | | | | X | | |
| octavia | | | | X | X | |
| jobboard | | | | redis | sentinel | |
When the Jenkins slave is created, the *run_tests.sh* script will be executed.
with all Puppet modules dependencies.
Then, it will execute Puppet a first time by applying a scenario manifest.
If the first run executes without error, a second Puppet run will be executed to
verify there is no change in the catalog and make sure the Puppet run is
idempotent.
If Puppet runs are successful, the script will run
[Tempest](https://docs.openstack.org/tempest/latest/overview.html) Smoke
validate, and does not take too much time.
Development
-----------
Developer documentation for the entire Puppet OpenStack project:
* https://docs.openstack.org/puppet-openstack-guide/latest
----------------------
puppet-openstack-integration ships it's own SSL keys and certificates in order
to be able to test implementations secured over SSL/TLS.
It doesn't re-generate new ones every time for the sake of simplicity: we're
not testing that we can generate certificates properly, we're testing services.
The configuration as well as the commands used to generate these keys and
certificates are stored in the contrib directory.
----------
If you're new in Puppet OpenStack and you want to deploy an All-In-One setup of
an OpenStack Cloud with the Puppet modules, please follow the steps:
```bash
git clone https://opendev.org/openstack/puppet-openstack-integration
./all-in-one.sh
```
Look at [Description](#description) to see which services it will install
------------
* https://github.com/openstack/puppet-openstack-integration/graphs/contributors