Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Documentation

Skip to end of metadata
Go to start of metadata

Introduction to Docker Plugin

Abiquo uses the Abiquo Docker plugin to work with Docker containers. The Abiquo Docker plugin configuration requires the Abiquo Docker agent, which is called Pilot. The Abiquo Docker configuration currently runs on Ubuntu. Abiquo will supply an install script.

Docker Containers are not Virtual Machines

Docker containers are applications not virtual machines. In the first version of the Docker plugin, Abiquo has integrated some Docker functionality and added some Abiquo networking functionality to Docker. The integration of Docker means that Abiquo features such as multitenancy, accounting, billing and reporting can be used with Docker. However, not all Abiquo functionality can be used with Docker.

To give an extended example, Abiquo virtual machines have remote access through VNC. But VNC is not available for Docker because Docker containers are not virtual machines. Docker has its own "attach" command with its own protocol for making information from the container available to users. Abiquo does not currently support the Docker attach command.

Limitations

Docker Repository and Persistent Template

Docker only works with the Docker registry and not the Abiquo NFS repository.

There is no support for persistent templates in the Abiquo Docker integration.

Remote Access

Abiquo does not provide an interface to Docker attach.

Install Docker Plugin

There are two ways to install the Abiquo Docker plugin: Download the agent package for Ubuntu OR Install a vanilla Ubuntu machine and run the cURL command to install Docker and the Abiquo Pilot agent.

OR

  • Install a vanilla Ubuntu machine
  • Run the following command as root:

    \curl http://mirror.abiquo.com/abiquo/3.4/ubuntu/abiquo-docker-node_3.4.1-2_all.deb|bash

    This command will install Docker and the Abiquo pilot agent.

Configure Local Registry

You must configure a docker local registry in order to use Docker with Abiquo.

You can run a local registry on the node you recently installed with the command:

docker run registry

To use this registry with the node, you may need to edit /etc/default/docker config file and add the following option:

DOCKER_OPTS="--insecure-registry=[YOUR_DOCKER_REGISTRY_IP]:5000" 

Set Abiquo Configuration Properties for Docker

Docker registry

Set the registry that Docker will use with the abiquo.docker.registry property in the abiquo.properties file on your Abiquo Server and Remote Services server.

An example value for this property is "http://localhost:5000".

Docker registry tags

You can set regular expressions to filter the tags of images in the Docker registry. Comma separated list of tag patterns allowed. Existing tags in the Docker registry will be matched against these patterns and Abiquo will only show the ones that match. The format of the pattern is defined by the Java pattern: http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Example: ^fixedtag$,^tagswithprefix

Use Docker

See Docker Integration