Значения ниже настраивают 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: 22TLS
По умолчанию сертификаты 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 в таком порядке:
- Включите во внешнем Ingress-контроллере
use-proxy-protocol: "true". Значениеproxy-real-ip-cidrдополнительно ограничивает источники, адрес клиента из заголовка которых контроллер доверяет, например CIDR диапазоном подов кластера. - Обновите релиз со значением
proxyProtocol: true:
global:
codeHelm:
loadbalancer:
enabled: true
proxyProtocol: trueIngress-контроллер должен принимать заголовок 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: trueHAProxy восстанавливает 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: passwordPraefect хранит метаданные маршрутизации в собственной базе данных, указанной в 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: passwordRedis
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: trueglobal:
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>'