Перед началом выполните проверки из раздела Требования. Шаги ниже устанавливают Deckhouse Code как релиз code в неймспейсе code с веб-интерфейсом по адресу code.example.com. Хранилище образов контейнеров по умолчанию выключено; как его включить, описано в разделе Хранилище образов контейнеров.

Вход в реестр чартов

Чарт публикуется как OCI-артефакт. <CHART_REGISTRY> — адрес реестра, <CHART_VERSION> — версия чарта; оба значения передаются вместе с продуктом и учётными данными реестра. Войдите в реестр:

helm registry login <CHART_REGISTRY>

Подготовка файла значений

Создайте файл values.yaml с именами хостов, классом Ingress, подключениями к PostgreSQL, Redis и объектному хранилищу, именами бакетов и StorageClass для Git-репозиториев. Чарт создаёт Secret с паролями и ключами из блока global.codeHelm.externalSecrets, поэтому вручную Secret не создаются:

global:
  hosts:
    domain: example.com
    gitlab:
      name: code.example.com
  ingress:
    class: nginx
  psql:
    host: <POSTGRESQL_HOST>
    port: 5432
    database: <POSTGRESQL_DATABASE>
    username: <POSTGRESQL_USERNAME>
  praefect:
    psql:
      host: <POSTGRESQL_HOST>
      user: <PRAEFECT_USERNAME>
      dbName: <PRAEFECT_DATABASE>
  redis:
    host: <REDIS_HOST>
    port: 6379
  appConfig:
    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>
  codeHelm:
    ingress:
      tls:
        clusterIssuer: <CLUSTER_ISSUER_NAME>
    externalSecrets:
      enabled: true
      psqlPassword: <POSTGRESQL_PASSWORD>
      praefectPassword: <PRAEFECT_PASSWORD>
      redisPassword: <REDIS_PASSWORD>
      s3:
        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>
      backup:
        aws_access_key_id: <S3_ACCESS_KEY_ID>
        aws_secret_access_key: <S3_SECRET_ACCESS_KEY>
      registryDockerConfig: <BASE64_DOCKERCONFIGJSON>
    backup:
      region: <S3_REGION>
      endpoint: <S3_ENDPOINT_URL>
gitlab:
  gitaly:
    persistence:
      size: 50Gi
      storageClass: <STORAGE_CLASS_NAME>

Замените каждый плейсхолдер в угловых скобках. <S3_ENDPOINT_URL> — URL хранилища со схемой, например https://storage.example.com. <BASE64_DOCKERCONFIGJSON> — файл учётных данных хранилища образов, закодированный командой base64 -w0. Бакеты существуют в хранилище до установки. Раздел Настройка объясняет каждое показанное здесь значение, раздел Расширенная настройка перечисляет остальные.

Установка релиза

helm upgrade --install code oci://<CHART_REGISTRY>/code \
  --version <CHART_VERSION> \
  -n code --create-namespace \
  -f values.yaml

Команда создаёт неймспейс code, если его нет, и устанавливает релиз code. Чарт проверяет значения до создания объектов; если проверка не пройдена, команда выводит причину и завершается без установки. Сообщения перечислены в разделе Диагностика.

Настройка DNS на балансировщик

Релиз публикует HTTP, HTTPS и Git по SSH через один Service типа LoadBalancer. Получите его внешний адрес:

d8 k -n code get service code-code-loadbalancer

Создайте DNS-запись для code.example.com, указывающую на адрес из колонки EXTERNAL-IP. Git-клиенты подключаются по SSH к порту 22 того же адреса.

Ожидание готовности релиза

Задача миграций выполняется один раз и подготавливает схему базы данных; поды веб-сервиса и Sidekiq ждут её завершения. Убедитесь, что задача завершена, а все поды в состоянии Running:

d8 k -n code get jobs,pods

Сертификаты Ingress выпускает cert-manager после установки. Убедитесь, что у каждого Certificate в колонке READY значение True:

d8 k -n code get certificate

Первый вход

Чарт генерирует начальный пароль учётной записи root в Secret code-initial-root-password. Прочитайте его:

d8 k -n code get secret code-initial-root-password -o jsonpath='{.data.password}' | base64 -d

Откройте https://code.example.com и войдите как root с этим паролем. После первого входа смените пароль в настройках учётной записи.

Проверка установки

Создайте проект в веб-интерфейсе, затем клонируйте его по HTTPS и по SSH, чтобы убедиться, что оба пути через балансировщик работают:

git clone https://code.example.com/root/<PROJECT>.git
git clone git@code.example.com:root/<PROJECT>.git

Для клонирования по SSH добавьте открытый ключ своей учётной записи в настройках пользователя.

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