Установка чарта

Вариант 1: Установка из удалённого репозитория

Это самый простой способ установки, не требующий скачивания чарта локально.

helm upgrade --install $RELEASE_NAME oci://registry.hexway.io/charts/vampy \
  --version $RELEASE_VERSION \
  -n $RELEASE_NAMESPACE \
  --create-namespace

Вариант 2: Установка с кастомными значениями из файла

Этот вариант позволяет установить чарт с кастомными настройками без необходимости скачивания чарта локально.

Шаг 1. Создайте файл с вашими настройками, например my-values.yaml:

# Настройка доступа по умолчанию
user:
  registration: off  # Отключить регистрацию новых пользователей
  default:
    rootLogin: root@ro.ot
    rootPassword: "SecurePassword123"

# Настройка Ingress для доступа
vDeck:
  ingress:
    enabled: true
    domainName: "vampy.company.com"
    ingressClassName: nginx

Шаг 2. Установите чарт с вашими настройками из удалённого репозитория:

helm upgrade --install $RELEASE_NAME oci://registry.hexway.io/charts/vampy \
  --version $RELEASE_VERSION \
  -n $RELEASE_NAMESPACE \
  --create-namespace \
  -f my-values.yaml

Вариант 3: Установка с внешними PostgreSQL и Redis

Если у вас есть существующие экземпляры PostgreSQL и/или Redis, вы можете использовать их вместо встроенных.

⚠️ Важно: Для production окружений рекомендуется использовать Kubernetes Secrets для хранения учетных данных базы данных вместо plain текста в файле конфигурации.

Шаг 1. Создайте Kubernetes Secret с учетными данными БД:

kubectl create secret generic ${RELEASE_NAME}-vampy-config \
  --namespace=$RELEASE_NAMESPACE \
  --from-literal=EXT_PG_USERNAME='your_db_user' \
  --from-literal=EXT_PG_PASSWORD='your_db_password' \
  --from-literal=EXT_REDIS_USERNAME='your_redis_user' \
  --from-literal=EXT_REDIS_PASSWORD='your_redis_password'

Шаг 2. Создайте файл external-db-values.yaml с использованием секретов:

# Настройки внешней БД PostgreSQL
database:
  host: "postgres.company.com"
  port: "5432"
  name: "vampy"
  secretsKeyRefs:
    username:
      name: "vampy-vampy-config"  # Замените 'vampy' на значение $RELEASE_NAME
      key: "EXT_PG_USERNAME"
    password:
      name: "vampy-vampy-config"  # Замените 'vampy' на значение $RELEASE_NAME
      key: "EXT_PG_PASSWORD"

# Отключаем встроенный PostgreSQL
vPostgres:
  enabled: false

# Настройки внешнего Redis
redis:
  host: "redis.company.com"
  port: "6379"
  secretsKeyRefs:
    username:
      name: "vampy-vampy-config"  # Замените 'vampy' на значение $RELEASE_NAME
      key: "EXT_REDIS_USERNAME"
    password:
      name: "vampy-vampy-config"  # Замените 'vampy' на значение $RELEASE_NAME
      key: "EXT_REDIS_PASSWORD"

# Отключаем встроенный Redis
vRedis:
  enabled: false

Альтернативный способ (для тестирования, не рекомендуется для production):

Если вы используете plain текстовые пароли для тестирования:

# Настройки внешней БД PostgreSQL
database:
  host: "postgres.company.com"
  port: "5432"
  name: "vampy"
  username: "vampy_user"
  password: "PostgresPassword123"

# Отключаем встроенный PostgreSQL
vPostgres:
  enabled: false

# Настройки внешнего Redis
redis:
  host: "redis.company.com"
  port: "6379"
  username: "vampy"
  password: ""

# Отключаем встроенный Redis
vRedis:
  enabled: false

Шаг 3. Установите чарт:

helm upgrade --install $RELEASE_NAME oci://registry.hexway.io/charts/vampy \
  --version $RELEASE_VERSION \
  -n $RELEASE_NAMESPACE \
  --create-namespace \
  -f external-db-values.yaml

Вариант 4: Просмотр чарта и установка с локального чарта

Если вам нужно посмотреть структуру чарта, примеры конфигурации или установить из локальной копии, выполните следующие шаги:

Шаг 1. Скачайте и распакуйте чарт:

helm pull oci://registry.hexway.io/charts/vampy --version $RELEASE_VERSION --untar
cd vampy

Шаг 2. Просмотрите доступные параметры:

values.yaml - содержит все параметры конфигурации с значениями по умолчанию
values.override.production-example.yaml - пример production конфигурации

Шаг 3. Создайте файл с вашими настройками (например, my-custom-values.yaml) на основе примеров из чарта.

Шаг 4. Установите чарт с вашими настройками:

helm upgrade --install $RELEASE_NAME . \
  -n $RELEASE_NAMESPACE \
  --create-namespace \
  -f my-custom-values.yaml

⚠️ Важно: Не изменяйте файл values.yaml в чарте. Все кастомные настройки должны быть в отдельном файле с оверрайдами, который передается через флаг -f. Это гарантирует, что при обновлении чарта ваши настройки не будут потеряны, и вы получите новые значения по умолчанию из обновленной версии чарта.

Проверка установки

После установки проверьте статус релиза:

# Проверка статуса релиза
helm status $RELEASE_NAME -n $RELEASE_NAMESPACE

# Проверка запущенных подов
kubectl get pods -n $RELEASE_NAMESPACE

# Проверка сервисов
kubectl get services -n $RELEASE_NAMESPACE

# Проверка Ingress (если включён)
kubectl get ingress -n $RELEASE_NAMESPACE

Все поды должны быть в статусе Running. Это может занять несколько минут.

Получение доступа к приложению

После успешной установки вы можете получить доступ к веб-интерфейсу VAMPY:

Если используется Ingress:

Откройте браузер и перейдите по адресу, указанному в vDeck.ingress.domainName

Если используется LoadBalancer:

kubectl get service -n $RELEASE_NAMESPACE | grep vDeck

Используйте внешний IP-адрес LoadBalancer

Если используется порт-форвардинг для тестирования:

kubectl port-forward -n $RELEASE_NAMESPACE service/${RELEASE_NAME}-v-deck 8080:8080

Затем откройте http://localhost:8080 в браузере