openstack
/
charm-deployment-guide
Code Issues Proposed changes

Update guide to 2023.1 

Update Juju and MAAS versions.

Make some minor text improvements, including links to
charms.

Use channel-specific Charmhub links for charms

Change-Id: I04ab75a56f4311ffb7ec49f4627b75e5d24ef4c6
This commit is contained in:
Peter Matulis 2023-06-14 17:37:33 -04:00
parent 5de91da169
commit d7591029fe
6 changed files with 234 additions and 222 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
deploy-guide/source/configure-openstack.rst
View File

@ -62,9 +62,9 @@ Sample output:
.. code-block:: console
OS_AUTH_URL=https://10.246.114.25:5000/v3
OS_AUTH_URL=https://10.246.114.43:5000/v3
OS_USERNAME=admin
OS_PASSWORD=Aichohv7aigheiba
OS_PASSWORD=joongieVooj6hee4
OS_USER_DOMAIN_NAME=admin_domain
OS_PROJECT_NAME=admin
OS_PROJECT_DOMAIN_NAME=admin_domain
@ -97,12 +97,12 @@ The output will look similar to this:
+----------------------------------+-----------+--------------+--------------+---------+-----------+---------------------------------------------+
| ID | Region | Service Name | Service Type | Enabled | Interface | URL |
+----------------------------------+-----------+--------------+--------------+---------+-----------+---------------------------------------------+
| 3c48cac8e70e47698d38d1611fc6e224 | RegionOne | keystone | identity | True | admin | https://10.246.114.25:35357/v3 |
| 5ba390395df64adf89f45f32d27969ae | RegionOne | cinderv3 | volumev3 | True | admin | https://10.246.114.43:8776/v3/$(tenant_id)s |
| 761629b7f09547cc8b84de5b207b3726 | RegionOne | glance | image | True | admin | https://10.246.114.19:9292 |
| b58ea16e6e2e4919ba5ace59e376c361 | RegionOne | nova | compute | True | admin | https://10.246.114.37:8774/v2.1 |
| cca67377a66d4900820141284c93c52d | RegionOne | placement | placement | True | admin | https://10.246.114.38:8778 |
| ff4947f47e5f480fb8ba90dbde673c6f | RegionOne | neutron | network | True | admin | https://10.246.114.24:9696 |
| 00fa919f9d724339a4ce15f94306d6c7 | RegionOne | placement | placement | True | admin | https://10.246.114.46:8778 |
| a295322156f34db185a8af66c0863609 | RegionOne | nova | compute | True | admin | https://10.246.114.45:8774/v2.1 |
| ab99b7e5f63144af8bf5df4645007d57 | RegionOne | keystone | identity | True | admin | https://10.246.114.43:35357/v3 |
| cb564a77d07d49a084b27a20d9a209d9 | RegionOne | cinderv3 | volumev3 | True | admin | https://10.246.115.15:8776/v3/$(tenant_id)s |
| d3889e5eeb184cad9ab010a766deeb1d | RegionOne | glance | image | True | admin | https://10.246.115.11:9292 |
| d7eaf43dfe97492b8ca9325c1c769e81 | RegionOne | neutron | network | True | admin | https://10.246.114.31:9696 |
+----------------------------------+-----------+--------------+--------------+---------+-----------+---------------------------------------------+
If the endpoints aren't displayed, it's likely your environment variables
@ -226,14 +226,14 @@ environment:
echo $OS_AUTH_URL
The output for the last command for this example is
**https://10.246.114.25:5000/v3**.
**https://10.246.114.43:5000/v3**.
The contents of the file, say ``project1-rc``, will therefore look like this
(assuming the user password is 'ubuntu'):
.. code-block:: ini
export OS_AUTH_URL=https://10.246.114.25:5000/v3
export OS_AUTH_URL=https://10.246.114.43:5000/v3
export OS_USER_DOMAIN_NAME=domain1
export OS_USERNAME=user1
export OS_PROJECT_DOMAIN_NAME=domain1
@ -380,7 +380,7 @@ The instance is ready when the output contains:
.
.
.
Ubuntu 22.04.1 LTS jammy-1 ttyS0
Ubuntu 22.04.2 LTS jammy-1 ttyS0
jammy-1 login:

6
deploy-guide/source/index.rst
View File

@ -25,9 +25,9 @@ The software versions used in this guide are as follows:
* **Ubuntu 22.04 LTS (Jammy)** for the Juju client, Juju controller, and all
cloud nodes (including containers)
* **MAAS 3.2.6**
* **Juju 2.9.38**
* **OpenStack Zed**
* **MAAS 3.3.3**
* **Juju 2.9.43**
* **OpenStack 2023.1 (Antelope)**
Cloud description
-----------------

2
deploy-guide/source/install-juju.rst
View File

@ -108,7 +108,7 @@ the environment. It should now look very similar to this:
.. code-block:: none
Model Controller Cloud/Region Version SLA Timestamp
openstack maas-controller maas-one/default 2.9.38 unsupported 20:28:32Z
openstack maas-controller maas-one/default 2.9.43 unsupported 20:28:32Z
Model "admin/openstack" is empty.

8
deploy-guide/source/install-maas.rst
View File

