Installation and configuration manual
This section describes how to install and configure the nova-docker as a Nova Compute node.
To install a nova-docker compute node, you should have fully functional OpenStack infrastructure:
Supported OpenStack versions are Liberty and Mitaka.
The compute node should be installed and configured according to the Openstack installation manual referred previously, namely the nova compute and neutron services.
Install docker-engine and start the service. The installation and configuration instructions can be in Install Docker Engine.
Check that the docker service is running:
systemctl status docker
Additional or modified configuration for the nova-docker steps are explained in the sections below.
As nova needs to spawn docker containers, the nova user must be in the docker group; hence execute the command:
usermod -aG docker nova
We've noticed some problem during
nova-docker plugin's start. If an error like this occurs
ImportError: No module named docker
please try to install the package
python-docker and retry.
Indigo-DataCloud 1st release components are supported in Centos7 and Ubuntu 14.04.
The next sections detail installation instruction for each Operating System.
Installation on Ubuntu 14.04
The first step is to install the Indigo-DataCloud gpg keys and apt package repositories. Further details can be found here
All packages are signed with the INDIGO - DataCloud gpg key. Import the public key:
wget -q -O - http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc | \ sudo apt-key add -
Install the apt repository:
wget http://repo.indigo-datacloud.eu/repository/indigo/1/ubuntu/dists/trusty/main/binary-amd64/indigodc-release_1.0.0-1_amd64.deb dpkg -i indigodc-release_1.0.0-1_amd64.deb
Install the nova-docker package:
apt-get -y install python-nova-docker
Installation on Centos7
The first steps are the same as for Ubuntu 14.04, that is import the gpg key
rpm --import http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc
Install the indigo1 repository for Centos7
yum -y install http://repo.indigo-datacloud.eu/repository/indigo/1/centos7/x86_64/base/indigodc-release-1.0.0-1.el7.centos.noarch.rpm
Install the nova-docker package:
yum -y install python-nova-docker
Nova compute machine
Nova needs to be configured to use the Docker virt driver. Edit the configuration file /etc/nova/nova.conf according to the following options:
[DEFAULT] compute_driver = novadocker.virt.docker.DockerDriver
Create the directory /etc/nova/rootwrap.d, if it does not already exist, and inside that directory create a file "docker.filters" with the following content:
# nova-rootwrap command filters for setting up network in the docker driver # This file should be owned by (and only-writeable by) the root user [Filters] # nova/virt/docker/driver.py: 'ln', '-sf', '/var/run/netns/.*' ln: CommandFilter, /bin/ln, root
Restart the nova compute service
systemctl restart openstack-nova-compute
On OpenStack Newton, the
openstack-nova-compute service might fail to
start with an error like this:
ImportError: No module named novadocker.virt.docker
In this case it is necessary to manually create a link with the following command:
ln -s -t /usr/lib/python2.7/site-packages/nova/virt /usr/lib/python2.7/site-packages/novadocker
and restart the
In the machine where you are running the glance service, it needs to be configured to support the docker container format.
It's important to leave the default ones in order to not break an existing glance install.
[DEFAULT] container_formats = ami,ari,aki,bare,ovf,docker
Restart the glance services
systemctl restart openstack-glance-api openstack-glance-registry