Образ лежит в реестре, но на стенде всё ещё крутится старая версия из раздела 08. Сейчас ты научишь конвейер ставить новую: по кнопке, через SSH, с проверкой, что сайт ответил.
Выкат будет делать короткий скрипт на стенде, а конвейер — только заходить и запускать его. Так скрипт можно запустить и руками, если GitLab лёг, а это бывает.
Шаг 1. Ключ для конвейера
Конвейеру нужен свой SSH-ключ — не твой личный. Сгенерируем его, как в разделе 03: -t — тип ключа, -N '' — без пароля (иначе конвейер застрянет на вопросе), -f — имя файла.
ssh-keygen -t ed25519 -N '' -f ~/.ssh/gitlab_deployYour identification has been saved in /home/anton/.ssh/gitlab_deploy Your public key has been saved in /home/anton/.ssh/gitlab_deploy.pub
Шаг 2. Пустить ключ на стенд
Открытую половину ключа дописываем в список разрешённых. >> дописывает в конец файла, не затирая.
cat ~/.ssh/gitlab_deploy.pub >> ~/.ssh/authorized_keysПроверим вход новым ключом. Флаг -i у ssh — какой ключ взять; удалённая команда hostname просто напечатает имя машины.
ssh -i ~/.ssh/gitlab_deploy 192.168.1.50 hostnamestandИмя напечаталось без вопроса о пароле — ключ работает. На рабочем сервере для конвейера заводят отдельного пользователя с минимумом прав; на стенде обойдёмся своим.
Шаг 3. Переменная с ключом
Закрытую половину ключа отдаём GitLab. Выведи её на экран и скопируй целиком, от -----BEGIN до -----END ... KEY-----.
cat ~/.ssh/gitlab_deploy-----BEGIN OPENSSH PRIVATE KEY----- b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW ... -----END OPENSSH PRIVATE KEY-----
В проекте: Settings → CI/CD → Variables → Add variable. Заполни так:
Шаг 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 — только ключ этого типа.
ssh-keyscan -t ed25519 192.168.1.50# 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. Переедет реестр или стенд — скрипт менять не придётся.
#!/bin/bash # Выкат приложения на стенд: ./deploy.sh <образ:тег> set -euo pipefail IMAGE="${1:?нужен образ с тегом}" cd ~/infra/stand
set -euo pipefail из раздела 03 роняет скрипт на первой ошибке. ${1:?…} — первый аргумент, а если его нет, скрипт остановится с этим текстом.
Шаг 7. Скрипт выката: замена образа
Самый короткий выкат — показать текущую версию, подменить её в .env, скачать новый образ и поднять приложение.
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, — и запусти.
chmod +x ~/infra/scripts/deploy.shIMG=192.168.1.50:5050/devops/infra/app:a2f5d81b~/infra/scripts/deploy.sh $IMGAPP_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 — имя пользователя, пароль программа спросит сама: вставь токен.
docker login -u stand-pull 192.168.1.50:5050Password: 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, и падает, если не дождался. Замени последнюю строку скрипта:
docker compose up -d --no-deps --wait appС ним тот же сломанный образ даёт container provision-app-1 exited (3) и код 1 — set -e остановит скрипт, а конвейер покраснеет.
Шаг 10. Сначала миграции
Новая версия кода может ждать новую схему базы. Поэтому перед приложением — миграции, тот же порядок, что цепочка migrate → app из раздела 08. Вставь строку перед up:
docker compose run --rm migraterun --rm migrate выполняет сервис миграций один раз и удаляет его контейнер. Упадёт миграция — set -e остановит скрипт, и приложение со старой схемой не перезапустится. Миграции пишут так, чтобы старая версия кода тоже работала с новой схемой: добавить колонку можно сразу, а удалить — только релизом позже. Тогда откат образа кнопкой не упрётся в базу: откат образа схему назад не возвращает.
Шаг 11. Проверка снаружи
healthy — это мнение контейнера о себе. Последний кусок проверяет сайт так, как его видит пользователь: через прокси и HTTPS.
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. Выкатить руками
Скрипт собран целиком. Запусти его той же командой.
~/infra/scripts/deploy.sh $IMGAPP_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.
cd ~/infra git switch -c ci/deploy
stages: - check - build - deploy
И заголовок задачи в конце файла:
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, и заходим на стенд.
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, только кнопкой, и упавший выкат краснит конвейер.
rules: - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH when: manual allow_failure: false
Шаг 16. Влить и нажать
Скрипт и конвейер — в один коммит, и через merge request в main.
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 в задаче), чтобы на сервер не уехал чужой черновик.
git switch main git pull
Открой Build → Pipelines → конвейер по main. В колонке deploy у задачи deploy-stand значок ▶ — это и есть кнопка. Когда build-image позеленеет, нажми ▶.
Шаг 17. Журнал выката
В журнале задачи будет то же, что ты видел при ручном запуске, только пришедшее через SSH.
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 стенда и состояние приложения.