Provision
—— XP

Практика: выкат на стенд по кнопке

практика~50 минут+525 XP

Образ лежит в реестре, но на стенде всё ещё крутится старая версия из раздела 08. Сейчас ты научишь конвейер ставить новую: по кнопке, через SSH, с проверкой, что сайт ответил.

Выкат будет делать короткий скрипт на стенде, а конвейер — только заходить и запускать его. Так скрипт можно запустить и руками, если GitLab лёг, а это бывает.

Шаг 1. Ключ для конвейера

Конвейеру нужен свой SSH-ключ — не твой личный. Сгенерируем его, как в разделе 03: -t — тип ключа, -N '' — без пароля (иначе конвейер застрянет на вопросе), -f — имя файла.

ubuntu@stand:~$
ssh-keygen -t ed25519 -N '' -f ~/.ssh/gitlab_deploy
ubuntu@stand:~$
Your identification has been saved in /home/anton/.ssh/gitlab_deploy
Your public key has been saved in /home/anton/.ssh/gitlab_deploy.pub

Шаг 2. Пустить ключ на стенд

Открытую половину ключа дописываем в список разрешённых. >> дописывает в конец файла, не затирая.

ubuntu@stand:~$
cat ~/.ssh/gitlab_deploy.pub >> ~/.ssh/authorized_keys

Проверим вход новым ключом. Флаг -i у ssh — какой ключ взять; удалённая команда hostname просто напечатает имя машины.

ubuntu@stand:~$
ssh -i ~/.ssh/gitlab_deploy 192.168.1.50 hostname
ubuntu@stand:~$
stand

Имя напечаталось без вопроса о пароле — ключ работает. На рабочем сервере для конвейера заводят отдельного пользователя с минимумом прав; на стенде обойдёмся своим.

Шаг 3. Переменная с ключом

Закрытую половину ключа отдаём GitLab. Выведи её на экран и скопируй целиком, от -----BEGIN до -----END ... KEY-----.

ubuntu@stand:~$
cat ~/.ssh/gitlab_deploy
ubuntu@stand:~$
-----BEGIN OPENSSH PRIVATE KEY-----
b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW
...
-----END OPENSSH PRIVATE KEY-----

В проекте: Settings → CI/CD → Variables → Add variable. Заполни так:

Переменная SSH_KEY
Type
File — GitLab положит ключ во временный файл, а в переменную запишет путь к нему.
Visibility
Visible: многострочное значение замаскировать нельзя. Поэтому его никогда не печатают.
Flags
Protect variable — ключ получат только задачи защищённой ветки main.
Key
SSH_KEY
Value
Вставленный ключ. После последней строки обязательно нажми Enter: без перевода строки ssh не прочитает ключ.

Шаг 4. Переменная с адресом

Вторая переменная — куда заходить. Она не секретная, но хранить её в настройках удобно: сменил адрес — конвейер выкатывает на другую машину.

Снова Add variable: Type — Variable, Visibility — Visible, Key — STAND, Value — anton@192.168.1.50 (твой пользователь и адрес стенда). Флаг Protect можно поставить — выкат всё равно идёт только из main.

Шаг 5. Отпечаток стенда

Когда ты первый раз заходил по SSH на новую машину, ssh спрашивал: «The authenticity of host … can't be established. Are you sure?» — и запоминал её отпечаток (публичный ключ сервера) в ~/.ssh/known_hosts. Так ssh защищает от подмены: если однажды по тому же адресу ответит другая машина, он откажется входить.

У контейнера задачи known_hosts пустой, а ответить «yes» некому. Поэтому отпечаток стенда снимаем один раз сами и отдаём конвейеру. ssh-keyscan спрашивает у сервера его ключ, флаг -t ed25519 — только ключ этого типа.

ubuntu@stand:~$
ssh-keyscan -t ed25519 192.168.1.50
ubuntu@stand:~$
# 192.168.1.50:22 SSH-2.0-OpenSSH_9.6p1 Ubuntu-3ubuntu13.5
192.168.1.50 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHk2...

Первая строка с # — просто комментарий о версии сервера. Нужна вторая: адрес, тип ключа и сам ключ. Это готовая строка файла known_hosts.

