# Параметры чарта (values.yaml)

В этом разделе описан полный набор параметров, которые можно задать в файле `values.yaml` для чарта `gs-ctk`. Вы можете
переопределить их при вызове `helm install/upgrade` через `--set` или передав свой `values.yaml`.

## Основные настройки развёртывания

- `imageRepository` – реестр Docker-образов (без тега).  
  По умолчанию: `"dockerhub.global-system.ru"`.
- `imageTag` – тег образов. Если не задан, используется версия Helm-чарта.  
  По умолчанию: `""`.
- `imagePullSecret` – имя секрета Kubernetes для доступа к реестру (если требуется авторизация).  
  По умолчанию: `""`.
- `imageMode` – режим формирования ссылок на образы:
    - `tag` – старый режим: `imageRepository:imageTag`.
    - `digestAuto` – digest рабочих образов берутся из встроенного в `nsctl` lock-файла (рекомендуется).
    - `digestManual` – digest берутся из параметра `imageDigests`.  
      По умолчанию: `"tag"`.
- `imageDigests` – список digest для ручного режима. Каждый элемент имеет вид:

  ```yaml
  - image: nsctl  
    digest: sha256:...  
  ```

  По умолчанию: пустой список.
- `deploymentType` – какие ресурсы создавать:
    - `cluster` – только ресурсы уровня кластера (namespace, RBAC).
    - `namespace` – только ресурсы уровня пространства имён (контроллер пространства, ConfigMap).
    - `both` – всё вместе.  
      По умолчанию: `"both"`.
- `timezone` – часовой пояс для подов.  
  По умолчанию: `"Europe/Moscow"`.
- `nsctlDebugEnabled` – включить отладку для `nsctl` (больше логов).  
  По умолчанию: `false`.
- `namespaceSuffix` – суффикс, добавляемый к имени Helm-релиза, чтобы получить имя namespace.  
  По умолчанию: `""`.
- `privilegedSubjects` – список субъектов (User, Group, ServiceAccount), которым даются права на управление
  `GlobalConfiguration` и ресурсами в namespace.  
  *Пример*:

  ```yaml
  - kind: User
    name: gs_admin
  ```

  По умолчанию: пустой список.
- `overrideNsctlServiceAccount` – переопределить ServiceAccount для пода `nsctl` (обычно создаётся автоматически).  
  По умолчанию: `""`.
- `overrideWorkerServiceAccount` – переопределить ServiceAccount для рабочих подов (например, `globalserver`).  
  По умолчанию: `""`.
- `podAnnotations`, `podLabels` – дополнительные аннотации и лейблы для всех подов.  
  По умолчанию: пустые словари.
- `nodeSelector`, `tolerations`, `affinity` – стандартные параметры для размещения подов на узлах.  
  По умолчанию: пустые.
- `nsctlResources` – запросы и лимиты ресурсов для пода `nsctl`.  
  Пример:

  ```yaml
  requests: 
    cpu: 1  
    memory: 1G
  limits:
    cpu: 2
    memory: 2G
  ```

  Это же значение по умолчанию.

## Системное хранилище (`systemVolume`)

Обязательный блок, описывающий системное NFS-хранилище для комплектов приложений `appkit`, комплектов группы `groupkit`
и дампов памяти. Дампы автоматически выгружаются на это хранилище, поэтому его минимальный объём должен составлять
**5–6 размеров максимального `-Xmx`, но не менее 120 ГБ**. Расчёт и дополнительные факторы приведены в
[требованиях к системному NFS-хранилищу](020_min_requirements.md#системное-nfs-хранилище-кластера).

```yaml
systemVolume:
  nfs:
    server: "10.10.0.1"   # IP или DNS NFS-сервера
    path: "/export"       # путь на сервере
```

## Управление секретами

- `addSecrets` – создавать ли стандартный набор секретов (администратор Global и т.д.).  
  По умолчанию: `false`.
- `secrets` – словарь, где ключ – имя секрета, а значение – его спецификация (как в ресурсе `Secret`).

**Пример**:

```yaml
addSecrets: true
secrets:
  gs-admin-auth:
    type: kubernetes.io/basic-auth
    stringData:
      username: admin
      password: "PLACEHOLDER"
```

```{caution}
Напоминаем, что хранить секреты в файле `values.yaml`, особенно в git-репозитории, небезопасно. Все чувствительные данные передавайте через переменные CI/CD или другие безопасные инструменты, такие как SOPS или внешние операторы типа Sealed Secrets.
```

## Конфигурация группы ресурсов (`helmResgroup`)

Кластерная утилита синхронизирует ресурсы кластера с настройками, описанными в GlobalConfigration и
NamespacedGlobalConfiguration. Helm-чартом может быть создан конфигурационный ресурс по умолчанию с переопределением
настройками из values.yaml. Для создания ресурса, необходимо добавить:

```yaml
helmResgroup:
  enabled: true
  database_url: jdbc:postgresql://database.local/global
  appvol:
    path: /app
    server: nfs.local
    type: nfs
```

Если указать `enabled: false`, то конфигурационный ресурс создаваться не будет.

Созданный конфигурационный ресурс будет содержать большинство книг по умолчанию. Он будет использовать те секреты, что
создаются чартом по умолчанию при использовании `addSecrets: true`.

Вы можете переопределять параметры дальше, добавляя нужные настройки. Например, включить Java 21 и увеличить количество
реплик:

```yaml
helmResgroup:
  java_version: "21"
  resbooks:
    - name: global-server-share
      replicas: 10
      type: global_server_share
  ...
```
