Значения ниже настраивают Helm-релиз Deckhouse Code сверх минимальной установки из раздела Быстрый старт. Имена значений совпадают с именами в values.yaml чарта; раздел Расширенная настройка перечисляет значения, которые чарт добавляет к upstream-чарту GitLab, и изменённые значения upstream-чарта по умолчанию. Изменение применяется той же командой, что и установка:

helm upgrade --install code oci://<CHART_REGISTRY>/code \
  --version <CHART_VERSION> -n code -f values.yaml

Имена хостов и Ingress

global.hosts.domain — базовый домен. Веб-интерфейс и, если они включены, хранилище образов и Pages отвечают по именам gitlab.<домен>, registry.<домен> и pages.<домен>, если global.hosts.gitlab.name, global.hosts.registry.name и global.hosts.pages.name не задают другие. global.ingress.class выбирает Ingress-контроллер; global.shell.port — порт SSH, который Git-клиенты видят в URL для клонирования.

global:
  hosts:
    domain: example.com
    gitlab:
      name: code.example.com
    registry:
      name: registry.example.com
  ingress:
    class: nginx
  shell:
    port: 22

TLS

По умолчанию сертификаты Ingress выпускает cert-manager из ClusterIssuer, указанного в global.codeHelm.ingress.tls.clusterIssuer, в Secret code-tls, code-registry-tls и code-pages-tls, по одному для каждого включённого адреса. Чтобы использовать собственный сертификат, переключитесь в ручной режим и укажите Secret типа kubernetes.io/tls, который покрывает все имена хостов:

global:
  codeHelm:
    ingress:
      tls:
        mode: manual
  ingress:
    tls:
      secretName: <TLS_SECRET_NAME>

Создайте Secret в неймспейсе релиза до обновления; чарт его не создаёт и не продлевает. Отдельный Secret для каждого включённого компонента указывается в gitlab.webservice.ingress.tls.secretName, registry.ingress.tls.secretName, gitlab.gitlab-pages.ingress.tls.secretName и gitlab.kas.ingress.tls.secretName. Оба режима описаны в разделе TLS для Ingress.

Балансировщик

Релиз публикует HTTP, HTTPS и Git по SSH через Service code-code-loadbalancer типа LoadBalancer, который обслуживает Deployment HAProxy. Внешний адрес Service назначает кластер; global.codeHelm.loadbalancer.annotations передаёт аннотации, которые читает реализация балансировщика, например фиксированный адрес для MetalLB:

global:
  codeHelm:
    loadbalancer:
      enabled: true
      annotations:
        metallb.universe.tf/loadBalancerIPs: <EXTERNAL_IP>
      replicas: 2
      resources:
        requests:
          cpu: 100m
          memory: 128Mi
        limits:
          cpu: 500m
          memory: 256Mi

Если в кластере работает несколько реализаций балансировщика, global.codeHelm.loadbalancer.loadBalancerClass выбирает одну из них. global.codeHelm.loadbalancer.hpa масштабирует поды HAProxy по использованию CPU и памяти вместо replicas, а global.codeHelm.loadbalancer.pdb.enabled сохраняет один под доступным, пока узлы освобождаются от подов. HTTP и HTTPS направляются в Service Ingress-контроллера ingress-nginx-controller.ingress-nginx.svc; для другого контроллера задайте global.codeHelm.loadbalancer.ingressService. Все значения перечислены в разделе Балансировщик.

Сохранение IP-адреса клиента

По умолчанию Ingress-контроллер и Git-оболочка видят IP-адрес пода HAProxy: журналы доступа, ограничение частоты запросов и блокировка IP-адресов в GitLab работают с одним адресом для всех клиентов.

Service code-code-loadbalancer создаётся с externalTrafficPolicy: Local: кластер передаёт поду HAProxy IP-адрес клиента без подмены, и трафик приходит только на узлы с готовыми подами HAProxy. При одной реплике весь внешний трафик обслуживает один узел.

Значение global.codeHelm.loadbalancer.proxyProtocol: true включает PROXY protocol v2 в соединениях с бэкендами. HAProxy отправляет перед началом трафика заголовок с IP-адресом и портом клиента, и бэкенды восстанавливают адрес клиента из этого заголовка.

