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. |
| База данных Praefect | global.praefect.psql.host, global.praefect.psql.dbName, global.praefect.psql.user | Praefect, который направляет 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 LFS | global.appConfig.lfs.bucket | git-lfs |
| Артефакты CI/CD | global.appConfig.artifacts.bucket | gitlab-artifacts |
| Загруженные файлы | global.appConfig.uploads.bucket | gitlab-uploads |
| Пакеты | global.appConfig.packages.bucket | gitlab-packages |
| Диффы запросов на слияние | global.appConfig.externalDiffs.bucket | gitlab-mr-diffs |
| Состояние Terraform | global.appConfig.terraformState.bucket | gitlab-terraform-state |
| Защищённые файлы CI/CD | global.appConfig.ciSecureFiles.bucket | gitlab-ci-secure-files |
| Содержимое планов агента | global.appConfig.agentPlanContent.bucket | gitlab-agent-plan-content |
| Архивы каталога CI/CD | global.appConfig.ciCatalogBundles.bucket | gitlab-ci-catalog-bundles |
| Прокси зависимостей | global.appConfig.dependencyProxy.bucket | gitlab-dependency-proxy |
| Архивы резервных копий | global.appConfig.backups.bucket | gitlab-backups |
| Временные файлы резервного копирования | global.appConfig.backups.tmpBucket | tmp |
| Хранилище образов контейнеров | global.codeHelm.externalSecrets.registry.storage.s3.bucket, если хранилище образов включено | — |
| Содержимое Pages | global.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-контроллера, если балансировщик выключен; адрес становится известен после установки, описанной в разделе «Быстрый старт».