Skip to content

Installing LUNA PASS with Docker#

This section describes how to install and use Docker Compose to deploy LUNA PASS.

Docker and Docker Compose are not included in the LUNA PASS distribution. Configure SSL and NGINX for correct service operation.

Docker allows you to create a container that already has the required service, the software environment for it, and a minimal set of necessary tools. Docker Compose is used to automatically deploy containers.

Installing Docker and Docker Compose#

Use the official instructions for installation Docker Engine and Docker Compose.

Authorization in registry#

To start the services it is necessary to get their samples from dockerhub.visionlabs.ru (VisionLabs registry). Before that authorization is required.

docker login dockerhub.visionlabs.ru --username <username> --password <password>

Enter the login <username> and password <password>. You can get them by contacting VisionLabs specialists.

Preparing and unpacking the distribution#

The distribution package is an archive of the form "luna_pass_X.Y.ZZ", where X.Y.ZZ is a numerical identifier indicating the product version.

The archive contains all components necessary for installation and operation of the service.

The LUNA SDK is included in the LUNA PASS distribution. Additional installation of the LUNA SDK is not required.

Before the installation process, place the distribution files in a directory on the server. For example, in the /root directory. There should be no other distribution files in this directory other than the target files used to install the final product.

Perform the following steps.

1․ Switch to root superuser mode:

sudo su

2․ Create a directory to unzip the distribution:

mkdir -p /var/lib/luna-pass

3․ Move the distribution to the directory you created:

mv /root/luna-pass* /var/lib/luna-pass

4․ Install the unzip archiver if it is not installed:

yum install unzip

5․ Change to the distribution directory:

cd /var/lib/luna-pass

6․ Unzip the files:

unzip luna-pass*.zip

7․ Create a symbolic link. Instead of "X.Y.ZZ", specify the product version. The link indicates that it is the current version of the distribution that is used for launching:

ln -s luna-pass-X.Y.ZZ current

If the /var/lib/luna-pass/current link is missing, the startup scripts will not be able to locate the binary files of the current release, and further installation will not be possible.

Starting LUNA PASS#

Before launching docker, you need to make up-to-date data and settings in license.conf, lunapassvideo.config.toml, lunapassvideo.task.py, lunapassapi. config.toml and docker-compose.yml, having previously generated these files from the examples included in the distribution.

Networking modes in Docker#

The Docker networking subsystem is connected using drivers:

  • host - network driver for standalone containers. Removes network isolation between the container and the Docker host;
  • container:
  • bridge - default network driver. Used when applications run in standalone containers that need to communicate with each other.

Starting LUNA PASS in host mode#

1․ Change to the Docker directory:

cd /var/lib/luna-pass/current/example-docker/host

Make sure that the license.conf file contains the correct license data.

2․ Create configuration files for the services you are using (for example, from the example files lying in each service) for later mounting in docker. To start the service, enter the command:

docker-compose up -d

3․ Check the status of all running Docker containers.

docker-compose ps

Starting LUNA PASS in container mode#

1․ Change to the Docker directory:

cd /var/lib/luna-pass/current/example-docker/container

Make sure that the license.conf file contains the correct license data.

2․ Create configuration files for the services to be used (for example, from the example files in each service) to be mounted in docker. To start the service, enter the command:

docker-compose up -d

3․ Check the status of all running Docker containers.

docker-compose ps