From 99f4f17751a4ccb5a6d7b57475f02eca70392c76 Mon Sep 17 00:00:00 2001 From: Jean-Philippe Evrard Date: Fri, 23 Feb 2018 00:10:35 +0000 Subject: [PATCH] [Docs] Guide users more - 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 --- deploy-guide/source/configure.rst | 8 ++++++++ deploy-guide/source/next-steps.rst | 16 ++++++++-------- deploy-guide/source/verify-operation.rst | 12 +++--------- 3 files changed, 19 insertions(+), 17 deletions(-) diff --git a/deploy-guide/source/configure.rst b/deploy-guide/source/configure.rst index 20a0e9402d..5b5f189ada 100644 --- a/deploy-guide/source/configure.rst +++ b/deploy-guide/source/configure.rst @@ -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 ---------------------------- diff --git a/deploy-guide/source/next-steps.rst b/deploy-guide/source/next-steps.rst index 5961e68188..bc7ef79cba 100644 --- a/deploy-guide/source/next-steps.rst +++ b/deploy-guide/source/next-steps.rst @@ -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 `_. - - Operate OpenStack-Ansible ========================= -Have a look at our `Operations guide `_. +Review our `Operations guide `_ +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 `_ +to learn about contributing to OpenStack-Ansible. \ No newline at end of file diff --git a/deploy-guide/source/verify-operation.rst b/deploy-guide/source/verify-operation.rst index cd89fcf350..ae6216a695 100644 --- a/deploy-guide/source/verify-operation.rst +++ b/deploy-guide/source/verify-operation.rst @@ -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