Чарт 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:9000URL точки доступа хранилища резервных копий. Схема выбирает транспорт: 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.svcDNS-имя 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.enabledtruefalseХранилище образов контейнеров не разворачивается, и приложение не показывает хранилище образов; чтобы включить его, установите оба значения в true и настройте хранилище, см. раздел Хранилище образов контейнеров.
global.ingress.classне заданnginxОбъекты Ingress адресованы классу nginx; задайте другой класс, если в кластере другой контроллер.
global.appConfig.object_store.enabledfalsetrueЗагрузки, артефакты, объекты LFS, пакеты и остальные хранилища находятся в объектном хранилище; требуются подключение через global.codeHelm.externalSecrets.s3 или global.appConfig.object_store.connection и бакет для каждого хранилища.
global.appConfig.externalDiffs.enabled, global.appConfig.terraformState.enabled, global.appConfig.dependencyProxy.enabledfalsetrueДиффам запросов на слияние, состоянию Terraform и прокси зависимостей нужен бакет в global.appConfig.<хранилище>.bucket.
global.praefect.enabledfalsetrueGitaly работает за 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.sslModedisablepreferПодключение Praefect использует TLS, если сервер его предлагает.
global.gitaly.tls.enabled, global.praefect.tls.enabled, global.workhorse.tls.enabled, gitlab.webservice.tls.enabledfalsetrueКомпоненты ожидают сертификаты из раздела Внутренний TLS; оставьте true, пока global.codeHelm.tls.internal.enabled равен true, и установите false для Istio.
global.kas.enabledtruefalseСервер агентов Kubernetes не разворачивается, сертификат <release>-kas-tls не создаётся.
global.gatewayApi.enabled, global.gatewayApi.installEnvoytruefalseЧарт публикует инстанс через объекты Ingress; объекты Gateway API и Envoy Gateway не создаются.
gitlab.gitlab-shell.service.typeLoadBalancerClusterIPSSH публикуется через Балансировщик; меняйте тип только при выключенном балансировщике.
gitlab.gitlab-shell.sshDaemonopensshgitlab-sshdSSH обслуживает демон gitlab-sshd; он декодирует заголовок PROXY protocol от балансировщика и принимает соединения без заголовка.
gitlab.gitlab-shell.config.proxyProtocolfalsetruegitlab-sshd ожидает заголовок PROXY protocol от балансировщика; вместе со sshDaemon составляет сторону Git-оболочки для сохранения IP-адреса клиента. Установка завершается ошибкой, если при включённом global.codeHelm.loadbalancer.proxyProtocol значения переопределены на upstream-варианты.
global.serviceAccount.enabledfalsetrueКаждый компонент работает под собственным ServiceAccount <release>-<компонент> вместо default; вызовы TokenReview kube-rbac-proxy выполняются от этих учётных записей.
gitlab.webservice.workhorse.monitoring.exporter.enabledfalsetrueWorkhorse отдаёт метрики на порту 9229; к этому порту подключены сайдар kube-rbac-proxy и ServiceMonitor <release>-webservice-workhorse.
gitlab.gitlab-shell.metrics.enabledfalsetrueGit-оболочка отдаёт метрики и проверки состояния на порту 9122; их обеспечивает только демон gitlab-sshd.
gitlab.gitaly.cgroups.enabledfalsetrueGitaly запускает процессы Git в cgroups: 2 GiB и 150000 единиц квоты CPU для родительской группы, 100 групп репозиториев по 1 GiB и 75000 единиц квоты CPU каждая. Под Gitaly запускает init-контейнер, которому нужен доступ на запись к файловой системе cgroup узла.
gitlab.toolbox.backups.cron.extraArgsне задан--repositories-server-sideGitaly загружает резервные копии репозиториев в бакет резервных копий напрямую, поэтому бакет должен быть доступен из подов Gitaly.

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