Заведи переменную: Add variable, Type — File, Key — SSH_KNOWN_HOSTS, Value — вторая строка целиком с переводом строки в конце, флаг Protect variable. Секрета в ней нет, но защищённость не помешает.

В старых статьях вместо этого шага пишут -o StrictHostKeyChecking=no — «входи куда угодно, не проверяя». Это плохая привычка: конвейер с ключом от сервера отдаст его любому, кто встанет на этот адрес. Проверку не выключают, а дают ей правильный отпечаток.

Шаг 6. Скрипт выката: начало

Теперь скрипт, который конвейер будет запускать. Он ляжет в каталог scripts рядом с check-stand.sh из практики про первый конвейер, и задача shellcheck начнёт проверять и его. Скрипт принимает полное имя образа с тегом и ничего не собирает: собирает конвейер, а скрипт только ставит. Адрес реестра в скрипт не зашит — его передаёт конвейер из встроенной переменной CI_REGISTRY_IMAGE. Переедет реестр или стенд — скрипт менять не придётся.

nano ~/infra/scripts/deploy.sh
#!/bin/bash
# Выкат приложения на стенд: ./deploy.sh <образ:тег>
set -euo pipefail
IMAGE="${1:?нужен образ с тегом}"
cd ~/infra/stand

set -euo pipefail из раздела 03 роняет скрипт на первой ошибке. ${1:?…} — первый аргумент, а если его нет, скрипт остановится с этим текстом.

Шаг 7. Скрипт выката: замена образа

Самый короткий выкат — показать текущую версию, подменить её в .env, скачать новый образ и поднять приложение.

дописать в deploy.sh
grep '^APP_IMAGE=' .env
sed -i "s|^APP_IMAGE=.*|APP_IMAGE=$IMAGE|" .env
docker compose pull app
docker compose up -d --no-deps app

grep печатает прежнюю версию — она останется в журнале выката, и ты всегда увидишь, откуда уехал. sed -i правит строку на месте. --no-deps трогает только app, не перезапуская базу и прокси. Проверим руками: сделай скрипт исполняемым, положи в переменную оболочки имя образа — тег возьми свой, из Deploy → Container registry, его собрал конвейер в практике 11, — и запусти.

ubuntu@stand:~$
chmod +x ~/infra/scripts/deploy.sh
ubuntu@stand:~$
IMG=192.168.1.50:5050/devops/infra/app:a2f5d81b
ubuntu@stand:~$
~/infra/scripts/deploy.sh $IMG
ubuntu@stand:~$
APP_IMAGE=localhost:5000/provision/app:1.0.0
error from registry: unauthorized: HTTP Basic: Access denied

Шаг 8. Токен, которым стенд скачивает образы

Реестр закрытого проекта не отдаёт образ анонимно. Конвейеру GitLab выдаёт временный вход сам, а стенду нужна своя учётка. Заводим токен развёртывания с единственным правом — скачивать.

В проекте devops/infra: Settings → Repository → Deploy tokens → Add token. Имя — stand-pull, срок можно не задавать, галочка только одна — read_registry. Нажми Create deploy token. GitLab покажет имя пользователя (stand-pull) и сам токен, начинающийся с gldt-. Токен показывается один раз — скопируй его сейчас.

Входим в реестр под этим токеном. Флаг -u у docker login — имя пользователя, пароль программа спросит сама: вставь токен.

ubuntu@stand:~$
docker login -u stand-pull 192.168.1.50:5050
ubuntu@stand:~$
Password:
Login Succeeded

Docker запомнил вход в файле ~/.docker/config.json — этим входом скрипт будет скачивать образы. Пароль root здесь не вводи: он осел бы в том же файле, а с ним можно всё. Запусти скрипт ещё раз той же командой — pull пройдёт, и в конце будет Container provision-app-1 Started.

Шаг 9. Дождаться здоровья

Started значит только «контейнер запущен». Выкати нарочно сломанный образ — например, собранный с опечаткой в CMD, — и скрипт всё равно закончится успехом, с кодом 0, хотя приложение упадёт через секунду. В прогоне для этого урока так и было:

после выката сломанного образа
docker compose ps -a app
app   Exited (3) 7 seconds ago

