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

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

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

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

• на рабочем ПК установлены утилиты kubectl и helm;
• настроена конфигурация kubeconfig — команда kubectl get nodes возвращает список узлов кластера;
• есть доступ к реестру harbor.tronsec.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="harbor.tronsec.ru"
   export VERSION="1.5.0"

   К сведению

   Значения CHART_URL, CHART_USERNAME, CHART_PASSWORD, VERSION запросите у службы поддержки.

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, и войдите в систему.