diff --git a/doc/source/index.rst b/doc/source/index.rst index add120ee5e74d8ffc7c079c95ad017ff29d2438a..a16c18813be3274def618603f92c905ebd6173e4 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -27,6 +27,7 @@ Documentation deployment upgrading administration/index + resources Advanced Documentation ---------------------- diff --git a/doc/source/resources.rst b/doc/source/resources.rst new file mode 100644 index 0000000000000000000000000000000000000000..11fea507a14efedd53b442a8b3983092651e3fa9 --- /dev/null +++ b/doc/source/resources.rst @@ -0,0 +1,27 @@ +========== +Resources +========== + +This section contains links to external Kayobe resources. + +A Universe From Nothing +======================== + +.. note:: The 'A Universe From Nothing' deployment guide is intended for + educational & testing purposes only. It is *not* production ready. + +Originally created as a workshop, A 'Universe From Nothing' is an example +guide for the deployment of Kayobe on virtual hardware. You can find it on +GitHub `here <https://github.com/stackhpc/a-universe-from-nothing/>`_. + +The repository contains a configuration suitable for deploying containerised +OpenStack using Kolla, Ansible and Kayobe. The guide makes use of +`Tenks <https://opendev.org/openstack/tenks>`_ to provision a virtual +baremetal environment running on a single hypervisor. + +To complete the walkthrough you will require a baremetal or VM hypervisor +running CentOS 7 with at least 32GB RAM & 40GB disk space. +Preparing the deployment can take some time - where possible it is +beneficial to snapshot the hypervisor. We advise making a snapshot after +creating the initial 'seed' VM as this will make additional deployments +significantly faster.