Запуск Vixtract с Visiology Platform

Тип статьи

Инструкция

Компетенции

Админ

Необходимые права

Как минимум SSH c root и учетная запись администратора в платформе.

Версия платформы

Проверено на 2.27, но работать вероятно будет и на других версиях

Статус

Бета

Сложность

средне

Полезные ссылки

Дополнительные сведения

Ubuntu Server 22.04

Введение.


В данной статье рассматривается запуск Vixtract вместе с платформой Visiology. От Vixtract берутся 3 компонента: Jupyter, Cronicle и PostgreSQL.

Использовать можно только в целях тестирования. На продакшне ETL и платформу нужно разносить по разным серверам.

Шаги установки и настройки.


  1. Скачиваем файл external-first.yml, переименовываем в external.yml и кладем в папку с дистрибутивом платформы, заменяя старый. Если в старом external.yml есть свои кастомные сервисы, то просто добавьте записи в него вручную.

  2. Перезапустите платформу через run.sh --restart. Из Docker Hub должны скачаться Docker образы PostgreSQL, Jupyter и Cronicle и запуститься вместе с компонентами платформы.

  3. Проверьте наличие сервисов visiology_vixtract-jupyter, visiology_vixtract-postgres через команду docker service ls.

  4. Проверьте создание именованных Docker томов с префиксом vixtract через команду docker volume ls.

  5. Скачиваем файл external-final.yml, переименовываем в external.yml и кладем в папку с дистрибутивом платформы, заменяя старый.

  6. Перезапустите платформу через run.sh --restart. Из Docker Hub должен докачаться Docker образ Cronicle.

  7. Проверьте наличие Docker сервисов visiology_vixtract-jupyter, visiology_vixtract-postgres, visiology_vixtract-cronicle через команду docker service ls и их состояние 1/1.

  8. Откройте файл /docker-volume/proxy/nginx.conf и добавьте 6 директив. Полное их содержимое можно взять с приложенного примера nginx-example…conf строчки 251-315.
    Список директив:

    location /jupyter {...} rewrite ^(/cronicle)$ $1/ permanent; location ~* ^/cronicle/ {...} location ~* \.io {...} location ~* ^/api/user/ {...} location ~* ^/api/app/ {...}
  9. Перезапустите компонент proxy:

    docker service scale visiology_proxy=0 && docker service scale visiology_proxy=1

10. Интерфейс JupyterHub должен быть доступен по URL {адрес_платформы}/jupyter.

11. Интерфейс Cronicle должен быть доступен по URL {адрес_платформы}/cronicle.