Что получится
Пайплайн из трёх стадий — build, scan, deploy: каждый коммит в main собирается на вашем раннере, образ с тегом коммита проверяется Trivy и уходит в кластер, только если в нём нет критических уязвимостей. В CI нет kubeconfig администратора — только токен с правами на namespace app.
Что понадобится
- Проект в GitLab (gitlab.com или свой GitLab) с правом Maintainer — чтобы добавить раннер и переменные CI/CD.
- Кластер Managed Kubernetes в статусе «Готов» и реестр Container Registry — например,
demoиз сценария «Приложение из своего реестра образов». - SSH-ключ, добавленный в консоль, — как в сценарии «Сайт на облачном сервере».
-
Шаг 1. Создайте логин реестра для CI
Заведите для пайплайна отдельный логин с правом записи, не тот, что у вас на ноутбуке. Его можно будет отозвать, не трогая остальные логины.
Консоль
- Container Registry → реестр
demo→ вкладка Доступ → Создать логин. - Название —
gitlab-ci, Доступ — «Запись и чтение». Нажмите Создать и сохраните «Логин» и «Пароль» из окна «Логин создан»: пароль показывается один раз. - На вкладке Обзор скопируйте «Адрес» реестра — вида
cr.h3llo.cloud/<префикс>-demo.
CLI
Терминалh3 registry list # ID реестра demo h3 registry credential create <registry id> --name gitlab-ci --access rw -o json h3 registry get <registry id> # адрес реестраПроверка
Логин
gitlab-ciпоявился на вкладке «Доступ» с правами «Запись и чтение». - Container Registry → реестр
-
Шаг 2. Включите проверку образов при загрузке
Реестр умеет сам проверять каждый загруженный образ сканером Trivy. Это не блокирует загрузку, зато результат виден для любого тега. Блокировку сделаем в пайплайне на следующих шагах.
CLI
Терминалh3 api PUT /api/registries/v1/<registry id>/settings/scanning -d '{"scanOnPush": true}' h3 api GET /api/registries/v1/<registry id>/settingsПроверка
В ответе
settingsв блокеscanning—"available": trueи"scanOnPush": true.Если не получилось
SCANNER_UNAVAILABLE— сканер реестра временно недоступен. Пайплайн ниже всё равно проверит образ своим Trivy.
-
Шаг 3. Создайте сервер для раннера
Раннеру нужен Docker, поэтому берём обычный сервер, а не кластер: сборка с
docker:dindтребует привилегированного режима, которого в подах кластера лучше не давать. Входящий трафик раннеру не нужен: он сам ходит в GitLab, поэтому открываем только SSH.Консоль
- Группы безопасности → Создать: Имя
ssh-only→ Создать → Разрешить входящий → SSH 22. - Инстансы → Создать: ОС Ubuntu 24.04 LTS, vCPU 2, RAM 4 ГБ, Диски 40 ГБ, Класс производительности «R-Стандарт», Имя виртуальной машины
gitlab-runner, SSH-ключи — ваш ключ, Публичный IPv4 «Вкл.» с «Выделить новый IP», Группы безопасности — толькоssh-only. - Нажмите Собрать и запустить.
CLI
Терминалh3 ssh list # ID вашего SSH-ключа h3 vm create --name gitlab-runner --image ubuntu:24.04 --cpu 2 --memory 4Gi \ --disk-size 40Gi --ssh-key-ids <key id> --white-ipTerraform
runner.tfresource "h3_security_group" "ssh_only" { project_id = var.project_id name = "ssh-only" rule { direction = "ingress" protocol = "tcp" port_from = 22 remote_cidr = "0.0.0.0/0" } rule { direction = "egress" remote_cidr = "0.0.0.0/0" } } resource "h3_vm" "runner" { project_id = var.project_id name = "gitlab-runner" cpu = 2 memory = "4Gi" image = "ubuntu:24.04" disk_size = "40Gi" ssh_key = trimspace(var.ssh_public_key) white_ip = true } resource "h3_vm_security_groups" "runner" { vm_id = h3_vm.runner.id security_group_ids = [h3_security_group.ssh_only.id] }Проверка
Сервер
gitlab-runnerв статусе «Работает», в карточке есть «SSH подключение» с командойssh user@<IP>. - Группы безопасности → Создать: Имя
-
Шаг 4. Установите Docker и зарегистрируйте раннер
GitLab
- В проекте GitLab откройте Settings → CI/CD → Runners и нажмите New project runner.
- Отметьте Run untagged jobs и нажмите Create runner. Скопируйте токен вида
glrt-…— он показывается один раз.
На сервере раннераsudo apt update && sudo apt install -y docker.io curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash sudo apt install -y gitlab-runner sudo gitlab-runner register --non-interactive \ --url "https://gitlab.com" \ --token "glrt-<токен>" \ --executor docker \ --docker-image docker:27 \ --docker-privileged sudo gitlab-runner verifyПроверка
gitlab-runner verifyпечатаетis valid, а в GitLab на странице Runners раннер отмечен зелёной точкой — онлайн.Если не получилось
- Свой GitLab — замените
https://gitlab.comна его адрес. --docker-privilegedнужен для сборки черезdocker:dind. Раннер с этим флагом не отдавайте чужим проектам: задача получает root на сервере.
-
Шаг 5. Дайте пайплайну доступ только к своему namespace
kubeconfig из консоли — администратор всего кластера, в CI его класть не нужно. Создадим namespace
app, service accountgitlab-deployerс рольюeditтолько в нём и соберём из его токена отдельный kubeconfig. Заодно подключим реестр кapp, чтобы поды тянули образы безimagePullSecrets.Консоль
- Container Registry →
demo→ «Кластеры» → Подключить к кластеру: Кластерdemo, Namespaceapp, Service accountsdefault→ Подключить.
На вашем компьютере (с kubeconfig администратора)export KUBECONFIG=~/Downloads/demo_kubeconfig.yaml kubectl create namespace app kubectl -n app create serviceaccount gitlab-deployer kubectl -n app create rolebinding gitlab-deployer --clusterrole=edit --serviceaccount=app:gitlab-deployer kubectl -n app apply -f - <<'EOF' apiVersion: v1 kind: Secret metadata: name: gitlab-deployer-token annotations: kubernetes.io/service-account.name: gitlab-deployer type: kubernetes.io/service-account-token EOF SERVER=$(kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}') CA=$(kubectl config view --raw --minify -o jsonpath='{.clusters[0].cluster.certificate-authority-data}') TOKEN=$(kubectl -n app get secret gitlab-deployer-token -o jsonpath='{.data.token}' | base64 -d) cat > ci-kubeconfig.yaml <<EOF apiVersion: v1 kind: Config clusters: - name: demo cluster: {server: ${SERVER}, certificate-authority-data: ${CA}} users: - name: gitlab-deployer user: {token: ${TOKEN}} contexts: - name: app context: {cluster: demo, user: gitlab-deployer, namespace: app} current-context: app EOFПроверка
Токен видит свой namespace и не видит чужие:
ТерминалKUBECONFIG=ci-kubeconfig.yaml kubectl get pods # No resources found in app namespace. KUBECONFIG=ci-kubeconfig.yaml kubectl get pods -n kube-system # Forbidden - Container Registry →
-
Шаг 6. Добавьте переменные CI/CD
GitLab
- Settings → CI/CD → Variables → Add variable, для каждой отметьте Protect variable:
CR_ADDRESS— адрес реестра;CR_USER— логинgitlab-ci(со знаком$внутри — вводите как есть);CR_PASSWORD— пароль, Visibility «Masked».KUBECONFIG— Type «File», значение — содержимоеci-kubeconfig.yaml. GitLab сам положит его в файл и передаст путь в переменной.
После добавления удалите локальную копиюrm ci-kubeconfig.yamlЕсли не получилось
- Переменные с Protect variable доступны только в защищённых ветках. Пайплайн из другой ветки упадёт на
docker login. Так и задумано: выкатывать можно только изmain.
-
Шаг 7. Опишите пайплайн
Положите в репозиторий приложения
Dockerfile, манифестk8s/app.yamlи.gitlab-ci.yml. В манифесте вместо адреса образа стоит меткаIMAGE— пайплайн подставит туда тег коммита.k8s/app.yamlapiVersion: apps/v1 kind: Deployment metadata: name: app spec: replicas: 2 selector: matchLabels: {app: app} template: metadata: labels: {app: app} spec: containers: - name: web image: IMAGE ports: - containerPort: 80 --- apiVersion: v1 kind: Service metadata: name: app spec: type: LoadBalancer selector: {app: app} ports: - port: 80 targetPort: 80.gitlab-ci.ymlstages: [build, scan, deploy] variables: IMAGE: "$CR_ADDRESS/app:$CI_COMMIT_SHORT_SHA" build: stage: build image: docker:27 services: [docker:27-dind] variables: DOCKER_HOST: tcp://docker:2375 DOCKER_TLS_CERTDIR: "" script: - echo "$CR_PASSWORD" | docker login cr.h3llo.cloud -u "$CR_USER" --password-stdin # узлы кластера — x86-64 - docker build --platform linux/amd64 -t "$IMAGE" . - docker push "$IMAGE" rules: - if: $CI_COMMIT_BRANCH == "main" scan: stage: scan image: name: aquasec/trivy:latest # в боевом пайплайне закрепите версию entrypoint: [""] variables: TRIVY_USERNAME: "$CR_USER" TRIVY_PASSWORD: "$CR_PASSWORD" script: # падаем, если есть критические уязвимости, для которых уже вышло исправление - trivy image --no-progress --exit-code 1 --severity CRITICAL --ignore-unfixed "$IMAGE" rules: - if: $CI_COMMIT_BRANCH == "main" deploy: stage: deploy image: alpine:3.22 script: - apk add --no-cache curl - curl -fsSLo /usr/local/bin/kubectl "https://dl.k8s.io/release/$(curl -fsSL https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" - chmod +x /usr/local/bin/kubectl - sed "s|IMAGE|$IMAGE|" k8s/app.yaml | kubectl apply -f - - kubectl rollout status deployment/app --timeout=180s rules: - if: $CI_COMMIT_BRANCH == "main" environment: productionКоммитgit add Dockerfile k8s/app.yaml .gitlab-ci.yml git commit -m "ci: build, scan, deploy to h3llo.cloud" && git pushПроверка
В Build → Pipelines три зелёные стадии. В реестре на вкладке Репозитории появился репозиторий
appс тегом короткого хеша коммита, в кластере — две реплики:Терминалkubectl -n app get deployment app -o jsonpath='{.spec.template.spec.containers[0].image}'; echo kubectl -n app get service app # EXTERNAL-IP — публичный адрес приложенияЕсли не получилось
- Стадия
scanкрасная — Trivy нашёл критическую уязвимость с исправлением. В логе есть пакет и версия, где её закрыли: обновите базовый образ (FROM) или пакет и закоммитьте снова. deployпадает сforbidden— в манифесте ресурс не из namespaceappили кластерный объект: у ролиeditправ только на свой namespace.Unable to connect to the serverвdeploy— доступ к API кластера ограничен списком адресов. Добавьте в список публичный IP сервера раннера.
- Стадия
Проверка результата
Сделайте любую правку, например текст страницы в Dockerfile, и закоммитьте в main. Через пару минут приложение отвечает новой версией, а тег образа в кластере равен короткому хешу последнего коммита. Результат проверки реестром виден по digest образа:
curl http://<EXTERNAL-IP>
h3 registry tag list <registry id> --repository app
h3 api GET /api/registries/v1/<registry id>/artifacts/scan -f repository=app -f digest=<sha256:…> Как удалить ресурсы
Сервер раннера, его IP и сервис LoadBalancer оплачиваются, пока существуют.
kubectl delete namespace app— удалит приложение, его балансировщик с публичным IP, service account и токен CI.- В GitLab: Settings → CI/CD → Runners → удалите раннер; Variables → удалите
KUBECONFIG,CR_ADDRESS,CR_USER,CR_PASSWORD. - Инстансы →
gitlab-runner→ меню «…» → Удалить, отметьте «Освободить IP-адрес (иначе он останется в проекте)» → Подтвердить. Затем Группы безопасности →ssh-only→ Удалить группу. - Container Registry →
demo→ Доступ → удалите логинgitlab-ci. Старые тегиappудаляйте командойh3 registry tag deleteили правилами хранения тегов.
Типичные ошибки
Почему не держать раннер прямо в кластере?
Можно, но сборка через `docker:dind` требует привилегированных подов, а это root на узле кластера с вашими приложениями. Отдельный сервер изолирует сборки и стоит предсказуемо; за выключенный сервер vCPU и RAM не оплачиваются.
Раннеру не хватает ресурсов на большие сборки
Увеличьте сервер: меню сервера → «Изменить размер». В пределах четырёхкратного запаса Linux-сервер получает vCPU и RAM без перезагрузки, поэтому раннер не придётся останавливать.
Можно ли не выпускать в кластер образы, которые не прошли проверку?
Да, этим и занимается стадия `scan`: `deploy` запускается только после её успеха. Порог настраивается флагом `--severity` (например, `HIGH,CRITICAL`).
Нужен kubeconfig администратора в CI для CRD и namespace
Лучше выдать service account кластерную роль только на нужные ресурсы через ClusterRole и ClusterRoleBinding. kubeconfig администратора даёт полный доступ и выдаётся только участникам проекта с правом изменять ресурсы.
Связанные продукты и материалы
- Сценарий · 40 минПриложение в Managed Kubernetes из своего реестра образов
- Статья · 2 минContainer Registry в h3llo.cloud: приватный реестр образов
- Сценарий · 45 минСайт на облачном сервере: публичный IP, домен и HTTPS
- Сценарий · 35 минManaged PostgreSQL для приложения: пользователь, pgvector и восстановление на момент времени
- ПродуктKubernetes
- ПродуктContainer Registry
- ПродуктСерверы
Сколько стоит
≈ 5,44 ₽ в час · 3 914,60 ₽ в месяц при работе 24/7
| Сервер раннера: vCPU | 2 × 900 ₽ |
| Сервер раннера: RAM, ГБ | 4 × 360 ₽ |
| Диск раннера до 20 000 IOPS*, ГБ | 40 × 14,40 ₽ |
| Публичный IPv4 раннера | 1 × 90 ₽ |
| Реестр: занятое место, ГБ | 2 × 4,30 ₽ |
Кластер считается отдельно — см. сценарий с реестром; сервис LoadBalancer приложения добавляет ещё один публичный IPv4. Исходящий трафик сервера не тарифицируется. Реестр берёт деньги за занятое место и за скачивание образов по тарифу Container Registry.
Цены из прайс-листа, по которому работает биллинг; списание поминутное, месяц — 720 часов. Если удалить ресурсы после проверки, сценарий обойдётся в рубли.
Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.