From 5f6fec4323a6af9ed114b03628fb0ccafb4b6c7c Mon Sep 17 00:00:00 2001 From: Peter Matulis Date: Mon, 29 Aug 2022 17:54:14 -0400 Subject: [PATCH] Add info re software version selection Make it clearer how software versions are selected for charms and for cloud services. Closes-Bug: #1974481 Change-Id: Idcb64aa12ff7e9069d8b0cf20a008ca55ff7ac78 --- deploy-guide/source/install-openstack.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/deploy-guide/source/install-openstack.rst b/deploy-guide/source/install-openstack.rst index c277f13..8bb935c 100644 --- a/deploy-guide/source/install-openstack.rst +++ b/deploy-guide/source/install-openstack.rst @@ -20,6 +20,29 @@ to review these pertinent sections of the Juju documentation before continuing: This page will show how to install a minimal non-HA OpenStack cloud. See `Infrastructure high availability`_ for guidance on that subject. +Specification of software versions +---------------------------------- + +The cloud deployment involves two levels of software: + +* charms (e.g. keystone charm) +* charm payload (e.g. Keystone service) + +A charm's software version (its revision) is expressed via its channel (e.g. +'yoga/stable') whereas its payload is specified via its ``openstack-origin`` +configuration option (e.g. 'distro' or 'cloud:focal-yoga'). See the Charm Guide +for more information: + +* :doc:`cg:project/charm-delivery` for charms (channels) +* :doc:`cg:admin/upgrades/openstack` for charm payload (OpenStack software + sources) + +.. note:: + + For a successful deployment, both the charm channel and the charm payload + must be compatible. Note also that the Ubuntu version is incorporated in the + charm payload value. + OpenStack release -----------------