openstack/kolla-ansible
Code Issues Proposed changes

Merge "Few improvements in the quickstart doc"

Browse Source
This commit is contained in:
Jenkins 2015-11-08 09:37:43 +00:00 committed by Gerrit Code Review
commit b8a90b4b23
1 changed files with 47 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
doc/quickstart.rst
View File

@ -67,13 +67,28 @@ Docker Python 1.2.0 none On target nodes
Python Jinja2 2.6.0 none On deployment host Python Jinja2 2.6.0 none On deployment host
===================== =========== =========== ========================= ===================== =========== =========== =========================
To install Python dependencies use: Make sure "pip" package manager is installed before procceed:
::
# Centos 7
easy_install pip
# Ubuntu 14.04 LTS
sudo apt-get install python-pip
To install Kolla tools and Python dependencies use:
:: ::
git clone https://git.openstack.org/openstack/kolla git clone https://git.openstack.org/openstack/kolla
cd kolla pip install kolla/
sudo pip install -r requirements.txt
Copy Kolla configuration to /etc:
::
cp -r kolla/etc/kolla /etc/
Since Docker is required to build images as well as be present on all deployed Since Docker is required to build images as well as be present on all deployed
targets, the Kolla community recommends installing the Docker Inc. packaged targets, the Kolla community recommends installing the Docker Inc. packaged
@ -114,11 +129,10 @@ following requirements are needed to build the client code:
:: ::
# Ubuntu # Ubuntu
sudo apt-get install -y python-dev python-pip libffi-dev libssl-dev sudo apt-get install -y python-dev libffi-dev libssl-dev gcc
# Centos 7 # Centos 7
easy_install pip yum install -y python-devel libffi-devel openssl-devel gcc
yum install -y python-devel libffi-devel openssl-devel
To install these clients use: To install these clients use:
@ -142,8 +156,8 @@ To install, start, and enable ntp on CentOS execute the following:
# Centos 7 # Centos 7
yum -y install ntp yum -y install ntp
systemctl enable ntpd systemctl enable ntpd.service
systemctl start ntpd systemctl start ntpd.service
To install and start on Debian based systems execute the following: To install and start on Debian based systems execute the following:
@ -157,8 +171,13 @@ be running at a time.
:: ::
service libvirtd disable # Centos 7
service libvirtd stop systemctl stop libvirtd.service
systemctl disable libvirtd.service
# Ubuntu
service libvirt-bin stop
update-rc.d libvirt-bin disable
Kolla deploys OpenStack using Kolla deploys OpenStack using
`Ansible <http://www.ansible.com>`__. Install Ansible from distribution `Ansible <http://www.ansible.com>`__. Install Ansible from distribution
@ -184,6 +203,17 @@ pip:
pip install -U ansible pip install -U ansible
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:
::
# Centos 7
yum -y install gcc
# Ubuntu
sudo apt-get install gcc
Building Container Images Building Container Images
-------------------------- --------------------------
@ -200,7 +230,7 @@ or the build process will fail. To build images using default parameters run:
:: ::
tools/build.py kolla-build
By default docker will build all containers using Centos as the base image and By default docker will build all containers using Centos as the base image and
binary installation as base installation method. To change this behavior, binary installation as base installation method. To change this behavior,
@ -223,13 +253,13 @@ rebuilt as follows:
:: ::
tools/build.py glance kolla-build glance
In order to see all available parameters, run: In order to see all available parameters, run:
:: ::
tools/build.py -h kolla-build -h
Deploying Kolla Deploying Kolla
--------------- ---------------
@ -245,8 +275,7 @@ Each method is represented as an Ansible inventory file. More information on
the Ansible inventory file can be found in the Ansible `inventory introduction the Ansible inventory file can be found in the Ansible `inventory introduction
<https://docs.ansible.com/intro_inventory.html>`__. <https://docs.ansible.com/intro_inventory.html>`__.
Copy the etc/kolla directory from the git to /etc/kolla on the deployment All variables for the environment can be specified in the files:
host. All variables for the environment can be specified in the files:
"/etc/kolla/globals.yml" and "/etc/kolla/passwords.yml" "/etc/kolla/globals.yml" and "/etc/kolla/passwords.yml"
Start by editing /etc/kolla/globals.yml. Check and edit, if needed, these Start by editing /etc/kolla/globals.yml. Check and edit, if needed, these
@ -310,13 +339,13 @@ wrapped in the kolla-script in the future.
:: ::
tools/kolla-ansible deploy kolla-ansible deploy
In order to see all available parameters, run: In order to see all available parameters, run:
:: ::
tools/kolla-ansible -h kolla-ansible -h
A bare metal system with Ceph takes 18 minutes to deploy. A virtual machine A bare metal system with Ceph takes 18 minutes to deploy. A virtual machine
deployment takes 25 minutes. These are estimates; different hardware may be deployment takes 25 minutes. These are estimates; different hardware may be
@ -335,7 +364,7 @@ glance image and neutron networks:
:: ::
tools/init-runonce kolla/tools/init-runonce
Debugging Kolla Debugging Kolla
--------------- ---------------