openstack/charm-deployment-guide
Code Issues Proposed changes

Review installing OpenStack from a bundle

Browse Source 
I don't mind moving the majority of the bundle's
README to this guide instead but I don't want to
duplicate instructions.

The configure aspect of this is also awkward as
the README provides network configuration via
(currently broken) scripts (see https://is.gd/IFCo91).
Should we forgo that and force people to use the
guide's configure page? Will that apply cleanly
to this bundle's resultant cloud? See this bug
for related brokenness: https://pad.lv/1833709.

Closes-Bug: #1833533

Change-Id: Iab0807cd5079a030a4dc367366713ef04227ce42
This commit is contained in:
Peter Matulis 2019-11-12 17:12:02 -05:00
parent c74ce0fbdf
commit 63ae35300d
1 changed files with 32 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,44 +1,44 @@
===============================
Install OpenStack from a bundle Install OpenStack from a bundle
=============================== ===============================
:doc:`Stepping through the deployment <install-openstack>` of each OpenStack A Juju charm *bundle* is an encapsulation of a multitude of charm deployments,
application is the best way to understanding how OpenStack and Juju operate, and and includes all the associated relations and configurations that are required
how each application relates to one another. But it's a labour intensive (see `Charm bundles`_ in the Juju documentation). It is possible to therefore
process. install OpenStack from a bundle.
A bundle allows you to accomplish the same deployment with a single command: .. tip::
.. code:: bash The `Install OpenStack`_ page shows how to install by deploying,
configuring, and relating applications on an individual basis using Juju. It
is the recommended install method for getting a high level view of how
OpenStack is put together. It also provides an opportunity to gain
experience with Juju, which will in turn prepare you for post-deployment
management of the cloud.
juju deploy openstack.bundle 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`_.
A `bundle <https://jujucharms.com/docs/stable/charms-bundles>`__, as used above, Once the bundle configuration has been confirmed OpenStack can be deployed:
encapsulates the entire deployment process, including all applications, their
configuration parameters and any relations that need to be made. Generally, you
can use a local file, as above, or deploy a curated bundle from the `charm
store <https://jujucharms.com/store>`__.
For our project, `download .. code-block:: console
<https://api.jujucharms.com/charmstore/v5/openstack-base/archive>`__ the
`OpenStack <https://jujucharms.com/openstack-base/>`__ and deploy OpenStack
using the above command.
.. note:: juju deploy /path/to/bundle/file
You will probably need to edit the bundle information to match the actual The time required for the install to complete will depend on the hardware
hardware that you have. capabilities of the underlying MAAS nodes. Once finished, you should go on to
`Configure OpenStack`_ if not already done.
The speed of the deployment depends on your hardware, but may take some time. Finally, once cloud functionality has been verified see the `OpenStack
Monitor the output of ``juju status`` to see when everything is ready. Administrator Guides`_ for long-term guidance.
Next steps .. LINKS
---------- .. _Install OpenStack: install-openstack
.. _Configure OpenStack: config-openstack
See the :ref:`Install OpenStack <test_openstack>` .. _Charm bundles: https://jaas.ai/docs/charm-bundles
documentation for details on testing your OpenStack deployment, or jump directly .. _MAAS: https://maas.io
to :doc:`Configure OpenStack <config-openstack>` to start using OpenStack .. _openstack-base: https://jaas.ai/openstack-base
productively as quickly as possible. .. _OpenStack Administrator Guides: http://docs.openstack.org/admin
.. raw:: html
<!-- LINKS -->