Migration routine

Surroundings

If you use Luna Platform Docker deployment, skip this step (all the required dependencies are already installed in the Configurator service image). Otherwise you need to:

  • replace all the Configurator project files with the files of the current version

  • install python dependencies:

Warning

It is strongly recommended to create virtual surroundings for python dependencies installation.

pip install -r requirements.txt

Service settings migration

You should set up your Configurator configuration file luna_configurator/configs/config.conf.

Database migration

You need to execute migration scripts to update your Configurator database structure.

Warning

It is highly recommended to create a backup of your database before applying any changes.

You need to set up your Configurator configuration file and run migration with the following options:

alembic -x config=luna_configurator/configs/config.conf upgrade head

If you use Luna Platform Docker deployment, use the following options:

docker run \
-v /etc/localtime:/etc/localtime:ro \
--rm \
--network=host \
--entrypoint=/bin/bash \
dockerhub.visionlabs.ru/luna/luna-configurator:<Configurator_tag> \
-c "alembic -x luna-config=/srv/luna_configurator/configs/config.conf upgrade head"

Compatibility

The Configurator service does not depend on any other services and can be launched separately. However, it should belong to the same release as the services so they could receive configurations from it.