From 63ae35300d18979d69c36e7ecd434a86e09d8fe0 Mon Sep 17 00:00:00 2001 From: Peter Matulis Date: Tue, 12 Nov 2019 17:12:02 -0500 Subject: [PATCH] Review installing OpenStack from a bundle 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 --- .../source/install-openstack-bundle.rst | 64 +++++++++---------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/deploy-guide/source/install-openstack-bundle.rst b/deploy-guide/source/install-openstack-bundle.rst index 153e447..7e6dddf 100644 --- a/deploy-guide/source/install-openstack-bundle.rst +++ b/deploy-guide/source/install-openstack-bundle.rst @@ -1,44 +1,44 @@ +=============================== Install OpenStack from a bundle =============================== -:doc:`Stepping through the deployment ` of each OpenStack -application is the best way to understanding how OpenStack and Juju operate, and -how each application relates to one another. But it's a labour intensive -process. +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. -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 `__, as used above, -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 `__. +Once the bundle configuration has been confirmed OpenStack can be deployed: -For our project, `download -`__ the -`OpenStack `__ and deploy OpenStack -using the above command. +.. code-block:: console -.. note:: + juju deploy /path/to/bundle/file - You will probably need to edit the bundle information to match the actual - hardware that you have. +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. -The speed of the deployment depends on your hardware, but may take some time. -Monitor the output of ``juju status`` to see when everything is ready. +Finally, once cloud functionality has been verified see the `OpenStack +Administrator Guides`_ for long-term guidance. -Next steps ----------- - -See the :ref:`Install OpenStack ` -documentation for details on testing your OpenStack deployment, or jump directly -to :doc:`Configure OpenStack ` to start using OpenStack -productively as quickly as possible. - -.. raw:: html - - +.. LINKS +.. _Install OpenStack: install-openstack +.. _Configure OpenStack: config-openstack +.. _Charm bundles: https://jaas.ai/docs/charm-bundles +.. _MAAS: https://maas.io +.. _openstack-base: https://jaas.ai/openstack-base +.. _OpenStack Administrator Guides: http://docs.openstack.org/admin