@ -72,7 +72,7 @@ instructions`_ for details:
.. code-block:: none
sudo snap install maas-test-db
sudo snap install maas --channel=3.2/stable
sudo snap install maas --channel=3.3/stable
sudo maas init region+rack --maas-url http://10.246.112.3:5240/MAAS --database-uri maas-test-db:///
sudo maas createadmin --username admin --password ubuntu --email admin@example.com --ssh-import lp:<unsername>
sudo maas apikey --username admin > ~ubuntu/admin-api-key
@ -187,9 +187,9 @@ Tag nodes
MAAS tags will be used to help organise and manage the five nodes.
Tags are added on the ``Configuration`` tab on a node's configuration page.
Add tag 'compute' to the four cloud nodes and tag 'juju' to the Juju controller
node.
Tags are added on the ``Configuration`` tab on a node's configuration page or
via the green **Take action** button once you've selected the node. Add tag
'compute' to the four cloud nodes and tag 'juju' to the Juju controller node.
See `MAAS tags`_ in the MAAS documentation for a full understanding of tags.

178
deploy-guide/source/install-openstack-juju-status.rst
View File

@ -13,101 +13,101 @@ installed from the instructions given on the :doc:`Install OpenStack
.. code-block:: console
Model Controller Cloud/Region Version SLA Timestamp
openstack maas-controller maas-one/default 2.9.38 unsupported 18:51:46Z
openstack maas-controller maas-one/default 2.9.43 unsupported 21:31:50Z
App Version Status Scale Charm Channel Rev Exposed Message
ceph-mon 17.2.0 active 3 ceph-mon quincy/stable 149 no Unit is ready and clustered
ceph-osd 17.2.0 active 4 ceph-osd quincy/stable 541 no Unit is ready (4 OSD)
ceph-radosgw 17.2.0 active 1 ceph-radosgw quincy/stable 542 no Unit is ready
cinder 21.1.0 active 1 cinder zed/stable 594 no Unit is ready
cinder-ceph 21.1.0 active 1 cinder-ceph zed/stable 513 no Unit is ready
cinder-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
dashboard-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
glance 25.0.0 active 1 glance zed/stable 560 no Unit is ready
glance-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
keystone 22.0.0 active 1 keystone zed/stable 591 no Application Ready
keystone-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
mysql-innodb-cluster 8.0.32 active 3 mysql-innodb-cluster 8.0/stable 39 no Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
ncc-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
neutron-api 21.0.0 active 1 neutron-api zed/stable 546 no Unit is ready
neutron-api-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
neutron-api-plugin-ovn 21.0.0 active 1 neutron-api-plugin-ovn zed/stable 45 no Unit is ready
nova-cloud-controller 26.1.0 active 1 nova-cloud-controller zed/stable 633 no Unit is ready
nova-compute 26.1.0 active 3 nova-compute zed/stable 626 no Unit is ready
openstack-dashboard 23.0.0 active 1 openstack-dashboard zed/stable 564 no Unit is ready
ovn-central 22.09.0 active 3 ovn-central 22.09/stable 75 no Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-chassis 22.09.0 active 3 ovn-chassis 22.09/stable 109 no Unit is ready
placement 8.0.0 active 1 placement zed/stable 67 no Unit is ready
placement-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
rabbitmq-server 3.9.13 active 1 rabbitmq-server 3.9/stable 154 no Unit is ready
vault 1.8.8 active 1 vault 1.8/stable 86 no Unit is ready (active: true, mlock: disabled)
vault-mysql-router 8.0.32 active 1 mysql-router 8.0/stable 35 no Unit is ready
ceph-mon 17.2.5 active 3 ceph-mon quincy/stable 167 no Unit is ready and clustered
ceph-osd 17.2.5 active 4 ceph-osd quincy/stable 559 no Unit is ready (4 OSD)
ceph-radosgw 17.2.5 active 1 ceph-radosgw quincy/stable 548 no Unit is ready
cinder 22.0.0 active 1 cinder 2023.1/stable 625 no Unit is ready
cinder-ceph 22.0.0 active 1 cinder-ceph 2023.1/stable 524 no Unit is ready
cinder-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
dashboard-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
glance 26.0.0 active 1 glance 2023.1/stable 572 no Unit is ready
glance-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
keystone 23.0.0 active 1 keystone 2023.1/stable 642 no Application Ready
keystone-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
mysql-innodb-cluster 8.0.33 active 3 mysql-innodb-cluster 8.0/stable 56 no Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
ncc-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
neutron-api 22.0.0 active 1 neutron-api 2023.1/stable 552 no Unit is ready
neutron-api-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
neutron-api-plugin-ovn 22.0.0 active 1 neutron-api-plugin-ovn 2023.1/stable 73 no Unit is ready
nova-cloud-controller 27.0.0 active 1 nova-cloud-controller 2023.1/stable 665 no Unit is ready
nova-compute 27.0.0 active 3 nova-compute 2023.1/stable 662 no Unit is ready
openstack-dashboard 23.1.0 active 1 openstack-dashboard 2023.1/stable 578 no Unit is ready
ovn-central 23.03.0 active 3 ovn-central 23.03/stable 99 no Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-chassis 23.03.0 active 3 ovn-chassis 23.03/stable 134 no Unit is ready
placement 9.0.0 active 1 placement 2023.1/stable 87 no Unit is ready
placement-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
rabbitmq-server 3.9.13 active 1 rabbitmq-server 3.9/stable 177 no Unit is ready
vault 1.8.8 active 1 vault 1.8/stable 108 no Unit is ready (active: true, mlock: disabled)
vault-mysql-router 8.0.33 active 1 mysql-router 8.0/stable 35 no Unit is ready
Unit Workload Agent Machine Public address Ports Message
ceph-mon/0 active idle 0/lxd/4 10.246.114.20 Unit is ready and clustered
ceph-mon/1* active idle 1/lxd/4 10.246.114.22 Unit is ready and clustered
ceph-mon/2 active idle 2/lxd/5 10.246.114.21 Unit is ready and clustered
ceph-osd/0 active idle 0 10.246.114.17 Unit is ready (4 OSD)
ceph-osd/1* active idle 1 10.246.114.7 Unit is ready (4 OSD)
ceph-osd/2 active idle 2 10.246.114.11 Unit is ready (4 OSD)
ceph-osd/3 active idle 3 10.246.114.31 Unit is ready (2 OSD)
ceph-radosgw/0* active idle 0/lxd/5 10.246.114.44 80/tcp Unit is ready
cinder/0* active idle 1/lxd/5 10.246.114.43 8776/tcp Unit is ready
cinder-ceph/0* active idle 10.246.114.43 Unit is ready
cinder-mysql-router/0* active idle 10.246.114.43 Unit is ready
glance/0* active idle 3/lxd/3 10.246.114.19 9292/tcp Unit is ready
glance-mysql-router/0* active idle 10.246.114.19 Unit is ready
keystone/0* active idle 0/lxd/3 10.246.114.25 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.25 Unit is ready
mysql-innodb-cluster/3* active idle 0/lxd/1 10.246.114.12 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/4 active idle 1/lxd/1 10.246.114.15 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/5 active idle 2/lxd/1 10.246.114.14 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
neutron-api/0* active idle 1/lxd/3 10.246.114.24 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.24 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.24 Unit is ready
nova-cloud-controller/0* active idle 3/lxd/1 10.246.114.37 8774/tcp,8775/tcp Unit is ready
ncc-mysql-router/0* active idle 10.246.114.37 Unit is ready
nova-compute/0* active idle 1 10.246.114.7 Unit is ready
ovn-chassis/0* active idle 10.246.114.7 Unit is ready
nova-compute/1 active idle 2 10.246.114.11 Unit is ready
ovn-chassis/1 active idle 10.246.114.11 Unit is ready
nova-compute/2 active idle 3 10.246.114.31 Unit is ready
ovn-chassis/2 active idle 10.246.114.31 Unit is ready
openstack-dashboard/0* active idle 2/lxd/4 10.246.114.39 80/tcp,443/tcp Unit is ready
dashboard-mysql-router/0* active idle 10.246.114.39 Unit is ready
ovn-central/0* active idle 0/lxd/2 10.246.114.29 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/2 10.246.114.52 6641/tcp,6642/tcp Unit is ready
ovn-central/2 active idle 2/lxd/2 10.246.114.51 6641/tcp,6642/tcp Unit is ready (northd: active)
placement/0* active idle 3/lxd/2 10.246.114.38 8778/tcp Unit is ready
placement-mysql-router/0* active idle 10.246.114.38 Unit is ready
rabbitmq-server/0* active idle 2/lxd/3 10.246.114.26 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.28 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.28 Unit is ready
ceph-mon/0* active idle 0/lxd/3 10.246.115.14 Unit is ready and clustered
ceph-mon/1 active idle 1/lxd/3 10.246.115.12 Unit is ready and clustered
ceph-mon/2 active idle 2/lxd/4 10.246.115.13 Unit is ready and clustered
ceph-osd/0 active idle 0 10.246.114.38 Unit is ready (4 OSD)
ceph-osd/1* active idle 1 10.246.114.49 Unit is ready (4 OSD)
ceph-osd/2 active idle 2 10.246.114.39 Unit is ready (2 OSD)
ceph-osd/3 active idle 3 10.246.114.37 Unit is ready (4 OSD)
ceph-radosgw/0* active idle 0/lxd/4 10.246.115.16 80/tcp Unit is ready
cinder/0* active idle 1/lxd/4 10.246.115.15 8776/tcp Unit is ready
cinder-ceph/0* active idle 10.246.115.15 Unit is ready
cinder-mysql-router/0* active idle 10.246.115.15 Unit is ready
glance/0* active idle 3/lxd/3 10.246.115.11 9292/tcp Unit is ready
glance-mysql-router/0* active idle 10.246.115.11 Unit is ready
keystone/0* active idle 0/lxd/2 10.246.114.43 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.43 Unit is ready
mysql-innodb-cluster/0* active idle 0/lxd/0 10.246.114.20 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/1 active idle 1/lxd/0 10.246.114.21 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/2 active idle 2/lxd/0 10.246.114.19 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to ONE failure.
neutron-api/0* active idle 1/lxd/2 10.246.114.31 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.31 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.31 Unit is ready
nova-cloud-controller/0* active idle 3/lxd/1 10.246.114.45 8774/tcp,8775/tcp Unit is ready
ncc-mysql-router/0* active idle 10.246.114.45 Unit is ready
nova-compute/0* active idle 1 10.246.114.49 Unit is ready
ovn-chassis/0 active idle 10.246.114.49 Unit is ready
nova-compute/1 active idle 2 10.246.114.39 Unit is ready
ovn-chassis/2 active idle 10.246.114.39 Unit is ready
nova-compute/2 active idle 3 10.246.114.37 Unit is ready
ovn-chassis/1* active idle 10.246.114.37 Unit is ready
openstack-dashboard/0* active idle 2/lxd/3 10.246.114.47 80/tcp,443/tcp Unit is ready
dashboard-mysql-router/0* active idle 10.246.114.47 Unit is ready
ovn-central/0* active idle 0/lxd/1 10.246.114.30 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/1 10.246.114.28 6641/tcp,6642/tcp Unit is ready (northd: active)
ovn-central/2 active idle 2/lxd/1 10.246.114.29 6641/tcp,6642/tcp Unit is ready
placement/0* active idle 3/lxd/2 10.246.114.46 8778/tcp Unit is ready
placement-mysql-router/0* active idle 10.246.114.46 Unit is ready
rabbitmq-server/0* active idle 2/lxd/2 10.246.114.44 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.22 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.22 Unit is ready
Machine State Address Inst id Series AZ Message
0 started 10.246.114.17 node-laveran jammy default Deployed
0/lxd/1 started 10.246.114.12 juju-57df23-0-lxd-1 jammy default Container started
0/lxd/2 started 10.246.114.29 juju-57df23-0-lxd-2 jammy default Container started
0/lxd/3 started 10.246.114.25 juju-57df23-0-lxd-3 jammy default Container started
0/lxd/4 started 10.246.114.20 juju-57df23-0-lxd-4 jammy default Container started
0/lxd/5 started 10.246.114.44 juju-57df23-0-lxd-5 jammy default Container started
1 started 10.246.114.7 node-mees jammy default Deployed
1/lxd/1 started 10.246.114.15 juju-57df23-1-lxd-1 jammy default Container started
1/lxd/2 started 10.246.114.52 juju-57df23-1-lxd-2 jammy default Container started
1/lxd/3 started 10.246.114.24 juju-57df23-1-lxd-3 jammy default Container started
1/lxd/4 started 10.246.114.22 juju-57df23-1-lxd-4 jammy default Container started
1/lxd/5 started 10.246.114.43 juju-57df23-1-lxd-5 jammy default Container started
2 started 10.246.114.11 node-fontana jammy default Deployed
2/lxd/1 started 10.246.114.14 juju-57df23-2-lxd-1 jammy default Container started
2/lxd/2 started 10.246.114.51 juju-57df23-2-lxd-2 jammy default Container started
2/lxd/3 started 10.246.114.26 juju-57df23-2-lxd-3 jammy default Container started
2/lxd/4 started 10.246.114.39 juju-57df23-2-lxd-4 jammy default Container started
2/lxd/5 started 10.246.114.21 juju-57df23-2-lxd-5 jammy default Container started
3 started 10.246.114.31 node-sparky jammy default Deployed
3/lxd/0 started 10.246.114.28 juju-57df23-3-lxd-0 jammy default Container started
3/lxd/1 started 10.246.114.37 juju-57df23-3-lxd-1 jammy default Container started
3/lxd/2 started 10.246.114.38 juju-57df23-3-lxd-2 jammy default Container started
3/lxd/3 started 10.246.114.19 juju-57df23-3-lxd-3 jammy default Container started
0 started 10.246.114.38 node-fontana jammy default Deployed
0/lxd/0 started 10.246.114.20 juju-d99290-0-lxd-0 jammy default Container started
0/lxd/1 started 10.246.114.30 juju-d99290-0-lxd-1 jammy default Container started
0/lxd/2 started 10.246.114.43 juju-d99290-0-lxd-2 jammy default Container started
0/lxd/3 started 10.246.115.14 juju-d99290-0-lxd-3 jammy default Container started
0/lxd/4 started 10.246.115.16 juju-d99290-0-lxd-4 jammy default Container started
1 started 10.246.114.49 node-mees jammy default Deployed
1/lxd/0 started 10.246.114.21 juju-d99290-1-lxd-0 jammy default Container started
1/lxd/1 started 10.246.114.28 juju-d99290-1-lxd-1 jammy default Container started
1/lxd/2 started 10.246.114.31 juju-d99290-1-lxd-2 jammy default Container started
1/lxd/3 started 10.246.115.12 juju-d99290-1-lxd-3 jammy default Container started
1/lxd/4 started 10.246.115.15 juju-d99290-1-lxd-4 jammy default Container started
2 started 10.246.114.39 node-sparky jammy default Deployed
2/lxd/0 started 10.246.114.19 juju-d99290-2-lxd-0 jammy default Container started
2/lxd/1 started 10.246.114.29 juju-d99290-2-lxd-1 jammy default Container started
2/lxd/2 started 10.246.114.44 juju-d99290-2-lxd-2 jammy default Container started
2/lxd/3 started 10.246.114.47 juju-d99290-2-lxd-3 jammy default Container started
2/lxd/4 started 10.246.115.13 juju-d99290-2-lxd-4 jammy default Container started
3 started 10.246.114.37 node-lepaute jammy default Deployed
3/lxd/0 started 10.246.114.22 juju-d99290-3-lxd-0 jammy default Container started
3/lxd/1 started 10.246.114.45 juju-d99290-3-lxd-1 jammy default Container started
3/lxd/2 started 10.246.114.46 juju-d99290-3-lxd-2 jammy default Container started
3/lxd/3 started 10.246.115.11 juju-d99290-3-lxd-3 jammy default Container started
Relation provider Requirer Interface Type Message
ceph-mon:client cinder-ceph:ceph ceph-client regular

