Чарт Deckhouse Code построен на Helm-чарте GitLab. Значения, которых нет на этой странице, сохраняют имена и смысл upstream-чарта. В таблицах ниже перечислены значения, которые чарт добавляет в global.codeHelm, дополнения в global.psql и global.appConfig и изменённые значения upstream-чарта по умолчанию. В колонке «По умолчанию» указано значение, с которым поставляется чарт; — означает, что значение пустое, пока вы его не задали.
Компоненты, которые предоставляет кластер
Чарт разворачивает приложение и, если registry.enabled равен true, хранилище образов контейнеров. Компоненты ниже кластер предоставляет до установки релиза. Чарт их не разворачивает:
- Ingress-контроллер, на который указывают
global.ingress.classи, при включённом балансировщике,global.codeHelm.loadbalancer.ingressService; - cert-manager с ClusterIssuer, который используют
global.codeHelm.ingress.tlsиglobal.codeHelm.tls.internal; - PostgreSQL, Redis и S3-совместимое объектное хранилище, на которые указывают
global.psql,global.redisиglobal.appConfig.object_store; - Prometheus Operator и Grafana, если используются объекты из раздела Мониторинг;
- GitLab Runner.
Upstream-сабчарты gitlab-runner, prometheus, certmanager, nginx-ingress, nginx-ingress-geo, haproxy, traefik, kubernetes-ingress, gitlab-zoekt и redis-ha не входят в чарт. Если установить их ключ install или enabled в true либо installCertmanager в true, установка завершается ошибкой.
Secret из значений
global.codeHelm.externalSecrets создаёт Secret с учётными данными внешних сервисов из файла значений вместо Secret, создаваемых вручную перед установкой. Имя каждого Secret начинается с имени релиза, поэтому несколько релизов могут находиться в одном неймспейсе.
Если registry.enabled равен true, хранилищу образов контейнеров нужен Secret с настройками хранилища: либо из блока registry.storage.s3 ниже, либо из registry.storage.secret; если отсутствуют оба, установка завершается ошибкой.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.externalSecrets.enabled | булево | false | Создаёт ли чарт Secret, описанные в этой таблице. При true обязателен registryDockerConfig и заданы либо учётные данные backup, либо gitlab.toolbox.backups.objectStorage.config.secret; иначе установка завершается ошибкой. |
global.codeHelm.externalSecrets.psqlPassword | строка | — | Пароль роли PostgreSQL из global.psql.username. Создаёт Secret <release>-postgres с ключом из global.psql.password.key; релиз использует этот Secret, если global.psql.password.secret не задан. |
global.codeHelm.externalSecrets.redisPassword | строка | — | Пароль сервера Redis. Создаёт Secret с именем из global.redis.auth.secret (по умолчанию <release>-redis-secret) и ключом из global.redis.auth.key. |
global.codeHelm.externalSecrets.redisSentinelPassword | строка | — | Пароль серверов Sentinel из global.redis.sentinels. Требует global.redis.sentinelAuth.enabled: true; без него установка завершается ошибкой. Создаёт Secret <release>-redis-sentinel-secret с ключом secret — это имя релиз читает, если global.redis.sentinelAuth.secret не задан; если заданы оба, установка завершается ошибкой. |
global.codeHelm.externalSecrets.praefectPassword | строка | — | Пароль пользователя PostgreSQL для Praefect из global.praefect.psql.user. Требует global.praefect.psql.host; без него установка завершается ошибкой. Создаёт Secret с именем из global.praefect.psql.dbSecret.secret (по умолчанию <release>-praefect-dbsecret). |
global.codeHelm.externalSecrets.s3.provider | строка | AWS | Имя серверной части хранилища в строке подключения к объектному хранилищу. Остаётся AWS для любого S3-совместимого хранилища. |
global.codeHelm.externalSecrets.s3.region | строка | us-east-1 | Регион объектного хранилища. Обязателен, если используется блок s3. |
global.codeHelm.externalSecrets.s3.aws_access_key_id | строка | — | Идентификатор ключа доступа к объектному хранилищу. Его или секретный ключ достаточно задать, чтобы блок s3 заработал: чарт создаёт Secret <release>-s3-connection с ключом connection, и global.appConfig.object_store.connection указывает на этот Secret, если вы не задали его сами. |
global.codeHelm.externalSecrets.s3.aws_secret_access_key | строка | — | Секретный ключ доступа к объектному хранилищу. Обязателен, если используется блок s3. |
global.codeHelm.externalSecrets.s3.endpoint | строка | — | URL точки доступа S3 со схемой, например https://storage.example.com. Обязателен, если используется блок s3. |
global.codeHelm.externalSecrets.s3.host | строка | — | Хост точки доступа S3 без схемы, для хранилищ с адресацией через путь. |
global.codeHelm.externalSecrets.s3.path_style | булево | false | Передаётся ли имя бакета в пути URL вместо имени хоста. |
global.codeHelm.externalSecrets.s3.aws_signature_version | целое число | 4 | Версия подписи запросов, которую принимает хранилище. |
global.codeHelm.externalSecrets.backup.aws_access_key_id | строка | — | Идентификатор ключа доступа к хранилищу, в которое загружаются архивы резервных копий. Вместе с секретным ключом создаёт Secret <release>-s3cfg с ключом config, который читает утилита резервного копирования. Хранилище может отличаться от указанного в блоке s3. |
global.codeHelm.externalSecrets.backup.aws_secret_access_key | строка | — | Секретный ключ доступа к хранилищу резервных копий. |
global.codeHelm.externalSecrets.registry.storage.s3.bucket | строка | — | Бакет, в котором хранятся слои образов контейнеров. Его или accesskey достаточно задать, чтобы блок заработал: чарт создаёт Secret <release>-registry-storage-config, хранилище образов читает его без дополнительных настроек, а registry.storage.secret не учитывается. |
global.codeHelm.externalSecrets.registry.storage.s3.accesskey | строка | — | Ключ доступа к объектному хранилищу образов. Обязателен, если используется блок. |
global.codeHelm.externalSecrets.registry.storage.s3.secretkey | строка | — | Секретный ключ объектного хранилища образов. Обязателен, если используется блок. |
global.codeHelm.externalSecrets.registry.storage.s3.region | строка | us-east-1 | Регион объектного хранилища образов. Обязателен, если используется блок. |
global.codeHelm.externalSecrets.registry.storage.s3.regionendpoint | строка | — | URL точки доступа объектного хранилища образов, например https://storage.example.com. Обязателен, если используется блок. |
global.codeHelm.externalSecrets.registry.storage.s3.v4auth | булево | true | Подписывает ли хранилище образов запросы по AWS Signature Version 4. |
global.codeHelm.externalSecrets.registry.storage.s3.secure | булево | true | Подключается ли хранилище образов к объектному хранилищу по HTTPS. |
global.codeHelm.externalSecrets.registry.storage.s3.rootdirectory | строка | / | Префикс внутри бакета, под которым хранилище образов хранит данные. |
global.codeHelm.externalSecrets.registry.storage.s3.checksumDisabled | булево | false | Опускает ли хранилище образов контрольные суммы в запросах копирования частей. Установите true для хранилищ, которые отклоняют запросы UploadPartCopy с контрольной суммой. |
global.codeHelm.externalSecrets.registry.storage.database.password | строка | — | Пароль пользователя PostgreSQL базы метаданных хранилища образов. Создаёт Secret <release>-registry-database-password с ключом password. |
global.codeHelm.externalSecrets.registryDockerConfig | строка | — | Содержимое .dockerconfigjson в кодировке Base64 с учётными данными хранилища образов, из которого чарт загружает образы. Создаёт Secret <release>-image-pull-secret типа kubernetes.io/dockerconfigjson. Обязателен при enabled: true. |
Хранилище резервных копий
global.codeHelm.backup хранит адрес хранилища, в которое загружаются архивы резервных копий. Вместе с учётными данными из global.codeHelm.externalSecrets.backup он формирует Secret <release>-s3cfg.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.backup.region | строка | us-east-1 | Регион хранилища резервных копий. |
global.codeHelm.backup.endpoint | строка | http://minio:9000 | URL точки доступа хранилища резервных копий. Схема выбирает транспорт: http:// подключается без TLS, https:// с TLS. |
TLS для Ingress
global.codeHelm.ingress.tls задаёт, откуда берутся сертификаты объектов Ingress.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.ingress.tls.mode | строка | certManager | Источник сертификатов Ingress. certManager: чарт создаёт Certificate cert-manager для каждого включённого адреса и хранит их в Secret <release>-tls (веб-интерфейс), <release>-registry-tls, <release>-pages-tls и <release>-kas-tls; установка завершается ошибкой, если cert-manager отсутствует или переопределение ingress.tls.secretName указывает на другой Secret. manual: чарт не выпускает сертификаты для Ingress. Ingress каждого компонента использует Secret, указанный в его ingress.tls.secretName (gitlab.webservice, registry, gitlab.gitlab-pages, gitlab.kas); компонент без этого значения использует Secret из global.ingress.tls.secretName, и его сертификат покрывает все включённые хосты. Установка завершается ошибкой, если не задано ни global.ingress.tls.secretName, ни gitlab.webservice.ingress.tls.secretName. |
global.codeHelm.ingress.tls.clusterIssuer | строка | letsencrypt | Имя ClusterIssuer cert-manager, который подписывает сертификаты Ingress в режиме certManager. |
В режиме manual создайте Secret сами или добавьте cert-manager.io/cluster-issuer: <ISSUER> в global.ingress.annotations, где <ISSUER> — имя ClusterIssuer cert-manager. Эти аннотации есть у каждого Ingress чарта, и cert-manager выпускает сертификат в Secret, указанный в Ingress.
Балансировщик
global.codeHelm.loadbalancer разворачивает Deployment с HAProxy и Service типа LoadBalancer с именем <release>-code-loadbalancer. Service принимает порты 80, 443 и 22: HTTP и HTTPS передаются Ingress-контроллеру, SSH передаётся Service Git-оболочки внутри кластера. Инстанс получает один внешний адрес для Git по HTTPS и SSH.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.loadbalancer.enabled | булево | true | Разворачивает ли чарт балансировщик. При true значение gitlab.gitlab-shell.service.type остаётся ClusterIP; иначе установка завершается ошибкой. При false откройте SSH сами, задав gitlab.gitlab-shell.service.type равным LoadBalancer или NodePort. |
global.codeHelm.loadbalancer.proxyProtocol | булево | false | Заставляет ли HAProxy отправлять бэкендам заголовок PROXY protocol v2 с IP-адресом клиента. Требует Ingress-контроллер с use-proxy-protocol: "true" и Git-оболочку с gitlab.gitlab-shell.sshDaemon: gitlab-sshd и gitlab.gitlab-shell.config.proxyProtocol: true; сторона Git-оболочки проверяется при установке, без контроллера с приёмом заголовка весь web-трафик прекращается. Порядок включения описан в разделе Сохранение IP-адреса клиента. |
global.codeHelm.loadbalancer.frontendProxyProtocol | булево | false | Заставляет ли HAProxy требовать заголовок PROXY protocol на входящих соединениях портов 80, 443 и 22. Включайте только при прокси с PROXY protocol перед балансировщиком и вместе со значением proxyProtocol. |
global.codeHelm.loadbalancer.ingressService | строка | ingress-nginx-controller.ingress-nginx.svc | DNS-имя Service Ingress-контроллера, который получает трафик HTTP и HTTPS, когда httpBackends и ingressClass пусты. |
global.codeHelm.loadbalancer.ingressClass | строка | — | Имя класса Ingress, контроллер которого получает трафик HTTP и HTTPS. Адресом становится <ingressClass>-load-balancer; используется, когда httpBackends пуст. |
global.codeHelm.loadbalancer.httpBackends | массив строк | [] | Имена адресатов трафика HTTP и HTTPS. Каждое имя N превращается в адресат N-load-balancer с портами 80 и 443. Имеет приоритет над ingressClass и ingressService. |
global.codeHelm.loadbalancer.replicas | целое число | 1 | Число подов HAProxy при выключенном автомасштабировании. |
global.codeHelm.loadbalancer.resources | объект | запросы 100m CPU и 128Mi памяти, лимиты 500m CPU и 256Mi памяти | Запросы и лимиты ресурсов контейнера HAProxy. |
global.codeHelm.loadbalancer.hpa.enabled | булево | false | Масштабирует ли HorizontalPodAutoscaler Deployment с HAProxy. |
global.codeHelm.loadbalancer.hpa.minReplicas | целое число | 1 | Нижняя граница автомасштабирования. |
global.codeHelm.loadbalancer.hpa.maxReplicas | целое число | 2 | Верхняя граница автомасштабирования. |
global.codeHelm.loadbalancer.hpa.cpuUtilization | целое число | 80 | Целевая средняя загрузка CPU в процентах от запроса. |
global.codeHelm.loadbalancer.hpa.memoryUtilization | целое число | 80 | Целевая средняя загрузка памяти в процентах от запроса. |
global.codeHelm.loadbalancer.pdb.enabled | булево | false | Сохраняет ли PodDisruptionBudget хотя бы один под HAProxy доступным при плановых прерываниях. |
global.codeHelm.loadbalancer.annotations | объект | {} | Аннотации Service типа LoadBalancer, например аннотация адреса облачного балансировщика или MetalLB. |
global.codeHelm.loadbalancer.loadBalancerClass | строка | — | Значение аннотации service.kubernetes.io/load-balancer-class этого Service, когда в кластере работает несколько реализаций балансировщика. |
Внутренний TLS
global.codeHelm.tls.internal шифрует трафик между компонентами релиза сертификатами cert-manager: чарт создаёт самоподписанный Issuer, внутренний удостоверяющий центр и Certificate для веб-сервиса, Workhorse, Praefect и каждого виртуального хранилища Gitaly. Secret называются <release>-webservice-tls, <release>-workhorse-tls, <release>-praefect-tls и Secret Gitaly каждого виртуального хранилища.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.tls.internal.enabled | булево | true | Создаёт ли чарт внутренний удостоверяющий центр и сертификаты компонентов. Требует cert-manager в кластере и upstream-флаги gitlab.webservice.tls.enabled, global.workhorse.tls.enabled, global.gitaly.tls.enabled и global.praefect.tls.enabled со значением true (значение чарта по умолчанию); если один из них false, установка завершается ошибкой. Не действует при global.codeHelm.istio.enabled: true. |
Istio
global.codeHelm.istio включает релиз в сервисную сеть Istio: поды получают метку внедрения сайдкар-контейнера, а объект PeerAuthentication задаёт режим mTLS неймспейса. Сеть заменяет внутренний TLS, поэтому global.codeHelm.tls.internal.enabled, global.gitaly.tls.enabled, global.praefect.tls.enabled, global.workhorse.tls.enabled, gitlab.webservice.tls.enabled и, если хранилище образов включено, registry.tls.enabled должны быть false; иначе установка завершается ошибкой.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.istio.enabled | булево | false | Входят ли поды в сервисную сеть. Требует Istio с API security.istio.io/v1beta1 и включённое внедрение сайдкар-контейнеров для неймспейса. Задачи миграций, резервного копирования и переиндексации базы данных запускают прокси как native sidecar, для этого нужен Kubernetes 1.29 или новее; классический сайдкар-контейнер не даёт завершившемуся поду задачи остановиться. |
global.codeHelm.istio.strict | булево | false | Режим mTLS объекта PeerAuthentication: false соответствует PERMISSIVE, true соответствует STRICT. Строгий режим не оставляет открытых портов для HTTP-трафика: веб-сервис, Container Registry, Pages и KAS перестают отвечать, если запросы приходят не от Ingress-контроллера с mesh-сайдкаром. В global.ingress.class укажите IngressClass, контроллер которого работает в сети Istio. Только порт Git SSH (2222) и порты метрик kube-rbac-proxy (9090/9254) остаются в режиме PERMISSIVE — Git-клиенты и Prometheus-скрейпер не могут использовать mTLS. |
Метрики через kube-rbac-proxy
global.codeHelm.kubeRbacProxy добавляет сайдкар-контейнер kube-rbac-proxy в поды веб-сервиса, Sidekiq, Gitaly, Git-оболочки, Pages, Praefect, экспортера, хранилища образов и балансировщика. Контейнер отдаёт метрики своего пода на порту https-metrics и пропускает запрос только после проверки его токена через TokenReview и SubjectAccessReview. Чарт создаёт Service <release>-<компонент>-metrics и ServiceMonitor <release>-<компонент> для каждого компонента, Secret <release>-prometheus-token, из которого ServiceMonitor берут токен, и объекты RBAC, нужные контейнерам для проверок.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.kubeRbacProxy.enabled | булево | false | Создаются ли сайдкар-контейнеры, Service, ServiceMonitor и объекты RBAC. При true выключите upstream-объекты ServiceMonitor, чтобы Prometheus собирал метрики через прокси: gitlab.webservice.serviceMonitor.enabled, gitlab.sidekiq.serviceMonitor.enabled, gitlab.gitaly.serviceMonitor.enabled, gitlab.gitlab-shell.serviceMonitor.enabled, gitlab.gitlab-pages.serviceMonitor.enabled, gitlab.praefect.serviceMonitor.enabled и gitlab.gitlab-exporter.serviceMonitor.enabled. |
global.codeHelm.kubeRbacProxy.serviceAccountToken | строка | — | Токен, который Prometheus предъявляет сайдкар-контейнерам. Обязателен при enabled: true; иначе установка завершается ошибкой. ServiceAccount, которому принадлежит токен, нужен глагол get на субресурсы deployments/prometheus-metrics и statefulsets/prometheus-metrics в неймспейсе релиза. |
global.codeHelm.kubeRbacProxy.caSecret | строка | — | Имя существующего Secret с сертификатом удостоверяющего центра в ключе ca.crt, по которому сайдкар-контейнеры проверяют клиентские сертификаты. Если пусто, сертификат выпускает clusterIssuer. |
global.codeHelm.kubeRbacProxy.clusterIssuer | строка | selfsigned | Имя ClusterIssuer cert-manager, который подписывает Certificate удостоверяющего центра <release>-kube-rbac-proxy-ca, когда caSecret пуст. Если пусты оба значения при enabled: true, установка завершается ошибкой. |
global.codeHelm.kubeRbacProxy.resources | объект | запросы 10m CPU, 25Mi памяти и 50Mi временного хранилища | Запросы и лимиты ресурсов сайдкар-контейнера. |
global.codeHelm.kubeRbacProxy.securityContext | объект | без повышения привилегий, корневая файловая система только для чтения, все capabilities сброшены, профиль seccomp RuntimeDefault | Контекст безопасности сайдкар-контейнера. |
События аудита
global.codeHelm.audit добавляет сайдкар-контейнер audit в поды веб-сервиса и Sidekiq. Контейнер читает журнал аудита своего пода и выводит каждое событие в стандартный вывод в формате CEF, поэтому стек логирования кластера собирает события из логов контейнера. Чтобы прочитать их напрямую:
d8 k -n code logs <POD_NAME> -c auditСами события описаны в разделе События аудита.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.audit.enabled | булево | true | Добавляется ли сайдкар-контейнер в поды веб-сервиса и Sidekiq. |
global.codeHelm.audit.resources | объект | запросы и лимиты 100m CPU и 128Mi памяти | Запросы и лимиты ресурсов сайдкар-контейнера. |
global.codeHelm.audit.securityContext | объект | без повышения привилегий, все capabilities сброшены, профиль seccomp RuntimeDefault | Контекст безопасности сайдкар-контейнера. |
Мониторинг
global.codeHelm.monitoring создаёт объекты, которые подхватывают Prometheus Operator и Grafana.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.monitoring.prometheusRules | булево | false | Создаёт ли чарт PrometheusRule <release>-code-helm с меткой prometheus: d8-monitoring. Правила предупреждают о недоступности веб-сервиса и Sidekiq, о сбоях и устаревании синхронизации LDAP и о сбоях pull-зеркал. Создаётся только при наличии в кластере API monitoring.coreos.com/v1. |
global.codeHelm.monitoring.dashboards | булево | true | Создаёт ли чарт ConfigMap <release>-grafana-dashboard с меткой grafana_dashboard: "1" и дашбордом Grafana для инстанса. Sidecar-контейнер дашбордов Grafana подхватывает его из неймспейса релиза; для другого неймспейса расширьте список неймспейсов, которые он просматривает. |
Расширенный поиск
global.codeHelm.search подключает инстанс к кластеру OpenSearch для поиска по коду и содержимому. Индексирование и сам поиск описаны в разделе Расширенный поиск.
Учётные данные задаются значениями credentials.* или ссылкой на существующий Secret (username и password с полями secret и key); если заданы оба способа, используются credentials.*. Без учётных данных подключение анонимное.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.search.enabled | булево | false | Включён ли расширенный поиск в конфигурации приложения. |
global.codeHelm.search.opensearch.url | строка | http://opensearch:9200/ | URL точки доступа OpenSearch. |
global.codeHelm.search.opensearch.credentials.username | строка | — | Имя пользователя учётной записи OpenSearch. Вместе с паролем создаёт Secret <release>-code-helm-opensearch-creds, который монтируют поды веб-сервиса и Sidekiq. |
global.codeHelm.search.opensearch.credentials.password | строка | — | Пароль учётной записи OpenSearch. |
global.codeHelm.search.opensearch.username.secret | строка | code-helm-opensearch-creds | Имя существующего Secret с именем пользователя OpenSearch. Этот Secret чарт не создаёт — создайте его в неймспейсе релиза; чарт смонтирует его в поды веб-сервиса и Sidekiq. |
global.codeHelm.search.opensearch.username.key | строка | username | Ключ существующего Secret, в котором хранится имя пользователя. |
global.codeHelm.search.opensearch.password.secret | строка | code-helm-opensearch-creds | Имя существующего Secret с паролем OpenSearch. Может быть тем же Secret, что и в username.secret, или другим. |
global.codeHelm.search.opensearch.password.key | строка | password | Ключ существующего Secret, в котором хранится пароль. |
global.codeHelm.search.opensearch.maxBulkSizeBytes | целое число | 10485760 | Верхний размер одного пакетного запроса индексирования в байтах. |
global.codeHelm.search.opensearch.maxBulkConcurrency | целое число | 10 | Число одновременно выполняемых пакетных запросов индексирования. |
global.codeHelm.search.opensearch.repositoryIndexerMaxConcurrency | целое число | 30 | Число одновременно работающих процессов индексирования репозиториев. |
global.codeHelm.search.opensearch.indexedFileSizeLimitKb | целое число | 1024 | Верхний размер файла, содержимое которого индексируется, в килобайтах. Более крупные файлы индексируются только по имени. |
global.codeHelm.search.opensearch.readTimeout | целое число | 10 | Предельное время одного поискового запроса, в секундах. Запрос, превысивший его, не повторяется, и поиск возвращает ошибку. |
global.codeHelm.search.opensearch.adminRequestTimeout | целое число | 60 | Предельное время запросов состояния индексов и пересоздания индексов, в секундах. Эти запросы не повторяются. |
global.codeHelm.search.opensearch.indexingRequestTimeout | целое число | 1800 | Предельное время одного запроса индексирования, в секундах. Неудачный запрос индексирования повторяется, поэтому задача индексирования может ждать дольше этого значения. |
global.codeHelm.search.sidekiq.routingRules | массив | [["feature_category=fe_global_search", "global-search-indexing"], ["*", "default"]] | Правила маршрутизации Sidekiq: каждый элемент — пара из селектора задач и очереди, в которую они попадают. По умолчанию задачи индексирования идут в очередь global-search-indexing, остальные в default. |
Чтобы использовать учётные данные из существующего Secret вместо credentials.*, задайте ссылку на него в values:
global:
codeHelm:
search:
enabled: true
opensearch:
url: https://search.example.svc:9200
username:
secret: opensearch-creds
key: username
password:
secret: opensearch-creds
key: passwordЧтобы задачи индексирования выполнялись в отдельных подах, добавьте под Sidekiq для этой очереди:
gitlab:
sidekiq:
pods:
- name: all-in-1
- name: global-search
queues: global-search-indexingОбразы контейнеров
Образ каждой рабочей нагрузки закреплён в чарте при сборке. global.codeHelm.images заменяет закреплённый образ компонента, например когда образы скопированы в хранилище образов внутри сети.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.codeHelm.images.<компонент> | строка | — | Полная ссылка на образ компонента, registry/repository:tag или registry/repository@sha256:...; она полностью заменяет закреплённую ссылку. Имена компонентов: webservice-default, workhorse, sidekiq-all-in-1-v2, sidekiq-global-search-v2, gitaly-default, gitaly-init-cgroups, praefect, registry, shell, toolbox, rails, exporter, mailroom, pages, base, certificates, kube-rbac-proxy, haproxy, vector, kubectl, cfssl-self-sign, kas. Под Sidekiq из gitlab.sidekiq.pods берёт образ из ключа sidekiq-<имя пода>-v2, а при его отсутствии из sidekiq-all-in-1-v2. |
global.codeHelm.nameOverride | строка | <release>-code-helm | Префикс имён объектов, которые чарт добавляет к upstream-чарту: ConfigMap аудита, Secret OpenSearch, PrometheusRule, а также Issuer и удостоверяющий центр внутреннего TLS. |
Шифрование подключения к PostgreSQL
global.psql.sslMode и global.psql.ssl задают, как приложение подключается к PostgreSQL. global.praefect.psql.sslMode делает то же для базы данных Praefect и по умолчанию тоже равен prefer.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.psql.sslMode | строка | prefer | Режим SSL libpq для подключений приложения: disable, allow, prefer, require, verify-ca или verify-full. Если значение пустое, а global.psql.ssl задан, действует режим verify-ca. |
global.psql.ssl.secret | строка | — | Имя Secret с сертификатами для взаимной проверки TLS. Если используется блок ssl, обязателен каждый ключ блока. |
global.psql.ssl.serverCA | строка | — | Ключ внутри этого Secret с сертификатом удостоверяющего центра сервера. |
global.psql.ssl.clientCertificate | строка | — | Ключ внутри этого Secret с клиентским сертификатом. |
global.psql.ssl.clientKey | строка | — | Ключ внутри этого Secret с закрытым ключом клиента. |
Провайдеры аутентификации
Чарт принимает upstream-поля элемента global.appConfig.omniauth.providers (name, label, icon, secret, key, args) и поля групп ниже. Если элемент указывает secret, провайдер читается из этого Secret, и поля групп записываются в его YAML. Полные примеры элементов приведены в разделе SAML.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.appConfig.omniauth.providers[].allowed_groups | массив строк | — | Группы провайдера идентификации, участники которых могут войти. Если не задано, войти может любой аутентифицированный пользователь. |
global.appConfig.omniauth.providers[].admin_groups | массив строк | [] | Группы, участники которых получают права администратора инстанса. |
global.appConfig.omniauth.providers[].auditor_groups | массив строк | [] | Группы, участники которых получают права аудитора инстанса. |
global.appConfig.omniauth.providers[].groups_attribute | строка | Groups | Имя атрибута SAML, который несёт членство в группах. |
global.appConfig.omniauth.providers[].external_groups | массив строк | — | Группы, участники которых отмечаются как внешние пользователи. |
Сервер LDAP в global.appConfig.ldap.servers.<имя> принимает upstream-поля (host, port, uid, base, bind_dn, password, active_directory и остальные) и блок group_sync, который сопоставляет группы LDAP с группами инстанса. Синхронизация описана в разделе LDAP.
| Ключ | Тип | По умолчанию | Описание |
|---|---|---|---|
global.appConfig.ldap.servers.<имя>.group_sync.create_groups | булево | false | Создаются ли при синхронизации группы, которые есть в LDAP и отсутствуют на инстансе. |
global.appConfig.ldap.servers.<имя>.group_sync.base | строка | — | Базовый DN поиска групп в LDAP. |
global.appConfig.ldap.servers.<имя>.group_sync.filter | строка | — | Фильтр LDAP, который отбирает группы для синхронизации. |
global.appConfig.ldap.servers.<имя>.group_sync.scope | строка или целое число | — | Область поиска групп в LDAP: 0 — базовый объект, 1 — один уровень под ним, 2 — всё поддерево. |
global.appConfig.ldap.servers.<имя>.group_sync.top_level_group | строка | — | Путь группы на инстансе, внутри которой создаются синхронизированные группы. |
global.appConfig.ldap.servers.<имя>.group_sync.name_mask | строка | — | Регулярное выражение, которое применяется к cn группы LDAP и извлекает имя группы на инстансе. |
global.appConfig.ldap.servers.<имя>.group_sync.owner | строка | root | Имя пользователя, который становится владельцем групп, созданных синхронизацией. |
global.appConfig.ldap.servers.<имя>.group_sync.role_mapping[].by_name | строка | — | Регулярное выражение, которое сопоставляется с именем группы LDAP. |
global.appConfig.ldap.servers.<имя>.group_sync.role_mapping[].gitlab_role | строка | — | Роль, которую получают участники совпавшей группы: guest, reporter, developer, maintainer или owner. |
global.appConfig.ldap.servers.<имя>.group_sync.prefix.attribute | строка | — | Атрибут LDAP, значение которого добавляется перед именем группы. |
global.appConfig.ldap.servers.<имя>.group_sync.prefix.default | строка | — | Префикс, который используется при отсутствии атрибута. |
global.appConfig.ldap.servers.<имя>.group_sync.prefix.name_mask | строка | — | Регулярное выражение, которое извлекает префикс из значения атрибута. |
Изменённые значения upstream-чарта по умолчанию
Чарт поставляет перечисленные ниже значения upstream-чарта с другими значениями по умолчанию. Каждая строка называет, чего изменение требует от кластера или файла значений.
| Ключ | В upstream-чарте | В чарте | Следствие |
|---|---|---|---|
global.registry.enabled, registry.enabled | true | false | Хранилище образов контейнеров не разворачивается, и приложение не показывает хранилище образов; чтобы включить его, установите оба значения в true и настройте хранилище, см. раздел Хранилище образов контейнеров. |
global.ingress.class | не задан | nginx | Объекты Ingress адресованы классу nginx; задайте другой класс, если в кластере другой контроллер. |
global.appConfig.object_store.enabled | false | true | Загрузки, артефакты, объекты LFS, пакеты и остальные хранилища находятся в объектном хранилище; требуются подключение через global.codeHelm.externalSecrets.s3 или global.appConfig.object_store.connection и бакет для каждого хранилища. |
global.appConfig.externalDiffs.enabled, global.appConfig.terraformState.enabled, global.appConfig.dependencyProxy.enabled | false | true | Диффам запросов на слияние, состоянию Terraform и прокси зависимостей нужен бакет в global.appConfig.<хранилище>.bucket. |
global.praefect.enabled | false | true | Gitaly работает за Praefect с одним виртуальным хранилищем default, одной репликой Gitaly (global.praefect.virtualStorages[0].gitalyReplicas, в upstream-чарте 3) и одним подом Praefect (gitlab.praefect.replicas, в upstream-чарте 2). Praefect нужна собственная база данных PostgreSQL в global.praefect.psql.host, user и dbName. |
global.praefect.psql.sslMode | disable | prefer | Подключение Praefect использует TLS, если сервер его предлагает. |
global.gitaly.tls.enabled, global.praefect.tls.enabled, global.workhorse.tls.enabled, gitlab.webservice.tls.enabled | false | true | Компоненты ожидают сертификаты из раздела Внутренний TLS; оставьте true, пока global.codeHelm.tls.internal.enabled равен true, и установите false для Istio. |
global.kas.enabled | true | false | Сервер агентов Kubernetes не разворачивается, сертификат <release>-kas-tls не создаётся. |
global.gatewayApi.enabled, global.gatewayApi.installEnvoy | true | false | Чарт публикует инстанс через объекты Ingress; объекты Gateway API и Envoy Gateway не создаются. |
gitlab.gitlab-shell.service.type | LoadBalancer | ClusterIP | SSH публикуется через Балансировщик; меняйте тип только при выключенном балансировщике. |
gitlab.gitlab-shell.sshDaemon | openssh | gitlab-sshd | SSH обслуживает демон gitlab-sshd; он декодирует заголовок PROXY protocol от балансировщика и принимает соединения без заголовка. |
gitlab.gitlab-shell.config.proxyProtocol | false | true | gitlab-sshd ожидает заголовок PROXY protocol от балансировщика; вместе со sshDaemon составляет сторону Git-оболочки для сохранения IP-адреса клиента. Установка завершается ошибкой, если при включённом global.codeHelm.loadbalancer.proxyProtocol значения переопределены на upstream-варианты. |
global.serviceAccount.enabled | false | true | Каждый компонент работает под собственным ServiceAccount <release>-<компонент> вместо default; вызовы TokenReview kube-rbac-proxy выполняются от этих учётных записей. |
gitlab.webservice.workhorse.monitoring.exporter.enabled | false | true | Workhorse отдаёт метрики на порту 9229; к этому порту подключены сайдар kube-rbac-proxy и ServiceMonitor <release>-webservice-workhorse. |
gitlab.gitlab-shell.metrics.enabled | false | true | Git-оболочка отдаёт метрики и проверки состояния на порту 9122; их обеспечивает только демон gitlab-sshd. |
gitlab.gitaly.cgroups.enabled | false | true | Gitaly запускает процессы Git в cgroups: 2 GiB и 150000 единиц квоты CPU для родительской группы, 100 групп репозиториев по 1 GiB и 75000 единиц квоты CPU каждая. Под Gitaly запускает init-контейнер, которому нужен доступ на запись к файловой системе cgroup узла. |
gitlab.toolbox.backups.cron.extraArgs | не задан | --repositories-server-side | Gitaly загружает резервные копии репозиториев в бакет резервных копий напрямую, поэтому бакет должен быть доступен из подов Gitaly. |