Включайте proxyProtocol в таком порядке:

  1. Включите во внешнем Ingress-контроллере use-proxy-protocol: "true". Значение proxy-real-ip-cidr дополнительно ограничивает источники, адрес клиента из заголовка которых контроллер доверяет, например CIDR диапазоном подов кластера.
  2. Обновите релиз со значением proxyProtocol: true:
global:
  codeHelm:
    loadbalancer:
      enabled: true
      proxyProtocol: true

Ingress-контроллер должен принимать заголовок PROXY protocol до обновления релиза. Пока HAProxy отправляет заголовок, который контроллер не принимает, каждый web-запрос завершается ошибкой 400 или ошибкой TLS-соединения.

Сторона Git-оболочки включена значениями по умолчанию: gitlab.gitlab-shell.sshDaemon: gitlab-sshd и gitlab.gitlab-shell.config.proxyProtocol: true. Демон gitlab-sshd принимает и соединения без заголовка PROXY protocol, поэтому Git по SSH работает и при выключенном proxyProtocol. Установка завершается ошибкой, если proxyProtocol включён при gitlab.gitlab-shell.sshDaemon: openssh или gitlab.gitlab-shell.config.proxyProtocol: false: OpenSSH не декодирует заголовок, и Git по SSH перестал бы работать.

Балансировщик за прокси с PROXY protocol

Перед балансировщиком может стоять прокси, который принимает клиентские соединения и отправляет PROXY protocol: облачный NLB с включённым proxy_protocol_v2, HAProxy или Envoy перед кластером. Для такой цепочки включите global.codeHelm.loadbalancer.frontendProxyProtocol: true вместе с proxyProtocol:

global:
  codeHelm:
    loadbalancer:
      enabled: true
      frontendProxyProtocol: true
      proxyProtocol: true

HAProxy восстанавливает IP-адрес клиента из входящего заголовка и передаёт его бэкендам. Без proxyProtocol IP-адрес клиента остаётся только в журналах HAProxy, а бэкенды получают IP-адрес пода. Если прокси впереди отправляет заголовок, а frontendProxyProtocol выключен, HAProxy передаёт заголовок в поток данных, и соединения прекращаются.

Включайте frontendProxyProtocol только при прокси с PROXY protocol впереди. С этим значением HAProxy принимает на портах 80, 443 и 22 только соединения с заголовком; адрес от реализации без PROXY protocol, например MetalLB или Cilium LB IPAM, прекращает весь трафик — web и Git по SSH.

Сервисная сеть Istio

global.codeHelm.istio.enabled включает поды релиза в сервисную сеть Istio, которая шифрует трафик между компонентами. Выключите внутренний TLS чарта и TLS каждого компонента в тех же значениях; пока один из них включён, установка завершается ошибкой:

global:
  codeHelm:
    istio:
      enabled: true
      strict: false
    tls:
      internal:
        enabled: false
  workhorse:
    tls:
      enabled: false
  gitaly:
    tls:
      enabled: false
  praefect:
    tls:
      enabled: false
gitlab:
  webservice:
    tls:
      enabled: false

Если хранилище образов включено, registry.tls.enabled тоже остаётся false. Чарт помечает каждый под для внедрения сайдкар-контейнера и создаёт объект PeerAuthentication для подов релиза; если в кластере нет API security.istio.io/v1beta1, объект не создаётся. Задачи миграций, резервного копирования и переиндексации базы данных запускают прокси как init-контейнер с restartPolicy: Always, для этого нужен Kubernetes 1.29 или новее.

global.codeHelm.istio.strict: true переключает режим mTLS с PERMISSIVE на STRICT. В этом режиме ни один порт подов Code не принимает открытый трафик, кроме порта Git SSH (2222) и портов метрик kube-rbac-proxy. Чарт добавляет в свои объекты Ingress аннотации nginx.ingress.kubernetes.io, которые направляют запросы Ingress-контроллера через сеть. Значения перечислены в разделе Istio.

При strict: true в global.ingress.class укажите Ingress-контроллер, который находится в Istio service mesh — имеет Istio-сайдкар. Иначе Code станет недоступен: веб-сервис, Container Registry, Pages и KAS перестанут отвечать.

PostgreSQL

