Перейти к основному содержимому
Версия: 1.7

Установка с помощью Helm Chart

Установка с помощью Helm Chart подходит для развертывания TRON.ASOC в кластере Kubernetes. Для установки на одном сервере см. раздел Установка с помощью Docker Compose.

Перед началом работы​

Перед установкой TRON.ASOC с помощью Helm Chart убедитесь, что:

  • на рабочем компьютере установлены утилиты kubectl и helm;
  • настроена конфигурация kubeconfig — команда kubectl get nodes возвращает список узлов кластера;
  • есть доступ к реестру pcr.tronasoc.ru;
  • Kubernetes-кластер соответствует следующим требованиям:
    • установлены и настроены ingress-nginx-controller и IngressClass;
    • StorageClass настроен и помечен как default — проверьте командой kubectl get storageclass;
    • у администратора есть права на создание ресурсов в целевом пространстве имен (namespace);
    • выделенные PV или внешние базы данных (PostgreSQL, ClickHouse, S3-совместимое хранилище) развернуты и доступны из кластера.

Порядок действий​

Чтобы установить TRON.ASOC с помощью Helm Chart, выполните следующие шаги:

  1. Задайте переменные окружения:

    export CHART_USERNAME="<логин>"
    export CHART_PASSWORD="<пароль>"
    export CHART_URL="pcr.tronasoc.ru"
    export VERSION="1.7"
    К сведению

    Значения CHART_URL, CHART_USERNAME, CHART_PASSWORD и VERSION запросите в службе поддержки: support@tronasoc.ru.

  2. Авторизуйтесь в реестре Helm-чартов:

    helm registry login \
    --username $CHART_USERNAME \
    --password $CHART_PASSWORD \
    $CHART_URL

  3. Скачайте чарт:

    helm pull oci://$CHART_URL/asoc/charts/asoc --version $VERSION

  4. Распакуйте чарт и перейдите в директорию asoc:

    tar xvf asoc-$VERSION.tgz
    cd asoc

  5. Отредактируйте файл values.yaml в соответствии с вашей инфраструктурой. Основные параметры описаны в таблице ниже.

    ПараметрОписание
    default.domainДоменное имя для веб-интерфейса
    secret.infracreds.envs.POSTGRES_*Учетные данные PostgreSQL
    secret.infracreds.envs.MINIO_*Учетные данные MinIO/S3
    secret.infracreds.envs.CLICKHOUSE_*Учетные данные ClickHouse
    pullSecret.asoc-pullsecret.*Учетные данные для доступа к реестру образов

  6. Сгенерируйте ключ шифрования для базы данных:

    openssl rand -hex 32

    Укажите сгенерированный ключ в параметре secret.infracreds.envs.NEW_ENCRYPTION_SECRET_KEY файла values.yaml.

  7. Установите TRON.ASOC:

    helm upgrade --install asoc \
    --create-namespace \
    --namespace asoc \
    --values values.yaml \
    .
Подсказка

Значения параметров можно передать через командную строку, не редактируя файл values.yaml:

helm upgrade --install asoc . \
--create-namespace \
--namespace asoc \
--values values.yaml \
--set default.domain="<домен>" \
--set secret.infracreds.envs.POSTGRES_USER="<username>" \
--set-string secret.infracreds.envs.POSTGRES_PASSWORD="<password>" \
--set secret.infracreds.envs.MINIO_ROOT_USER="<username>" \
--set-string secret.infracreds.envs.MINIO_ROOT_PASSWORD="<password>" \
--set secret.infracreds.envs.CLICKHOUSE_ADMIN_USER="<username>" \
--set-string secret.infracreds.envs.CLICKHOUSE_ADMIN_PASSWORD="<password>" \
--set-string secret.infracreds.envs.NEW_ENCRYPTION_SECRET_KEY="<ключ шифрования>" \
--set pullSecret.asoc-pullsecret.username="<username>" \
--set-string pullSecret.asoc-pullsecret.password="<password>"

Проверка работоспособности​

Чтобы проверить работоспособность TRON.ASOC, выполните следующие шаги:

  1. Убедитесь, что поды запущены:

    kubectl get pods -n asoc

    Результат шага: поды имеют статус Running, а значение READY соответствует ожидаемому (например, 1/1).

  2. Проверьте статус Ingress:

    kubectl get ingress -n asoc

  3. Откройте в браузере адрес, указанный в default.domain, и войдите в систему.