OpenStack Placement Puppet Module
Go to file
Andreas Jaeger c0920d5e36 Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Disable openstackdocs_auto_name to use 'project' variable as name.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: I924c6661c222917aa2f301bc11cdb9c1786dde4b
2020-06-02 15:00:55 +02:00
doc Switch to newer openstackdocstheme and reno versions 2020-06-02 15:00:55 +02:00
examples Convert all class usage to relative names 2019-12-08 23:19:32 +01:00
lib/puppet Use anchor to require necessary packages 2020-05-04 02:03:22 +09:00
manifests Fix api.pp "Unknown variable" 2020-05-30 14:18:54 +02:00
releasenotes Switch to newer openstackdocstheme and reno versions 2020-06-02 15:00:55 +02:00
spec Add support for allocation_conflict_retry_count 2020-05-20 21:41:32 +09:00
.gitignore Add .gitignore file 2018-12-20 10:39:55 +08:00
.gitreview OpenDev Migration Patch 2019-04-19 19:33:57 +00:00
.zuul.yaml Add release note jobs 2019-03-27 09:02:58 -06:00
CONTRIBUTING.rst [ussuri][goal] Add CONTRIBUTING.rst 2020-05-10 22:50:18 +02:00
Gemfile Move to opendev 2019-04-21 14:44:49 +08:00
LICENSE Initial cookiecutter run and import from puppet-nova 2018-12-11 10:40:58 +00:00
README.md Change rpsec to rspec 2020-04-30 13:24:46 +08:00
Rakefile Initial cookiecutter run and import from puppet-nova 2018-12-11 10:40:58 +00:00
bindep.txt Add packages needed by tests 2018-12-20 10:43:16 +08:00
metadata.json Update Puppet requirement to >= 6.0.0 2020-05-30 09:54:57 +02:00
setup.cfg Cleanup docs, testing and missed things 2018-12-13 09:37:43 +01:00
setup.py Initial cookiecutter run and import from puppet-nova 2018-12-11 10:40:58 +00:00
tox.ini [ussuri][goal] Cleanup for python 2.7 drop 2020-02-15 20:46:16 -06:00

README.md

Team and repository tags

Team and repository tags

Table of Contents

  1. Overview - What is the placement module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with placement
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Beaker-Rspec - Beaker-rspec tests for the project
  7. Development - Guide for contributing to the module
  8. Contributors - Those with commits

Overview

The placement module is a part of OpenStack, an effort by the OpenStack infrastructure team to provide continuous integration testing and code review for OpenStack and OpenStack community projects not part of the core software. The module its self is used to flexibly configure and manage the placement service for OpenStack.

Module Description

The placement module is a thorough attempt to make Puppet capable of managing the entirety of placement. This includes manifests to provision region specific endpoint and database connections. Types are shipped as part of the placement module to assist in manipulation of configuration files.

Setup

What the placement module affects

  • Placement, the placement service for OpenStack.

Installing placement

placement is not currently in Puppet Forge, but is anticipated to be added soon.  Once that happens, you'll be able to install placement with:
puppet module install openstack/placement

Beginning with placement

To utilize the placement module's functionality you will need to declare multiple resources.

Implementation

placement

placement is a combination of Puppet manifest and ruby code to delivery configuration and extra functionality through types and providers.

Limitations

  • All the placement types use the CLI tools and so need to be ran on the placement node.

Beaker-Rspec

This module has beaker-rspec tests

To run the tests on the default vagrant node:

bundle install
bundle exec rake acceptance

For more information on writing and running beaker-rspec tests visit the documentation:

Development

Developer documentation for the entire puppet-openstack project.

Contributors