global.psql.host, global.psql.port, global.psql.database и global.psql.username указывают на базу данных приложения. Пароль берётся из global.codeHelm.externalSecrets.psqlPassword или из существующего Secret, указанного в global.psql.password.secret, по ключу из global.psql.password.key. global.psql.sslMode задаёт режим SSL libpq, по умолчанию prefer.

global:
  psql:
    host: <POSTGRESQL_HOST>
    port: 5432
    database: <POSTGRESQL_DATABASE>
    username: <POSTGRESQL_USERNAME>
    sslMode: require
    password:
      secret: <POSTGRESQL_PASSWORD_SECRET>
      key: password

Praefect хранит метаданные маршрутизации в собственной базе данных, указанной в global.praefect.psql.host, global.praefect.psql.port, global.praefect.psql.dbName и global.praefect.psql.user. Её пароль берётся из global.codeHelm.externalSecrets.praefectPassword или из Secret в global.praefect.dbSecret.secret по ключу из global.praefect.dbSecret.key.

global:
  praefect:
    psql:
      host: <POSTGRESQL_HOST>
      port: 5432
      dbName: <PRAEFECT_DATABASE>
      user: <PRAEFECT_USERNAME>
      sslMode: require
    dbSecret:
      secret: <PRAEFECT_PASSWORD_SECRET>
      key: password

Redis

global.redis.host и global.redis.port указывают на сервер Redis. Пароль берётся из global.codeHelm.externalSecrets.redisPassword или из Secret в global.redis.auth.secret по ключу из global.redis.auth.key. Для сервера без пароля установите global.redis.auth.enabled в false.

global:
  redis:
    host: <REDIS_HOST>
    port: 6379
    auth:
      enabled: true
      secret: <REDIS_PASSWORD_SECRET>
      key: password

Для Redis за Sentinel global.redis.host называет набор master, а global.redis.sentinels перечисляет серверы Sentinel, каждый с host и port. Если серверам Sentinel нужен пароль, установите global.redis.sentinelAuth.enabled в true и передайте его через global.codeHelm.externalSecrets.redisSentinelPassword или через Secret, указанный в global.redis.sentinelAuth.secret, по ключу из global.redis.sentinelAuth.key.

Объектное хранилище

Приложение хранит загруженные файлы, артефакты, объекты LFS, пакеты, диффы запросов на слияние, состояние Terraform, кеш прокси зависимостей и архивы резервных копий в S3-совместимом хранилище. Подключение берётся из global.codeHelm.externalSecrets.s3 или из существующего Secret, указанного в global.appConfig.object_store.connection.secret, ключ connection которого содержит подключение в формате библиотеки хранилища:

provider: AWS
region: <S3_REGION>
endpoint: <S3_ENDPOINT_URL>
aws_access_key_id: <S3_ACCESS_KEY_ID>
aws_secret_access_key: <S3_SECRET_ACCESS_KEY>
path_style: true
global:
  appConfig:
    object_store:
      connection:
        secret: <OBJECT_STORAGE_SECRET>
        key: connection
    lfs:
      bucket: <LFS_BUCKET>
    artifacts:
      bucket: <ARTIFACTS_BUCKET>
    uploads:
      bucket: <UPLOADS_BUCKET>
    packages:
      bucket: <PACKAGES_BUCKET>
    externalDiffs:
      bucket: <MR_DIFFS_BUCKET>
    terraformState:
      bucket: <TERRAFORM_STATE_BUCKET>
    dependencyProxy:
      bucket: <DEPENDENCY_PROXY_BUCKET>
    backups:
      bucket: <BACKUPS_BUCKET>
      tmpBucket: <BACKUP_TMP_BUCKET>

path_style: true нужен хранилищам, которые адресуют бакеты в пути URL вместо имени хоста, например MinIO. У каждого хранилища данных свой бакет в global.appConfig.<хранилище>.bucket; раздел Требования перечисляет их с именами по умолчанию.

Хранилище Git

Каждый под Gitaly хранит репозитории на PersistentVolumeClaim размером из gitlab.gitaly.persistence.size в StorageClass из gitlab.gitaly.persistence.storageClass. global.praefect.virtualStorages[0].gitalyReplicas задаёт число подов Gitaly за Praefect; каждый под хранит полную копию каждого репозитория.

global:
  praefect:
    virtualStorages:
      - name: default
        gitalyReplicas: 3
        maxUnavailable: 1
