Перед началом выполните проверки из раздела Требования. Шаги ниже устанавливают 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 добавьте открытый ключ своей учётной записи в настройках пользователя.