add build inventory and deploy to docs
Skip-Release-Notes
Closes-Bug: CLOUDOPS-947
Change-Id: Id342799dc378cba8e52b27f095f4c32df4d0144a
diff --git a/doc/source/deploy/deployment.rst b/doc/source/deploy/deployment.rst
new file mode 100644
index 0000000..08ebea4
--- /dev/null
+++ b/doc/source/deploy/deployment.rst
@@ -0,0 +1,22 @@
+======================
+Environment Deployment
+======================
+
+After you create the inventory, and update the configuration files for OpenStack services,
+Kubernetes, Ceph and certificates, you can deploy the Atmosphere platform using the following
+commands:
+
+.. code-block:: bash
+
+ python3 -m venv atmosphere-venv && source atmosphere-venv/bin/activate
+
+ pip install -r atmosphere/requirements.txt
+ cd cloud-config
+ ansible-galaxy install -r requirements.yml
+ ansible-playbook -i inventory/hosts.ini -u ubuntu -b playbooks/site.yml
+
+It's suggested to run the deployment process from a dedicated machine that
+has ssh access to all the hosts in the inventory file.
+
+You can edit the site.yml to include only the roles that you need to deploy
+if you want to deploy only a subset of the platform at a time.
diff --git a/doc/source/deploy/index.rst b/doc/source/deploy/index.rst
index c736b3e..2aeeb92 100644
--- a/doc/source/deploy/index.rst
+++ b/doc/source/deploy/index.rst
@@ -19,3 +19,4 @@
cinder
glance
neutron
+ deployment
diff --git a/doc/source/deploy/inventory.rst b/doc/source/deploy/inventory.rst
index 58b3863..aed2124 100644
--- a/doc/source/deploy/inventory.rst
+++ b/doc/source/deploy/inventory.rst
@@ -32,6 +32,43 @@
│ └── site.yml
└── requirements.yml
+The ``requirements.yml`` file is used to specify the atmosphere ansible collection
+version that will be used to deploy the platform. Please refer to the `Release Notes`
+for the version information. The file contents should look like this:
+
+.. code-block:: yaml
+
+ collections:
+ - name: vexxhost.atmosphere
+ version: 4.3.1
+
+To generate the inventory configuration files, you can use the ``generate_workspace``
+playbook to simplify the process. The following command will generate the
+inventory in the specified directory:
+
+.. code-block:: bash
+
+ ansible-playbook -e domain_name="yourdomain.com" \
+ -e workspace_path="$(pwd)/cloud-config/inventory" \
+ vexxhost.atmosphere.generate_workspace
+
+The ``cloud-config`` directory can be managed by any SCM tool of your choice, such as Git,
+and can be used to store all the configuration files and secrets required to deploy the
+platform. You also need to assign the domain name of your cluster to the domain_name
+variable for production deployments.
+
+Refer to the other sections of the `Deployment Guide` to update the configuration files
+according to your network and hardware specification in the inventory directory.
+
+The file contents should look like this:
+
+.. code-block:: yaml
+
+ collections:
+ - name: vexxhost.atmosphere
+ version: 4.3.1
+
+
*************
``hosts.ini``
*************