Перед установкой ELMA Cortex задайте значения в файле переменных окружения:
- Перейдите к загруженным установочным файлам ELMA Cortex.
- Откройте папку, соответствующую вашему способу установки — docker-compose или docker-swarm.
- Выберите файл .env.
- Задайте:
- название проекта — указывается, если вы используете несколько копий ELMA Cortex;
- адрес сервера — имя хоста и порт;
- настройки TLS — режим управления сертификатами и параметры их использования;
- способ авторизации администратора в ELMA Cortex — с помощью ELMA365 или ELMA Bot;
- использование встроенных или внешних сервисов;
- настройки производительности.
Параметры, которые вы задаёте, используются при установке ELMA Cortex. Если вы изменяете их значения позже, примените их с помощью скрипта.
Название проекта
Если вам нужно запускать несколько изолированных копий ELMA Cortex на одном хосте, для них нужно задать уникальные названия проектов. Они применяются:
- при использовании Docker Compose — в качестве значения для параметра COMPOSE_PROJECT_NAME и префикса для контейнеров;
- при использовании Docker Swarm — в качестве префикса для имён сервисов.
По умолчанию установлено значение elma-cortex. Пользовательское название проекта можно задать двумя способами:
- В файле переменных окружения .env.
Способ удобен, если для каждой копии ELMA Cortex создана отдельная папка с установочными файлами, и скрипты вызываются из неё. При его использовании:
- для указания названия измените значение переменной PROJECT_NAME;
- после этого скрипты установки, диагностики и удаления нужно запускать без указания названия проекта. Оно подставится из файла .env.
- При запуске скрипта.
Способ позволяет вручную указывать нужный проект при каждом вызове скриптов установки, диагностики и удаления. При его использовании:
- для указания названия при первом запуске скрипта установки используйте параметр --project-name. Подробнее читайте в статьях об установке ELMA Cortex;
- при каждом последующем вызове скриптов для обновления, диагностики или удаления ELMA Cortex нужно указывать название проекта в параметре --project-name.
Адрес сервера ELMA Cortex
Заполните переменные:
- ELMA_CORTEX_HOSTNAME — имя хоста вашего сервера;
- ELMA_CORTEX_PORT — HTTPS-порт. По умолчанию используется порт 443.
Настройки TLS
В зависимости от используемого удостоверяющего центра установите режим управления TLS-сертификатами и задайте параметры их использования.
Подробнее читайте в статье о настройке TLS-сертификатов для ELMA Cortex.
Авторизация
По умолчанию при открытии ELMA Cortex пользователь автоматически входит как администратор. Для повышения безопасности настройте вход с помощью ELMA365 или ELMA Bot.
Подробнее читайте в статье о настройке авторизации в ELMA Cortex.
Использование внешних сервисов
Вместе с ELMA Cortex поставляются сервисы, используемые для его работы, такие как MongoDB, Redis, RabbitMQ и т. д.
Вы можете отключить установку встроенных сервисов, если они уже настроены в вашей инфраструктуре. Для этого в файле .env установите для переменной с названием сервиса значение false:
CADDY_ENABLED=false
REDIS_ENABLED=false
MONGO_ENABLED=false
RABBIT_ENABLED=false
MINIO_ENABLED=false
QDRANT_ENABLED=false
PHOENIX_ENABLED=false
После этого настройте подключение ELMA Cortex к внешним сервисам. Для этого раскомментируйте переменные, относящиеся к ним. Значения, необходимые для подключения, зависят от сервиса.
Настройки производительности
При масштабировании ELMA Cortex для повышения пропускной способности настройте в файле .env параметры:
- количество worker HTTP-сервера. Обычно равно числу ядер процессора. По умолчанию 4:
UVICORN_WORKERS=8
- количество worker для выполнения фоновых задач. По умолчанию 4:
CELERY_WORKER_CONCURRENCY=8
- включение автоматического масштабирования пулов worker — расширенная настройка, которая позволяет определять параметр CELERY_WORKER_CONCURRENCY отдельно для определённых пулов worker:
CELERY_START_WORKER_MAIN=--autoscale=2,4 -Q celery.gamma.tasks.ingestion,celery.gamma.tasks.search.run,celery.gamma.tasks.agent.run
CELERY_START_WORKER_FAST=--autoscale=4,8 -Q celery.gamma.tasks.search.run,celery.gamma.tasks.agent.run
Применение значений для переменных окружения
Заданные настройки автоматически применятся при установке ELMA Cortex.
Если вы обновляете параметры в файле .env после установки, для их применения используйте команду:
./install.sh