aboutsummaryrefslogtreecommitdiffstats
path: root/deployment/noheat/infra-openstack/HACKING.rst
diff options
context:
space:
mode:
Diffstat (limited to 'deployment/noheat/infra-openstack/HACKING.rst')
-rw-r--r--[l---------]deployment/noheat/infra-openstack/HACKING.rst31
1 files changed, 30 insertions, 1 deletions
diff --git a/deployment/noheat/infra-openstack/HACKING.rst b/deployment/noheat/infra-openstack/HACKING.rst
index 3f7568eb2..dcdc2062e 120000..100644
--- a/deployment/noheat/infra-openstack/HACKING.rst
+++ b/deployment/noheat/infra-openstack/HACKING.rst
@@ -1 +1,30 @@
-HACKING \ No newline at end of file
+=========================
+ Development environment
+=========================
+
+This environment focuses on interactions with OpenStack (here: DevStack) instance. Changes can be
+made from host machine but additional guest ("operator") is provided for developers' convenience.
+
+Environment on "operator" machine is already set up and can be accessed by:
+
+.. code-block:: shell
+
+ $ vagrant ssh operator
+
+Provided ``clouds.yaml`` file differs slightly from the one that can be obtained with following
+steps:
+
+#. Open OpenStack dashboard (http://localhost:8080 forwarded from "devstack" machine)
+#. Navigate to ``Project``, then ``API Access`` on the left panel
+#. Select ``Download OpenStack RC File``, then ``OpenStack clouds.yaml File`` on the right side
+
+Summary of changes:
+
+- Added password from ``local.conf`` file (used in DevStack instance setup)
+- Removed ``project_id`` which might change on a new DevStack instance
+- Replaced ``auth_url`` based on machine's dynamic IP with the static private address
+- Added ``project_domain_name`` needed to run Ansible playbooks
+
+Installed Python package ``python-openstackclient`` includes key package ``openstacksdk`` as
+a dependency and provides additional CLI tools. Tool ``pip`` for Python 3 was used for installing
+these packages.