Installation and configuration manual
This section describes how to install and configure the nova-docker as a Nova Compute node.
Pre-requisites
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:
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:
We've noticed some problem during nova-docker
plugin's start. If an error like this occurs
please try to install the package python-docker
and retry.
Installation
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:
Install the apt repository:
Install the nova-docker package:
Installation on Centos7
The first steps are the same as for Ubuntu 14.04, that is import the gpg key
Install the indigo1 repository for Centos7
Install the nova-docker package:
Configuration
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:
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:
Restart the nova compute service
On OpenStack Newton, the openstack-nova-compute
service might fail to start with an error like this:
In this case it is necessary to manually create a link with the following command:
and restart the openstack-nova-compute
service.
Glance service
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.
Restart the glance services
Last updated