Helm-чарт разворачивает Deckhouse Code напрямую в кластере Kubernetes, без модуля Deckhouse Platform. Чарт разворачивает компоненты приложения и, если оно включено, хранилище образов контейнеров; кластер и сервисы ниже существуют до установки релиза.

Helm

Чарт публикуется как OCI-артефакт и устанавливается клиентом командной строки helm. Чарт выводит предупреждение, если клиент старше Helm 4.0, и просит проверить конфигурацию перед обновлением, если клиент старше Helm 3.17, потому что эта версия изменила слияние значений.

Ingress-контроллер

В кластере работает Ingress-контроллер. Чарт создаёт объекты Ingress для веб-интерфейса, хранилища образов контейнеров и, если включён, Pages; они адресованы классу Ingress из global.ingress.class, по умолчанию nginx. Балансировщик, который разворачивает чарт, передаёт HTTP и HTTPS в Service ingress-nginx-controller.ingress-nginx.svc, если global.codeHelm.loadbalancer.ingressService не указывает другой.

Service типа LoadBalancer

Чарт разворачивает балансировщик HAProxy с Service типа LoadBalancer, который принимает HTTP, HTTPS и Git по SSH на одном внешнем адресе. Кластер выдаёт внешние адреса таким Service через облачного провайдера или реализацию вроде MetalLB. Если в кластере её нет, выключите балансировщик значением global.codeHelm.loadbalancer.enabled: false и откройте SSH через gitlab.gitlab-shell.service.type, как описано в разделе «Балансировщик».

cert-manager

В кластере работает cert-manager с API cert-manager.io/v1. Чарт использует его в двух местах:

  • для сертификатов Ingress, которые подписывает ClusterIssuer из global.codeHelm.ingress.tls.clusterIssuer (по умолчанию letsencrypt); ClusterIssuer существует до установки, либо global.codeHelm.ingress.tls.mode установлен в manual, а сертификаты переданы как Secret;
  • для внутренних сертификатов между компонентами, которые подписывает самоподписанный Issuer, создаваемый чартом.

StorageClass для Git-репозиториев

Каждый под Gitaly монтирует PersistentVolumeClaim для Git-репозиториев из StorageClass по умолчанию или из класса, указанного в gitlab.gitaly.persistence.storageClass. Чарт рекомендует 50Gi в gitlab.gitaly.persistence.size и принимает 1Gi как минимальное значение. Том растёт вместе с репозиториями, поэтому задайте нужный им размер.

PostgreSQL

Внешний сервер PostgreSQL версии 17 или новее, доступный из кластера, с заранее созданными базами данных и ролями из таблицы ниже. Чарт не разворачивает PostgreSQL.

База данныхЗначенияКто использует
База данных приложенияglobal.psql.host, global.psql.database, global.psql.usernameВеб-сервис, Sidekiq, задача миграций и toolbox.
База данных Praefectglobal.praefect.psql.host, global.praefect.psql.dbName, global.praefect.psql.userPraefect, который направляет Git-трафик в Gitaly. Praefect включён по умолчанию, поэтому эта база данных обязательна.
База метаданных хранилища образовregistry.database.host, registry.database.dbname, registry.database.userХранилище образов контейнеров, только при registry.database.enabled: true.

Redis

Внешний сервер Redis, доступный из кластера и указанный в global.redis.host и global.redis.port, хранит очереди фоновых задач, кеш и сессии. Чарт не разворачивает Redis.

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

S3-совместимое объектное хранилище с отдельным бакетом для каждого хранилища данных. Объектное хранилище включено по умолчанию, и заменить его локальными томами нельзя; чарт не разворачивает хранилище. Бакеты и их значения:

БакетЗначениеИмя по умолчанию
Объекты Git LFSglobal.appConfig.lfs.bucketgit-lfs
Артефакты CI/CDglobal.appConfig.artifacts.bucketgitlab-artifacts
Загруженные файлыglobal.appConfig.uploads.bucketgitlab-uploads
Пакетыglobal.appConfig.packages.bucketgitlab-packages
Диффы запросов на слияниеglobal.appConfig.externalDiffs.bucketgitlab-mr-diffs
Состояние Terraformglobal.appConfig.terraformState.bucketgitlab-terraform-state
Защищённые файлы CI/CDglobal.appConfig.ciSecureFiles.bucketgitlab-ci-secure-files
Содержимое планов агентаglobal.appConfig.agentPlanContent.bucketgitlab-agent-plan-content
Архивы каталога CI/CDglobal.appConfig.ciCatalogBundles.bucketgitlab-ci-catalog-bundles
Прокси зависимостейglobal.appConfig.dependencyProxy.bucketgitlab-dependency-proxy
Архивы резервных копийglobal.appConfig.backups.bucketgitlab-backups
Временные файлы резервного копированияglobal.appConfig.backups.tmpBuckettmp
Хранилище образов контейнеровglobal.codeHelm.externalSecrets.registry.storage.s3.bucket, если хранилище образов включено—
Содержимое Pagesglobal.pages.objectStore.bucket, если Pages включёнgitlab-pages

Точка доступа хранилища и ключи доступа записываются в global.codeHelm.externalSecrets.s3, global.codeHelm.externalSecrets.backup и global.codeHelm.externalSecrets.registry.storage.s3, как описано в разделе «Secret из значений».

Доступ к хранилищу образов

Кластер загружает образы компонентов из хранилища образов Deckhouse Code. Учётные данные записываются в global.codeHelm.externalSecrets.registryDockerConfig как .dockerconfigjson в кодировке Base64; чарт превращает их в Secret для загрузки образов каждого пода.

DNS-имена

Веб-интерфейс отвечает по имени global.hosts.gitlab.name. Хранилище образов и Pages, если они включены, отвечают по именам global.hosts.registry.name и global.hosts.pages.name. Незаданное имя выводится из global.hosts.domain как gitlab.<домен>, registry.<домен> и pages.<домен>. Имена разрешаются во внешний адрес Service балансировщика или в адрес Ingress-контроллера, если балансировщик выключен; адрес становится известен после установки, описанной в разделе «Быстрый старт».

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