240
deploy-guide/source/install-openstack.rst
View File

@ -29,7 +29,7 @@ The cloud deployment involves two levels of software:
* charm payload (e.g. Keystone service)
A charm's software version (its revision) is expressed via its channel (e.g.
'zed/stable'). Its payload version is auto-configured based on the channel,
'2023.1/stable'). Its payload version is auto-configured based on the channel,
but it can be overridden via the ``source`` configuration option (e.g.
internal mirror or PPA is needed). See the Charm Guide for more information:
@ -45,9 +45,9 @@ internal mirror or PPA is needed). See the Charm Guide for more information:
OpenStack release
-----------------
OpenStack Zed will be deployed atop Ubuntu 22.04 LTS (Jammy) cloud nodes. In
order to achieve this, charm channels appropriate for the chosen OpenStack
release will be used (see :doc:`cg:project/charm-delivery`).
OpenStack 2023.1 (Antelope) will be deployed atop Ubuntu 22.04 LTS (Jammy)
cloud nodes. In order to achieve this, charm channels appropriate for the
chosen OpenStack release will be used (see :doc:`cg:project/charm-delivery`).
See :ref:`cg:perform_the_upgrade` in the Charm Guide for more details on cloud
archive releases and how they are used when upgrading OpenStack.
@ -55,7 +55,8 @@ archive releases and how they are used when upgrading OpenStack.
.. important::
The chosen OpenStack release may impact the installation and configuration
instructions. **This guide assumes that OpenStack Zed is being deployed.**
instructions. **This guide assumes that OpenStack 2023.1 is being
deployed.**
Installation progress
---------------------
@ -152,7 +153,7 @@ our nodes. We've chosen machines 1, 2, and 3. To deploy:
.. code-block:: none
juju deploy -n 3 --to 1,2,3 --channel zed/stable --config nova-compute.yaml nova-compute
juju deploy -n 3 --to 1,2,3 --channel 2023.1/stable --config nova-compute.yaml nova-compute
.. note::
@ -165,8 +166,10 @@ our nodes. We've chosen machines 1, 2, and 3. To deploy:
MySQL InnoDB Cluster
~~~~~~~~~~~~~~~~~~~~
MySQL InnoDB Cluster always requires at least three database units. They will
be containerised on machines 0, 1, and 2. To deploy:
MySQL InnoDB Cluster always requires at least three database units. The
mysql-innodb-cluster application is deployed to three nodes with the
`mysql-innodb-cluster`_ charm. They will be containerised on machines 0, 1, and
2. To deploy:
.. code-block:: none
@ -176,8 +179,8 @@ Vault
~~~~~
Vault is necessary for managing the TLS certificates that will enable encrypted
communication between cloud applications. It will be containerised on machine
3. To deploy:
communication between cloud applications. The vault application will be
containerised on machine 3 with the `vault`_ charm. To deploy:
.. code-block:: none
@ -186,7 +189,8 @@ communication between cloud applications. It will be containerised on machine
This is the first application to be joined with the cloud database that was set
up in the previous section. The process is:
#. create an application-specific instance of mysql-router (a subordinate)
#. create an application-specific instance of mysql-router with the
`mysql-router`_ subordinate charm
#. add a relation between the mysql-router instance and the database
#. add a relation between the mysql-router instance and the application
@ -202,7 +206,7 @@ Here are the corresponding commands for Vault:
Vault must now be initialised and unsealed. The vault charm will also need to
be authorised to carry out certain tasks. These steps are covered in the `vault
charm`_ documentation. Perform them now.
charm documentation`_. Perform them now.
Provide Vault with a CA certificate so it can issue certificates to cloud API
services. This is covered on the :ref:`Managing TLS certificates
@ -214,18 +218,18 @@ status` should look similar to this:
.. code-block:: console
Unit Workload Agent Machine Public address Ports Message
ceph-osd/0 blocked idle 0 10.246.114.17 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.7 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.11 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.31 Missing relation: monitor
mysql-innodb-cluster/3* active idle 0/lxd/1 10.246.114.12 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/4 active idle 1/lxd/1 10.246.114.15 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/5 active idle 2/lxd/1 10.246.114.14 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
nova-compute/0* blocked idle 1 10.246.114.7 Missing relations: messaging, image
nova-compute/1 blocked idle 2 10.246.114.11 Missing relations: messaging, image
nova-compute/2 blocked idle 3 10.246.114.31 Missing relations: image, messaging
vault/0* active idle 3/lxd/0 10.246.114.28 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.28 Unit is ready
ceph-osd/0 blocked idle 0 10.246.114.38 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.49 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.39 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.37 Missing relation: monitor
mysql-innodb-cluster/0* active idle 0/lxd/0 10.246.114.20 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/1 active idle 1/lxd/0 10.246.114.21 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
mysql-innodb-cluster/2 active idle 2/lxd/0 10.246.114.19 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to ONE failure.
nova-compute/0* blocked idle 1 10.246.114.49 Missing relations: messaging, image
nova-compute/1 blocked idle 2 10.246.114.39 Missing relations: messaging, image
nova-compute/2 blocked idle 3 10.246.114.37 Missing relations: image, messaging
vault/0* active idle 3/lxd/0 10.246.114.22 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.22 Unit is ready
Cloud applications are TLS-enabled via the ``vault:certificates`` relation.
Below we start with the cloud database. Although the latter has a self-signed
@ -287,24 +291,27 @@ The ``ovn-bridge-mappings`` setting maps the data-port interface to the flat
network provider.
The main OVN application is ovn-central and it requires at least three units.
They will be containerised on machines 0, 1, and 2. To deploy:
They will be containerised on machines 0, 1, and 2 with the `ovn-central`_
charm. To deploy:
.. code-block:: none
juju deploy -n 3 --to lxd:0,lxd:1,lxd:2 --channel 22.09/stable ovn-central
juju deploy -n 3 --to lxd:0,lxd:1,lxd:2 --channel 23.03/stable ovn-central
The neutron-api application will be containerised on machine 1:
The neutron-api application will be containerised on machine 1 with the
`neutron-api`_ charm:
.. code-block:: none
juju deploy --to lxd:1 --channel zed/stable --config neutron.yaml neutron-api
juju deploy --to lxd:1 --channel 2023.1/stable --config neutron.yaml neutron-api
Deploy the subordinate charm applications:
Deploy the subordinate charm applications with the `neutron-api-plugin-ovn`_
and `ovn-chassis`_ charms:
.. code-block:: none
juju deploy --channel zed/stable neutron-api-plugin-ovn
juju deploy --channel 22.09/stable --config neutron.yaml ovn-chassis
juju deploy --channel 2023.1/stable neutron-api-plugin-ovn
juju deploy --channel 23.03/stable --config neutron.yaml ovn-chassis
Add the necessary relations:
@ -335,7 +342,7 @@ The keystone application will be containerised on machine 0 with the
.. code-block:: none
juju deploy --to lxd:0 --channel zed/stable keystone
juju deploy --to lxd:0 --channel 2023.1/stable keystone
Join keystone to the cloud database:
@ -375,33 +382,33 @@ look similar to this:
.. code-block:: console
Unit Workload Agent Machine Public address Ports Message
ceph-osd/0 blocked idle 0 10.246.114.17 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.7 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.11 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.31 Missing relation: monitor
keystone/0* active idle 0/lxd/3 10.246.114.25 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.25 Unit is ready
mysql-innodb-cluster/3* active idle 0/lxd/1 10.246.114.12 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ceph-osd/0 blocked idle 0 10.246.114.38 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.49 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.39 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.37 Missing relation: monitor
keystone/0* active idle 0/lxd/2 10.246.114.43 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.43 Unit is ready
mysql-innodb-cluster/0* active idle 0/lxd/0 10.246.114.20 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ONE failure.
mysql-innodb-cluster/4 active idle 1/lxd/1 10.246.114.15 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to
mysql-innodb-cluster/1 active idle 1/lxd/0 10.246.114.21 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ONE failure.
mysql-innodb-cluster/5 active idle 2/lxd/1 10.246.114.14 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
mysql-innodb-cluster/2 active idle 2/lxd/0 10.246.114.19 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to
ONE failure.
neutron-api/0* active idle 1/lxd/3 10.246.114.24 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.24 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.24 Unit is ready
nova-compute/0* blocked idle 1 10.246.114.7 Missing relations: image
ovn-chassis/0* active idle 10.246.114.7 Unit is ready
nova-compute/1 blocked idle 2 10.246.114.11 Missing relations: image
ovn-chassis/1 active idle 10.246.114.11 Unit is ready
nova-compute/2 blocked idle 3 10.246.114.31 Missing relations: image
ovn-chassis/2 active idle 10.246.114.31 Unit is ready
ovn-central/0* active idle 0/lxd/2 10.246.114.29 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/2 10.246.114.52 6641/tcp,6642/tcp Unit is ready
ovn-central/2 active idle 2/lxd/2 10.246.114.51 6641/tcp,6642/tcp Unit is ready (northd: active)
rabbitmq-server/0* active idle 2/lxd/3 10.246.114.26 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.28 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.28 Unit is ready
neutron-api/0* active idle 1/lxd/2 10.246.114.31 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.31 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.31 Unit is ready
nova-compute/0* blocked idle 1 10.246.114.49 Missing relations: image
ovn-chassis/0 active idle 10.246.114.49 Unit is ready
nova-compute/1 blocked idle 2 10.246.114.39 Missing relations: image
ovn-chassis/2 active idle 10.246.114.39 Unit is ready
nova-compute/2 blocked idle 3 10.246.114.37 Missing relations: image
ovn-chassis/1* active idle 10.246.114.37 Unit is ready
ovn-central/0* active idle 0/lxd/1 10.246.114.30 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/1 10.246.114.28 6641/tcp,6642/tcp Unit is ready (northd: active)
ovn-central/2 active idle 2/lxd/1 10.246.114.29 6641/tcp,6642/tcp Unit is ready
rabbitmq-server/0* active idle 2/lxd/2 10.246.114.44 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.22 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.22 Unit is ready
Nova cloud controller
~~~~~~~~~~~~~~~~~~~~~
@ -419,7 +426,7 @@ To deploy:
.. code-block:: none
juju deploy --to lxd:3 --channel zed/stable --config ncc.yaml nova-cloud-controller
juju deploy --to lxd:3 --channel 2023.1/stable --config ncc.yaml nova-cloud-controller
Join nova-cloud-controller to the cloud database:
@ -453,7 +460,7 @@ The placement application will be containerised on machine 3 with the
.. code-block:: none
juju deploy --to lxd:3 --channel zed/stable placement
juju deploy --to lxd:3 --channel 2023.1/stable placement
Join placement to the cloud database:
@ -479,7 +486,7 @@ The openstack-dashboard application (Horizon) will be containerised on machine
.. code-block:: none
juju deploy --to lxd:2 --channel zed/stable openstack-dashboard
juju deploy --to lxd:2 --channel 2023.1/stable openstack-dashboard
Join openstack-dashboard to the cloud database:
@ -510,7 +517,7 @@ charm. To deploy:
.. code-block:: none
juju deploy --to lxd:3 --channel zed/stable glance
juju deploy --to lxd:3 --channel 2023.1/stable glance
Join glance to the cloud database:
@ -535,41 +542,41 @@ look similar to this:
.. code-block:: console
Unit Workload Agent Machine Public address Ports Message
ceph-osd/0 blocked idle 0 10.246.114.17 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.7 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.11 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.31 Missing relation: monitor
glance/0* active idle 3/lxd/3 10.246.114.19 9292/tcp Unit is ready
glance-mysql-router/0* active idle 10.246.114.19 Unit is ready
keystone/0* active idle 0/lxd/3 10.246.114.25 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.25 Unit is ready
mysql-innodb-cluster/3* active idle 0/lxd/1 10.246.114.12 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ceph-osd/0 blocked idle 0 10.246.114.38 Missing relation: monitor
ceph-osd/1* blocked idle 1 10.246.114.49 Missing relation: monitor
ceph-osd/2 blocked idle 2 10.246.114.39 Missing relation: monitor
ceph-osd/3 blocked idle 3 10.246.114.37 Missing relation: monitor
glance/0* active idle 3/lxd/3 10.246.115.11 9292/tcp Unit is ready
glance-mysql-router/0* active idle 10.246.115.11 Unit is ready
keystone/0* active idle 0/lxd/2 10.246.114.43 5000/tcp Unit is ready
keystone-mysql-router/0* active idle 10.246.114.43 Unit is ready
mysql-innodb-cluster/0* active idle 0/lxd/0 10.246.114.20 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ONE failure.
mysql-innodb-cluster/4 active idle 1/lxd/1 10.246.114.15 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to
mysql-innodb-cluster/1 active idle 1/lxd/0 10.246.114.21 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
ONE failure.
mysql-innodb-cluster/5 active idle 2/lxd/1 10.246.114.14 Unit is ready: Mode: R/O, Cluster is ONLINE and can tolerate up to
mysql-innodb-cluster/2 active idle 2/lxd/0 10.246.114.19 Unit is ready: Mode: R/W, Cluster is ONLINE and can tolerate up to
ONE failure.
neutron-api/0* active idle 1/lxd/3 10.246.114.24 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.24 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.24 Unit is ready
nova-cloud-controller/0* active idle 3/lxd/1 10.246.114.37 8774/tcp,8775/tcp Unit is ready
ncc-mysql-router/0* active idle 10.246.114.37 Unit is ready
nova-compute/0* active idle 1 10.246.114.7 Unit is ready
ovn-chassis/0* active idle 10.246.114.7 Unit is ready
nova-compute/1 active idle 2 10.246.114.11 Unit is ready
ovn-chassis/1 active idle 10.246.114.11 Unit is ready
nova-compute/2 active idle 3 10.246.114.31 Unit is ready
ovn-chassis/2 active idle 10.246.114.31 Unit is ready
openstack-dashboard/0* active idle 2/lxd/4 10.246.114.39 80/tcp,443/tcp Unit is ready
dashboard-mysql-router/0* active idle 10.246.114.39 Unit is ready
ovn-central/0* active idle 0/lxd/2 10.246.114.29 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/2 10.246.114.52 6641/tcp,6642/tcp Unit is ready
ovn-central/2 active idle 2/lxd/2 10.246.114.51 6641/tcp,6642/tcp Unit is ready (northd: active)
placement/0* active idle 3/lxd/2 10.246.114.38 8778/tcp Unit is ready
placement-mysql-router/0* active idle 10.246.114.38 Unit is ready
rabbitmq-server/0* active idle 2/lxd/3 10.246.114.26 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.28 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.28 Unit is ready
neutron-api/0* active idle 1/lxd/2 10.246.114.31 9696/tcp Unit is ready
neutron-api-mysql-router/0* active idle 10.246.114.31 Unit is ready
neutron-api-plugin-ovn/0* active idle 10.246.114.31 Unit is ready
nova-cloud-controller/0* active idle 3/lxd/1 10.246.114.45 8774/tcp,8775/tcp Unit is ready
ncc-mysql-router/0* active idle 10.246.114.45 Unit is ready
nova-compute/0* active idle 1 10.246.114.49 Unit is ready
ovn-chassis/0 active idle 10.246.114.49 Unit is ready
nova-compute/1 active idle 2 10.246.114.39 Unit is ready
ovn-chassis/2 active idle 10.246.114.39 Unit is ready
nova-compute/2 active idle 3 10.246.114.37 Unit is ready
ovn-chassis/1* active idle 10.246.114.37 Unit is ready
openstack-dashboard/0* active idle 2/lxd/3 10.246.114.47 80/tcp,443/tcp Unit is ready
dashboard-mysql-router/0* active idle 10.246.114.47 Unit is ready
ovn-central/0* active idle 0/lxd/1 10.246.114.30 6641/tcp,6642/tcp Unit is ready (leader: ovnnb_db, ovnsb_db)
ovn-central/1 active idle 1/lxd/1 10.246.114.28 6641/tcp,6642/tcp Unit is ready (northd: active)
ovn-central/2 active idle 2/lxd/1 10.246.114.29 6641/tcp,6642/tcp Unit is ready
placement/0* active idle 3/lxd/2 10.246.114.46 8778/tcp Unit is ready
placement-mysql-router/0* active idle 10.246.114.46 Unit is ready
rabbitmq-server/0* active idle 2/lxd/2 10.246.114.44 5672/tcp,15672/tcp Unit is ready
vault/0* active idle 3/lxd/0 10.246.114.22 8200/tcp Unit is ready (active: true, mlock: disabled)
vault-mysql-router/0* active idle 10.246.114.22 Unit is ready
Ceph monitor
~~~~~~~~~~~~
@ -602,7 +609,7 @@ Three relations can be added at this time:
For the above relations,
* The nova-compute:ceph relation makes Ceph the storage backend for Nova
* The ``nova-compute:ceph`` relation makes Ceph the storage backend for Nova
non-bootable disk images. The nova-compute charm option
``libvirt-image-backend`` must be set to 'rbd' for this to take effect.
@ -624,7 +631,7 @@ To deploy:
.. code-block:: none
juju deploy --to lxd:1 --channel zed/stable --config cinder.yaml cinder
juju deploy --to lxd:1 --channel 2023.1/stable --config cinder.yaml cinder
Join cinder to the cloud database:
@ -654,7 +661,7 @@ None`` in the configuration file). This will be implemented via the
.. code-block:: none
juju deploy --channel zed/stable cinder-ceph
juju deploy --channel 2023.1/stable cinder-ceph
Three relations need to be added:
@ -722,7 +729,7 @@ Obtain the address in this way:
juju status --format=yaml openstack-dashboard | grep public-address | awk '{print $2}' | head -1
In this example, the address is '10.246.114.39'.
In this example, the address is '10.246.114.47'.
The password can be queried from Keystone:
@ -732,7 +739,7 @@ The password can be queried from Keystone:
The dashboard URL then becomes:
**http://10.246.114.39/horizon**
**http://10.246.114.47/horizon**
The final credentials needed to log in are:
@ -770,26 +777,31 @@ networks, images, and a user environment. Go to :doc:`Configure OpenStack
.. _Deploying applications: https://juju.is/docs/olm/deploy-a-charm-from-charmhub
.. _Deploying to specific machines: https://juju.is/docs/olm/deploy-to-a-specific-machine
.. _Managing relations: https://juju.is/docs/olm/manage-relations
.. _vault charm: https://charmhub.io/vault/
.. _vault charm documentation: https://opendev.org/openstack/charm-vault/src/branch/stable/1.8/src/README.md#post-deployment-tasks
.. CHARMS
.. _ceph-mon: https://charmhub.io/ceph-mon
.. _ceph-osd: https://charmhub.io/ceph-osd
.. _ceph-radosgw: https://charmhub.io/ceph-radosgw
.. _cinder: https://charmhub.io/cinder
.. _cinder-ceph: https://charmhub.io/cinder-ceph
.. _glance: https://charmhub.io/glance
.. _keystone: https://charmhub.io/keystone
.. _neutron-gateway: https://charmhub.io/neutron-gateway
.. _neutron-api: https://charmhub.io/neutron-api
.. _neutron-openvswitch: https://charmhub.io/neutron-openvswitch
.. _nova-cloud-controller: https://charmhub.io/nova-cloud-controller
.. _nova-compute: https://charmhub.io/nova-compute
.. _ceph-mon: https://charmhub.io/ceph-mon?channel=quincy/stable
.. _ceph-osd: https://charmhub.io/ceph-osd?channel=quincy/stable
.. _ceph-radosgw: https://charmhub.io/ceph-radosgw?channel=quincy/stable
.. _cinder: https://charmhub.io/cinder?channel=2023.1/stable
.. _cinder-ceph: https://charmhub.io/cinder-ceph?channel=2023.1/stable
.. _glance: https://charmhub.io/glance?channel=2023.1/stable
.. _keystone: https://charmhub.io/keystone?channel=2023.1/stable
.. _mysql-innodb-cluster: https://charmhub.io/mysql-innodb-cluster?channel=8.0/stable
.. _mysql-router: https://charmhub.io/mysql-router?channel=8.0/stable
.. _neutron-gateway: https://charmhub.io/neutron-gateway?channel=2023.1/stable
.. _neutron-api: https://charmhub.io/neutron-api?channel=2023.1/stable
.. _neutron-api-plugin-ovn: https://charmhub.io/neutron-api-plugin-ovn?channel=2023.1/stable
.. _neutron-openvswitch: https://charmhub.io/neutron-openvswitch?channel=2023.1/stable
.. _nova-cloud-controller: https://charmhub.io/nova-cloud-controller?channel=2023.1/stable
.. _nova-compute: https://charmhub.io/nova-compute?channel=2023.1/stable
.. _ntp: https://charmhub.io/ntp
.. _openstack-dashboard: https://charmhub.io/openstack-dashboard
.. _percona-cluster: https://charmhub.io/percona-cluster
.. _placement: https://charmhub.io/placement
.. _rabbitmq-server: https://charmhub.io/rabbitmq-server
.. _openstack-dashboard: https://charmhub.io/openstack-dashboard?channel=2023.1/stable
.. _ovn-central: https://charmhub.io/ovn-central?channel=23.03/stable
.. _ovn-chassis: https://charmhub.io/ovn-chassis?channel=23.03/stable
.. _placement: https://charmhub.io/placement?channel=2023.1/stable
.. _rabbitmq-server: https://charmhub.io/rabbitmq-server?channel=3.9/stable
.. _vault: https://charmhub.io/vault?channel=1.8/stable
.. BUGS
.. _LP #1826888: https://bugs.launchpad.net/charm-deployment-guide/+bug/1826888