openstack/openstack-ansible
Code Issues Proposed changes

[Docs] Guide users more

Browse Source 
- It's easy for a new deployer to miss the importance of the
  configuration. This highlights the step.
- It makes more sense to be guided from the deploy-guide to
  the Operations guide first, before the contributing.
- Reduced the commands to run for a first verification of
  the cloud.

Change-Id: I7bc7dce2d4a9f0449a3f70cc2717f5e0a8345dc4
This commit is contained in:
Jean-Philippe Evrard 2018-02-23 00:10:35 +00:00 committed by Jesse Pretorius (odyssey4me)
parent bbd63b661f
commit 99f4f17751
3 changed files with 19 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
deploy-guide/source/configure.rst
View File

@ -78,6 +78,14 @@ OpenStack-Ansible has many options that you can use for the advanced
configuration of services. Each role's documentation provides information
about the available options.
.. important::
This step is essential to tailoring OpenStack-Ansible to your needs
and is generally overlooked by new deployers. Have a look at each
role documentation, user guides, and reference if you want a tailor
made cloud.
Infrastructure service roles
----------------------------

16
deploy-guide/source/next-steps.rst
View File

@ -5,14 +5,14 @@ Next steps
Now that you have verified that your OpenStack cloud
is working, here is what you can do next:
Contribute to OpenStack-Ansible
===============================
If you want to contribute to OpenStack-Ansible, please
have a look at our `Contributors guide <https://docs.openstack.org/openstack-ansible/latest/contributor/index.html>`_.
Operate OpenStack-Ansible
=========================
Have a look at our `Operations guide <https://docs.openstack.org/openstack-ansible/latest/admin/index.html>`_.
Review our `Operations guide <https://docs.openstack.org/openstack-ansible/latest/admin/index.html>`_
to learn about verifying your environment in more detail, and creating your first networks, images, and instances.
Contribute to OpenStack-Ansible
===============================
Review our `Contributors guide <https://docs.openstack.org/openstack-ansible/latest/contributor/index.html>`_
to learn about contributing to OpenStack-Ansible.

12
deploy-guide/source/verify-operation.rst
View File

@ -29,17 +29,11 @@ configuration and testing.
# lxc-attach -n infra1_utility_container-161a4084
#. Source the ``admin`` tenant credentials:
#. List your openstack users:
.. code-block:: console
# source /root/openrc
#. Run an OpenStack command that uses one or more APIs. For example:
.. code-block:: console
# openstack user list
# openstack user list --os-cloud=default
+----------------------------------+--------------------+
| ID | Name |
+----------------------------------+--------------------+
@ -60,7 +54,7 @@ configuration and testing.
+----------------------------------+--------------------+
Verifying the Dashboard (horizon)
---------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. With a web browser, access the Dashboard by using the external load
balancer IP address defined by the ``external_lb_vip_address`` option