Конвейер счёл бы такой выкат удачным. Флаг --wait ждёт, пока app станет healthy, и падает, если не дождался. Замени последнюю строку скрипта:

в deploy.sh, последняя строка
docker compose up -d --no-deps --wait app

С ним тот же сломанный образ даёт container provision-app-1 exited (3) и код 1 — set -e остановит скрипт, а конвейер покраснеет.

Шаг 10. Сначала миграции

Новая версия кода может ждать новую схему базы. Поэтому перед приложением — миграции, тот же порядок, что цепочка migrate → app из раздела 08. Вставь строку перед up:

в deploy.sh, перед строкой up
docker compose run --rm migrate

run --rm migrate выполняет сервис миграций один раз и удаляет его контейнер. Упадёт миграция — set -e остановит скрипт, и приложение со старой схемой не перезапустится. Миграции пишут так, чтобы старая версия кода тоже работала с новой схемой: добавить колонку можно сразу, а удалить — только релизом позже. Тогда откат образа кнопкой не упрётся в базу: откат образа схему назад не возвращает.

Шаг 11. Проверка снаружи

healthy — это мнение контейнера о себе. Последний кусок проверяет сайт так, как его видит пользователь: через прокси и HTTPS.

дописать в deploy.sh
URL=https://stand.provision.internal:8443/api/whoami
curl -fsS --cacert ~/devops-lab/tls/ca.crt "$URL"
echo
echo "выкачен $IMAGE"

Флаг -f у curl превращает ответ 4xx и 5xx в ошибку, -sS прячет полосу загрузки, но оставляет текст ошибок. --cacert — сертификат стенда, которому мы доверяем, из миссии раздела 08.

Шаг 12. Выкатить руками

Скрипт собран целиком. Запусти его той же командой.

ubuntu@stand:~$
~/infra/scripts/deploy.sh $IMG
ubuntu@stand:~$
APP_IMAGE=192.168.1.50:5050/devops/infra/app:a2f5d81b
 ✔ app Pulled
 ✔ Container provision-db-1  Running
 ✔ Container provision-migrate-run-92d50c64acbe  Created
NOTICE:  relation "visits" already exists, skipping
CREATE TABLE
 ✔ Container provision-app-1  Healthy
{"app":"stand","host":"9c2f81a3e4d7","pid":9,"version":"1.0.0"}
выкачен 192.168.1.50:5050/devops/infra/app:a2f5d81b

Первая строка — откуда уехали: тот же образ, что ты выкатывал в шагах 7–9, — повторный выкат одной версии ничего не ломает. Дальше миграции: база уже работает (Running), одноразовый контейнер migrate-run-… создан, а NOTICE … already exists, skipping и CREATE TABLE — ответ psql: таблица уже есть, повторный прогон ничего не сломал. Так и пишут миграции — чтобы их можно было запускать на каждом выкате. Healthy — --wait дождался проверки здоровья. JSON — ответ сайта снаружи: версия 1.0.0, та, что задана в образе в разделе 07. Скрипт рабочий.

Шаг 13. Задача выката: заголовок

Теперь подключим скрипт к конвейеру. Новая ветка, третья стадия в stages.

ubuntu@stand:~$
cd ~/infra
git switch -c ci/deploy
в начале .gitlab-ci.yml
stages:
  - check
  - build
  - deploy

И заголовок задачи в конце файла:

дописать в .gitlab-ci.yml
deploy-stand:
  stage: deploy
  image: alpine:3.20
  needs: [build-image]
  environment:
    name: stand
    url: https://stand.provision.internal:8443

needs — выкатывать только то, что собрала build-image этого же конвейера. environment — GitLab запишет выкат в окружение stand.

Шаг 14. Задача выката: команды

Контейнер задачи — голый Alpine, SSH-клиента в нём нет. Ставим его, отдаём ключу права, которые требует ssh, и заходим на стенд.

дописать в задачу deploy-stand
  variables:
    IMG: $CI_REGISTRY_IMAGE/app:$CI_COMMIT_SHORT_SHA
    SSH_OPTS: -o UserKnownHostsFile=$SSH_KNOWN_HOSTS -i $SSH_KEY
  script:
    - apk add --no-cache openssh-client
    - chmod 600 "$SSH_KEY"
    - ssh $SSH_OPTS "$STAND" infra/scripts/deploy.sh $IMG

