openstack
/
charm-deployment-guide
Code Issues Proposed changes

Improve install from bundle page 

Improve the overall text.

Consistency. Use terminology used elsewhere.

Change-Id: I20f57f6814baaf812b8fca09b9f0da03e2d86c0a
This commit is contained in:
Peter Matulis 2021-04-22 22:07:13 -04:00
parent 2dd71d53d3
commit 6ad724bb26
1 changed files with 17 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
deploy-guide/source/install-openstack-bundle.rst
View File

@ -4,10 +4,10 @@
Install OpenStack from a bundle
===============================
A Juju charm *bundle* is an encapsulation of a multitude of charm deployments,
and includes all the associated relations and configurations that are required
(see `Charm bundles`_ in the Juju documentation). It is possible to therefore
install OpenStack from a bundle.
Charmed OpenStack is often deployed via a charm bundle. A bundle encompasses
multiple charms, their configuration options, and various optional elements
such as hardware and network constraints. See `Charm bundles`_ in the Juju
documentation.
.. tip::
@ -18,21 +18,21 @@ install OpenStack from a bundle.
experience with Juju, which will in turn prepare you for post-deployment
management of the cloud.
The bundle featured here provides a minimal OpenStack cloud and assumes that
`MAAS`_ is used as a backing cloud to Juju. Due to unknown factors in the local
environment (usually hardware-related) the bundle will most likely need to be
modified prior to deployment. The bundle and its deployment are described in
great detail in its Charm Store entry here: `openstack-base`_.
To arrive at a truly customised deployment, while taking advantage of an
official base bundle, a secondary (overlay) bundle can be applied to override
and fine-tune certain elements of the original bundle.
Once the bundle configuration has been confirmed OpenStack can be deployed:
The bundle recommended here is the stable release of `openstack-base`_. It is
used throughout Charmed OpenStack documentation as a reference bundle.
.. code-block:: none
The bundle will probably need to be modified to accommodate for factors in the
local environment (e.g. hardware), or as mentioned, overridden with an overlay
bundle.
juju deploy /path/to/bundle/file
Deploy the bundle now. Follow the instructions provided in the stable
`openstack-base README`_.
The time required for the install to complete will depend on the hardware
capabilities of the underlying MAAS nodes. Once finished, you should go on to
`Configure OpenStack`_ if not already done.
Once deployed, go on to `Configure OpenStack`_.
Finally, once cloud functionality has been verified see the `OpenStack
Administrator Guides`_ for long-term guidance.
@ -42,5 +42,6 @@ Administrator Guides`_ for long-term guidance.
.. _Configure OpenStack: configure-openstack.html
.. _Charm bundles: https://jaas.ai/docs/charm-bundles
.. _MAAS: https://maas.io
.. _openstack-base: https://jaas.ai/openstack-base
.. _openstack-base: https://github.com/openstack-charmers/openstack-bundles/tree/master/stable/openstack-base
.. _openstack-base README: https://github.com/openstack-charmers/openstack-bundles/blob/master/stable/openstack-base/README.md
.. _OpenStack Administrator Guides: http://docs.openstack.org/admin