openstack/kolla-ansible
Code Issues Proposed changes

Clarify Ansible installation for distros in docs.

Browse Source 
For CentOS, install from distro packaging by default.  Explain
how to install on DEB based systems from packaging when they
update to a newer version of Ansible.  Finally, clean up the
ordering of the dependencies for a pip based install.

TrivialFix

Change-Id: I9564a03c2e75fd30b5ec9c7d64f5defb709d7fde
This commit is contained in:
Naren Narendra 2016-02-11 20:27:48 -05:00
parent 571f4b97f6
commit e4a659e0be
1 changed files with 21 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
doc/quickstart.rst
View File

@ -181,25 +181,18 @@ Kolla deploys OpenStack using
`Ansible <http://www.ansible.com>`__. Install Ansible from distribution
packaging if the distro packaging has recommended version available.
Currently all implemented distro versions of Ansible are too old to use distro
packaging. Once distro packaging is updated install from packaging using:
Some implemented distro versions of Ansible are too old to use distro
packaging. Currently, CentOS and RHEL package Ansible 1.9.4 which is
suitable for use with Kolla.
On CentOS or RHEL systems, this can be done using:
::
yum -y install ansible
On DEB based systems this can be done using:
::
apt-get install ansible
If the distro packaged version of Ansible is too old, install Ansible using
pip:
::
pip install -U ansible
Many DEB based systems do not meet Kolla's Ansible version requirements.
It is recommended to use pip to install Ansible 1.9.4.
Some ansible dependencies, like pycrypto, may need gcc installed on the build
system. Install it using system packaging tools if it's not installed already:
@ -212,6 +205,20 @@ system. Install it using system packaging tools if it's not installed already:
# Ubuntu
sudo apt-get install gcc
Finally Ansible 1.9.4 may be installed using:
::
pip install -U ansible==1.9.4
If DEB based systems include a version of Ansible that meets Kolla's
version requirements it can be installed by:
::
apt-get install ansible
Deploy a registry (required for multinode)
------------------------------------------