IMG — полное имя образа этого коммита: CI_REGISTRY_IMAGE — адрес реестра проекта, CI_COMMIT_SHORT_SHA — короткий хеш, тот же тег, что поставила сборка. Обе подставляет GitLab. $SSH_KEY — путь к временному файлу с ключом, его подставил GitLab. UserKnownHostsFile велит ssh сверять отпечаток стенда с файлом из переменной SSH_KNOWN_HOSTS из шага 5: совпал — входит без вопросов, не совпал — отказывается. Последняя строка запускает на стенде твой скрипт с образом этого коммита.

Шаг 15. Задача выката: кнопка

И правило: только из main, только кнопкой, и упавший выкат краснит конвейер.

дописать в задачу deploy-stand
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      when: manual
      allow_failure: false

Шаг 16. Влить и нажать

Скрипт и конвейер — в один коммит, и через merge request в main.

ubuntu@stand:~$
git add scripts/deploy.sh .gitlab-ci.yml
git commit -m "ci: выкат на стенд по кнопке"
git push -u gitlab ci/deploy

Флаг -m — сообщение, -u — связать ветку с сервером. Создай MR, дождись зелёных проверок, нажми Merge. Затем на стенде вернись в main и забери изменения: конвейер запускает скрипт из твоей рабочей копии ~/infra, то есть из той ветки, что там сейчас выбрана. Для стенда это упрощение. На рабочем сервере скрипт доставляют вместе с выкатом из того же коммита, что и образ (например, scp в задаче), чтобы на сервер не уехал чужой черновик.

ubuntu@stand:~$
git switch main
git pull

Открой Build → Pipelines → конвейер по main. В колонке deploy у задачи deploy-stand значок ▶ — это и есть кнопка. Когда build-image позеленеет, нажми ▶.

Шаг 17. Журнал выката

В журнале задачи будет то же, что ты видел при ручном запуске, только пришедшее через SSH.

конец журнала deploy-stand
ssh $SSH_OPTS "$STAND" infra/scripts/deploy.sh $IMG
APP_IMAGE=192.168.1.50:5050/devops/infra/app:a2f5d81b
 ✔ Container provision-app-1  Healthy
выкачен 192.168.1.50:5050/devops/infra/app:7c1e4b2f
Job succeeded

Если вместо этого Load key ... error in libcrypto — в переменной SSH_KEY нет перевода строки после последней строки ключа. Permission denied (publickey) — открытый ключ не попал в authorized_keys, вернись к шагу 2. unauthorized на pull — стенд не вошёл в реестр токеном, шаг 8. Host key verification failed — отпечаток в SSH_KNOWN_HOSTS не совпал с настоящим: либо стенд переустановили, либо ты ходишь не туда; повтори шаг 5.

Шаг 18. Окружение

Открой Operate → Environments → stand. Там одна запись: коммит, кто нажал, когда и зелёная пометка. Кнопка Open ведёт на url из задачи.

Таких записей будет столько, сколько выкатов. В следующей практике ты воспользуешься тем, ради чего они ведутся, — откатом.

Шаг 19. Сдать

Выполни команду сдачи: она покажет ключи выката в конвейере, образ в .env стенда и состояние приложения.

Практика 06+525 XP

Выкатывать образ из реестра на сервер кнопкой в GitLab: ключ в защищённой переменной, проверка после выката и запись в окружении.

  • Стенд вошёл в реестр токеном
  • Выкат запускается кнопкой
  • Упавший выкат краснит конвейер
  • Задача привязана к окружению
  • Отпечаток стенда проверяется
  • Проверка отпечатка не выключена
  • На стенде образ из реестра GitLab
  • Приложение здорово
Команда сдачи — выполни на своей машине
команда
cd ~/infra; git show gitlab/main:.gitlab-ci.yml | grep -E 'environment:|when: manual|allow_failure: false|SSH_KEY|KnownHosts|StrictHost'; grep APP_IMAGE stand/.env; echo AUTH=$(grep -c ':5050' ~/.docker/config.json 2>/dev/null); docker compose -f stand/compose.yaml ps app

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.