gitlab:
  gitaly:
    persistence:
      size: 200Gi
      storageClass: <STORAGE_CLASS_NAME>

Релиз работает в режиме высокой доступности, когда в кластере есть минимум три реплики Gitaly (global.praefect.virtualStorages[].gitalyReplicas) и три реплики Praefect (gitlab.praefect.replicas). При меньшем количестве чарт выводит предупреждение о конфигурации без отказоустойчивости после установки и обновления.

Размер существующего PersistentVolumeClaim меняется через расширение тома в StorageClass; значение действует для PersistentVolumeClaim, созданных после изменения.

Хранилище образов контейнеров

Хранилище образов по умолчанию выключено. registry.enabled разворачивает его по имени global.hosts.registry.name, а global.registry.enabled включает хранилище образов в приложении: приложение выдаёт токены доступа к нему и показывает образы каждого проекта. Установите оба значения в true. Хранилище образов хранит слои образов в бакете из global.codeHelm.externalSecrets.registry.storage.s3 или читает конфигурацию хранилища из существующего Secret, указанного в registry.storage.secret; без одного из них установка завершается ошибкой.

global:
  hosts:
    registry:
      name: registry.example.com
  registry:
    enabled: true
  codeHelm:
    externalSecrets:
      registry:
        storage:
          s3:
            bucket: <REGISTRY_BUCKET>
            region: <S3_REGION>
            regionendpoint: <S3_ENDPOINT_URL>
            accesskey: <S3_ACCESS_KEY_ID>
            secretkey: <S3_SECRET_ACCESS_KEY>
registry:
  enabled: true

Создайте DNS-запись для имени хранилища образов, указывающую на тот же адрес, что и веб-интерфейс. Входите в хранилище образов с именем пользователя и персональным токеном доступа с областями read_registry и write_registry:

docker login registry.example.com

Чтобы запустить хранилище образов с базой метаданных, укажите в registry.database базу данных PostgreSQL и передайте её пароль через global.codeHelm.externalSecrets.registry.storage.database.password:

registry:
  enabled: true
  database:
    enabled: true
    host: <POSTGRESQL_HOST>
    port: 5432
    dbname: <REGISTRY_DATABASE>
    user: <REGISTRY_USERNAME>
    sslmode: require
    migrations:
      enabled: true
global:
  codeHelm:
    externalSecrets:
      registry:
        storage:
          database:
            password: <REGISTRY_PASSWORD>

registry.database.migrations.enabled запускает миграции схемы хранилища образов задачей при каждом обновлении.

Pages

global.pages.enabled разворачивает Pages, который раздаёт статические сайты из бакета global.pages.objectStore.bucket по имени global.hosts.pages.name и его поддоменам. global.pages.accessControl ограничивает сайт участниками его проекта.

global:
  pages:
    enabled: true
    accessControl: false
    objectStore:
      bucket: <PAGES_BUCKET>
  hosts:
    pages:
      name: pages.example.com

Имя хоста Pages и маска *.pages.example.com разрешаются в тот же адрес, что и веб-интерфейс, а сертификат code-pages-tls выпускается для pages.example.com. Сайтам на поддоменах нужен сертификат с маской, который передаётся через gitlab.gitlab-pages.ingress.tls.secretName в ручном режиме TLS.

SMTP

global.smtp.enabled включает отправку писем. global.smtp.address и global.smtp.port указывают на сервер; global.smtp.user_name и Secret из global.smtp.password.secret хранят учётные данные; global.smtp.authentication выбирает plain, login или cram_md5; global.smtp.starttls_auto переводит соединение на STARTTLS. global.email.from и global.email.display_name задают отправителя.

global:
  smtp:
    enabled: true
    address: <SMTP_HOST>
    port: 587
    user_name: <SMTP_USERNAME>
    password:
      secret: <SMTP_PASSWORD_SECRET>
      key: password
    authentication: plain
    starttls_auto: true
    domain: <SMTP_HELO_DOMAIN>
  email:
    from: <SENDER_EMAIL>
    display_name: Deckhouse Code
    reply_to: <REPLY_TO_EMAIL>

Чарт не создаёт Secret с паролем SMTP. Создайте его до обновления:

d8 k -n code create secret generic <SMTP_PASSWORD_SECRET> --from-literal=password='<SMTP_PASSWORD>'

Дополнительные ресурсы