openstack/kolla-ansible
Code Issues Proposed changes
326b29f363
kolla-ansible/doc/image-building.rst
Steven Dake 233864ff32 Rename docs dir to doc for publishing 
The publishing docs expect the documentation to be present in the
/doc directory not the /docs directory.  If the documentation is in
the /docs directory, according to fungi the docs won't be published
properly.

Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e
Partially-Implements: blueprint kola-tox-doc
2015-09-02 22:37:36 -07:00

1.8 KiB
Raw Blame History

Image building

The tools/build.py script in this repository is responsible for building docker images.

Guide

In general, you will build images like this:

$ tools/build.py

By default, the above command would build all images based on centos image.

If you want to change the base distro image, add -b:

$ tools/build.py -b ubuntu

There are following distros available for building images:

  • fedora
  • centos
  • oraclelinux
  • ubuntu

To push the image after building, add --push:

$ tools/build.py --push

If you want to build only keystone image, use the following command:

$ tools/build.py keystone

If you want to build multiple images e.g. keystone and nova, use the following command:

$ tools/build.py keystone nova

tools/build.py use kollaglue as default namespace. If you want to push images to your dockerhub, change the namespace like:

$ tools/build.py -n yourusername --push

Build Openstack from Source

When building images, there are two methods of the Openstack install. One is binary. Another is source. The binary means that Openstack will be installed from apt/yum. And the source means that Openstack will be installed from source code. The default method of the Openstack install is binary. You can change it to source using the following command:

tools/build.py -t source

The locations of Opentack source code are written in build.ini. Now the source type support url and git. The build.ini looks like:

[glance-base]
type = url
location = http://tarballs.openstack.org/glance/glance-master.tar.gz

[keystone]
type = git
location = https://github.com/openstack/keystone
reference = stable/kilo