kolla-ansible/doc/deploy-all-in-one-node.rst
Swapnil Kulkarni bd27d4ad63 Spell corrections in AIO doc
Change-Id: I40d2eb9c5b778e633d54489d31cd32de0e82bf2f
2015-09-18 09:45:21 +05:30

85 lines
2.2 KiB
ReStructuredText

Deploy OpenStack all in one node using Ansible
==============================================
Deploy OpenStack to ubuntu host(ubuntu docker image)
----------------------------------------------------
The machine minimal requirements:
- two network interfaces.
The machine recommended requirements:
- two network interfaces.
- more than 8gb main memory.
- at least 40gb disk space.
To verify the Ubuntu kernel is sufficient to operate Kolla, run the command:
::
docker run -i -t --net=host ubuntu su
If the command displays "su: System error",
the system suffers from this DockerBug_. This is a possible way to solve the issue:
::
sudo apt-get install linux-image-generic-lts-vivid
sudo reboot
The guide assumes that you have build images using the following command.
::
tools/build.py -n 172.22.2.81:4000/kollaglue --base ubuntu --type source --push
The IP, "172.22.2.81", is the host running private docker registry.
To deploy a private docker registry,
please read the document DeployingRegistryServer_.
First, add ``--insecure-registry 172.22.2.81:4000``
to ``DOCKER_OPTS`` in ``/etc/default/docker``.
And restart the docker service.
This will permit Docker to pull from the deployment's private registry.
Clone the kolla repository and copy kolla config to ``"/etc"``:
::
git clone https://github.com/openstack/kolla
cd kolla
cp -rf etc/kolla/ /etc/
And modify the file, ``"/etc/kolla/globals.yml"``. Do the below tasks.
- Set ``"kolla_base_distro"`` to ``"ubuntu"``.
- Set ``"kolla_install_type"`` to ``"source"``.
- Set ``"docker_registry"`` to ``"172.22.2.81:4000"``.
- Change kolla_internal_address value.
Specify an unissued IP address in the deployment environment
Change the following values if needed:
- network_interface
- neutron_external_interface
After doing these tasks, run the following command in kolla directory:
::
tools/kolla-ansible -i ansible/inventory/all-in-one -p ansible/site.yml deploy
Deployment takes between 10 and 15 minutes from
a local private registry on gigabit networks.
.. _DeployingRegistryServer: https://docs.docker.com/registry/deploying/
.. _DockerBug: https://github.com/docker/docker/issues/5899