History

Alex Kavanagh 6ba683d23e Updates for caracal testing support These updates, on the master branch, are to support testing the caracal packages and support of the charms for caracal. They do NOT lock the charms down, and don't change the testing branches to stable branches. Change-Id: I1d277dfe9b80d550b83eb9e4814cf43b4e55bf30		2024-02-24 19:57:58 +00:00
..
files	Release sync for 20.08	2020-07-27 20:58:45 +01:00
lib	Add wallaby package version	2021-04-13 13:28:10 +00:00
reactive	Prevent update-status to run unrequired handlers	2023-04-19 09:56:31 -04:00
templates/train	Let placement log to syslog	2020-09-18 10:52:24 +02:00
tests	Updates for caracal testing support	2024-02-24 19:57:58 +00:00
HACKING.md	Initial Commit	2019-10-15 18:13:51 +00:00
README.md	Review README	2021-02-23 22:17:46 -05:00
config.yaml	Add 2023.2 Bobcat support	2023-08-02 14:24:30 -04:00
copyright	Initial Commit	2019-10-15 18:13:51 +00:00
icon.svg	Remove inherited configuration options invalid for charm	2020-05-18 10:03:08 +02:00
layer.yaml	Revert part of "Remove inherited configuration ..."	2020-07-21 14:23:52 +01:00
metadata.yaml	Updates for caracal testing support	2024-02-24 19:57:58 +00:00
test-requirements.txt	Fix charm for tox4 compatibility	2023-01-17 09:26:56 +00:00
tox.ini	Updates for caracal testing support	2024-02-24 19:57:58 +00:00
wheelhouse.txt	Updates to flip all libraries back to master	2021-05-03 16:10:43 +01:00

README.md

Overview

The placement charm deploys Placement, the core OpenStack API service that tracks the inventory and usage of various cloud resources (e.g. compute, storage, network addresses). The charm works alongside other Juju-deployed OpenStack services.

Note: The placement charm is supported starting with OpenStack Train.

Usage

Configuration

This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.

`openstack-origin`

The openstack-origin option states the software sources. A common value is an OpenStack UCA release (e.g. 'cloud:bionic-ussuri' or 'cloud:focal-victoria'). See Ubuntu Cloud Archive. The underlying host's existing apt sources will be used if this option is not specified (this behaviour can be explicitly chosen by using the value of 'distro').

Deployment

Placement is often containerised. Here a single unit is deployed to a new container on machine '1':

juju deploy --to lxd:1 placement

Placement requires these applications to be present: keystone, nova-cloud-controller, and a cloud database.

The database application is determined by the series. Prior to focal percona-cluster is used, otherwise it is mysql-innodb-cluster. In the example deployment below mysql-innodb-cluster has been chosen.

juju deploy mysql-router placement-mysql-router
juju add-relation placement-mysql-router:db-router mysql-innodb-cluster:db-router
juju add-relation placement-mysql-router:shared-db placement:shared-db

Add relations to the remaining applications:

juju add-relation placement:identity-service keystone:identity-service
juju add-relation placement:placement nova-cloud-controller:placement

Upgrading to OpenStack Train

Prior to OpenStack Train, the placement API was managed by the nova-cloud-controller charm. Some extra steps are therefore needed when performing a Stein to Train upgrade. The documented procedure can be found on the Special charm procedures page in the OpenStack Charms Deployment Guide.

High availability

When more than one unit is deployed with the hacluster application the charm will bring up an HA active/active cluster.

There are two mutually exclusive high availability options: using virtual IP(s) or DNS. In both cases the hacluster subordinate charm is used to provide the Corosync and Pacemaker backend HA functionality.

See Infrastructure high availability in the OpenStack Charms Deployment Guide for details.

Documentation

The OpenStack Charms project maintains two documentation guides:

OpenStack Charm Guide: for project information, including development and support notes
OpenStack Charms Deployment Guide: for charm usage information

Bugs

Please report bugs on Launchpad.