Modify docs to more strongly suggest deploying repo-infra_hosts

This change implements documentation changes discussed during the
weekly meeting on January 14, 2016 on freenode in #openstack-meeting-4

Currently, documentation suggests configuring the user variable
openstack_repo_url: "https://rpc-repo.rackspace.com/"

The repos maintained on https://rpc-repo.rackspace.com/ do not
currently support individual point releases (such as 12.0.3 at the
time of this writing).  Releases are supported by name in that repo,
such as 'liberty', 'master', or 'kilo'.

This change advocates more strongly for the use of deploying
repo-infra_hosts, and in the alternative, asks the user to specify
the user variable openstack_release to avoid problems with point
releases in the repository until a time they are implemented upstream.

Change-Id: I36f8893fcd7cb8d6ddbce06b7974e3b16be91b5f
This commit is contained in:
Michael Gugino 2016-01-15 11:33:02 -05:00
parent 22218a8455
commit d3c02bbbe6

View File

@ -132,17 +132,22 @@ suitable short hostname for a compute host might be:
container management bridge on each repository target host. container management bridge on each repository target host.
The repository typically resides on one or more infrastructure hosts. The repository typically resides on one or more infrastructure hosts.
Alternatively, specify a value for the ``openstack_repo_url`` variable Alternatively, specify a value for the variables ``openstack_repo_url``
in the ``/etc/openstack_deploy/user_group_vars.yml`` file. The value should and ``openstack_release`` in the
contain a URL for a host with the appropriate repository layout. For ``/etc/openstack_deploy/user_group_vars.yml`` file. The values should
contain a URL for a host with the appropriate repository layout and
the desired OpenStack release, respectively. For
example: example:
.. code-block:: yaml .. code-block:: yaml
openstack_repo_url: "https://rpc-repo.rackspace.com/" openstack_repo_url: "https://rpc-repo.rackspace.com/"
openstack_release: master
Using ``repo-infra_hosts`` configures a local repository with the Using ``repo-infra_hosts`` configures a local repository with the
appropriate layout and sets ``openstack_repo_url`` for you. appropriate layout and sets ``openstack_repo_url`` and
``openstack_release`` for you. Using ``repo-infra_hosts`` is the
preferred method of configuring the repository.
#. Configure a list containing at least one optional storage host in the #. Configure a list containing at least one optional storage host in the
``storage_hosts`` section: ``storage_hosts`` section: