Using LAVA dispatcher with Docker Compose

This repository attempts to provide a reference implementation of deploying LAVA worker using it's officially distributed docker container.

Requirements

Install the following.

• Docker
• docker-compose

Configuration

All configuration is stored in .env file. Some of the steps are required whilst others are optional.

• Change LAVA_SERVER_HOSTNAME to <server_name> which points to the running LAVA master instance.
• (optional) set encryption to --encrypt if the master instance is using encryption for master-slave communication.
• (optional) Create certificates on the slave. sudo /usr/share/lava-dispatcher/create_certificate.py foo_slave_1 This can be done in two ways:
  • by running "docker-compose run dispatcher bash".
  • alternatively you can create the certificates on system which has LAVA packages already installed.
• (optional) Copy public certificate from master and the private slave certificate created in previous step to directory dispatcher/certs/ of this project. Currently the key names should be the default ones (master.key and slave.key_secret).
• Execute make run; at this point multiple containers should be up and running and the worker should connect to the LAVA server instance of you choosing.
• Add a new device and set its' device template (alternatively you can update existing device to use this new worker) Example QEMU device template:

  {% extends 'qemu.jinja2' %}
  {% set mac_addr = 'DF:AD:BE:EF:33:02' %}
  {% set memory = 1024 %}
  

• (optional) If the lab where this container runs is behind a proxy or you require any specific worker environment settings, you will need to update the proxy settings by setting the worker environment You can do this via this XMLRPC API call. In case the worker sits behind a proxy, you will also need to set SOCKS_PROXY=--socks-proxy <address>:port in the .env configuration file

Note: If the master instance is behind a firewall, you will need to create a port forwarding so that ports 5555 and 5556 are open to the public.

Usage

make: Services are built and then tagged. Following images are added to the system:

• debian
• httpd
• lavasoftware/lava-dispatcher
• lava-docker-compose-dispatcher_ser2net
• lava-docker-compose-dispatcher_worker-tftpd
• lava-docker-compose-dispatcher_worker-webserver
• lava-docker-compose-dispatcher_dispatcher

make run: Run the following containers

• ser2net
• lava dispatcher
• lava dispatcher http server
• lava dispatcher tftp server

make clean: Permanently delete the containers and volumes.