Loading...

Деплой · 8 мин чтения

Деплой из Git: пушите в свою ветку — новая версия уходит в продакшен

Деплой через git убирает самый ошибкоопасный шаг в выпуске софта — ручной. Вместо того чтобы собирать всё на ноутбуке, загружать файлы и перезапускать что-то по SSH, вы один раз подключаете репозиторий, и каждый push в выбранную ветку собирает свежий образ и заменяет работающее приложение. В этом руководстве разбирается, что на самом деле происходит между вашим push и живым сайтом, что для этого нужно вашему репозиторию, как держать продакшен в стороне от повседневной работы и — та часть, которую большинство руководств пропускает — как понять, какое звено цепочки сломалось, когда push не появился.

8 мин чтения Для начинающих Обновлено

Деплой из Git: пушите в свою ветку — новая версия уходит в продакшен

Что на самом деле означает «деплой из Git»

Почти всю историю отрасли деплой означал последовательность действий, которую человек выполнял руками: собрать локально, скопировать файлы на сервер, накатить миграцию, перезапустить процесс и надеяться, что ничего не забыто. Каждый шаг был поводом сделать чуть иначе, чем в прошлый раз, — и разница между «у меня работает» и сломанным продакшеном жила обычно именно в этих шагах.

Деплой через git заменяет эту последовательность правилом: ветка — источник истины, и то, что на ней лежит, то и работает. Вы ничего не загружаете. Вы пушите, а платформа каждый раз выполняет одну и ту же сборку. Смысл именно в повторяемости, а не в удобстве. Совсем нет репозитория? Есть дорога, которая начинается с обычной папки проекта: задеплойте приложение, которое написал ваш ИИ.

Что происходит между вашим push и живым приложением

Цепочка короткая, и её стоит знать: когда что-то идёт не так, вам нужно понимать, на какое звено смотреть.

Ваш push доходит до репозитория, и тот уведомляет нас. Мы проверяем, подключены ли к приложению именно этот репозиторий и эта ветка; если да — стартует сборка. Сборка выполняется в изолированной песочнице — ваш код никогда не делит процесс с чужим — и создаёт контейнерный образ из вашего Dockerfile. Только когда образ готов, платформа запускает новую версию и выводит из работы старую. Если сборка падает, ничего не заменяется: предыдущая версия продолжает обслуживать трафик — именно то поведение, которого вы хотите в два часа ночи.

Доступ по замыслу короткоживущий: учётные данные для чтения вашего репозитория выпускаются в момент деплоя, а не хранятся, поэтому токен, лежащий в нашей базе, не может пережить свою полезность.

Что нужно вашему репозиторию

Деплой из Git: пушите в свою ветку — новая версия уходит в продакшен — Что нужно вашему репозиторию
Управляемые платформы и container apps на cdn.com.tr.

В основном одно: Dockerfile. Это рецепт, который превращает ваш исходный код в запускаемый образ — базовый образ, зависимости, шаг сборки, команда запуска. Если в вашем проекте его пока нет, написать его — разовая задача, и тот же самый файл работает на вашем ноутбуке.

Больше всего времени людям экономят две детали. Первая: ваше приложение должно слушать тот порт, о котором вы сообщили платформе, и на всех интерфейсах (0.0.0.0), а не только на localhost — контейнер, привязанный к localhost, недостижим снаружи самого себя. Вторая: всё секретное (строки подключения к базе, API-ключи) место в переменных окружения, а не в образе: образы пересобираются и переезжают, а секрет, запечённый в образ, — это секрет, который вы не сможете ротировать.

Многосервисный проект работает так же через Compose-файл: каждому сервису без готового образа нужен собираемый Dockerfile, и стек поднимается уже связанным.

Ветки: держите продакшен в стороне от повседневной работы

Именно здесь команды обжигаются, и лечится это решением, а не функцией. Если продакшен подключён к ветке, в которой вы разрабатываете, в продакшен уезжает каждый наполовину готовый commit. Подключайте продакшен к ветке, в которую вы вливаете изменения только осознанно, — обычно это main, пока повседневная работа идёт в feature-ветках, либо отдельная ветка production, если main — это место, где вы итерируете.

Полезная мысленная проверка: «если я запушу прямо сейчас, меня устроит, что это увидят посетители?» Если для подключённой ветки ответ хоть раз «нет», значит неправильна ветка, а не процесс.

Релизный поток, при котором продакшен остаётся скучным

# повседневная работа: в feature-ветке
git checkout -b feature/yeni-fiyatlandirma
git commit -am "pricing page"
git push origin feature/yeni-fiyatlandirma   # деплой НЕ запускается

# когда готово к выпуску
git checkout main
git merge feature/yeni-fiyatlandirma
git push origin main                         # деплой запускает ИМЕННО этот push

Когда push не появляется

Деплой выглядит магией ровно до того момента, когда он молча ничего не делает, — поэтому диагностируйте в том порядке, в котором работает цепочка.

Начните с конца: сборка вообще стартовала? Если для вашего push сборки нет, сломалось звено подключения — подключены не тот репозиторий или не та ветка, либо интеграция потеряла доступ (отозванная установка, переименованный или перенесённый репозиторий). Если сборка стартовала и упала, лог сборки покажет ровно где; чаще всего причина — шаг в Dockerfile, который локально проходит из-за файла, исключённого вашим .dockerignore, либо установка зависимости, которой нужны учётные данные, недоступные сборке. Если сборка прошла успешно, но вы всё ещё видите старую версию, вы почти наверняка смотрите на закешированный ответ, а не на устаревшее приложение — запросите страницу с обходом кеша или проверьте заголовок статуса кеша, прежде чем подозревать деплой.

Один неочевидный случай, который стоит знать: повторный запуск деплоя для commit, который уже упал, сам по себе ничего не исправит. Commit — это входные данные; если вход не изменился, не изменится и результат. Запушьте исправление — пусть даже пустой commit — вместо того чтобы повторять тот же самый.

Проверьте состояние и запустите деплой из терминала

# состояние работающего приложения
cdnctl container apps list --account <uuid>

# что сделал последний деплой
cdnctl container apps logs --account <uuid> --app <app_uuid>

# повторить деплой вручную (тот же commit)
cdnctl container apps deploy --account <uuid> --app <app_uuid>

Что вы получаете, когда это становится скучным

Настоящая выгода деплоя через git — не скорость, а то, что деплой перестаёт быть событием. Когда выпуск — это push, небольшие изменения уходят в продакшен сами по себе, а не копятся в рискованный ежемесячный релиз, — и именно небольшие изменения поддаются отладке, потому что при поломке вы точно знаете, какой commit её вызвал.

Это ещё и превращает откат в обычную операцию, а не в аварию: предыдущий образ никуда не делся, и возврат к нему — такой же деплой, как любой другой. Команды, которые выпускают ежедневно, не смелее тех, кто выпускает раз в месяц; они просто сделали каждый отдельный деплой достаточно маленьким, чтобы он был неинтересным.

Как настроить

Пошаговые руководства в справочном центре:

Частые вопросы

Нужен ли мне Dockerfile или платформа сама догадается, как собрать моё приложение?

Dockerfile нужен. Мы не угадываем сборку за вас — файл явно задаёт базовый образ, зависимости и команду запуска, и именно поэтому сборка воспроизводима. Тот же самый файл собирается точно так же на вашей машине.

Что происходит с работающим приложением, пока собирается новая версия?

Оно продолжает обслуживать трафик. Новая версия заменяет старую только после того, как образ успешно собран; неудачная сборка оставляет продакшен ровно таким, каким он был.

Можно ли задеплоить без push — например, чтобы прогнать последнюю версию заново?

Да. Деплой можно запустить вручную из панели или через cdnctl, с тем же самым commit. Это полезно после изменения переменной окружения, которое не создаёт новый commit.

Как держать секреты вне репозитория?

Кладите их в переменные окружения приложения, а не в Dockerfile и не в код. Всё, что запечено в образ, путешествует вместе с этим образом и не может быть ротировано без пересборки.

Я запушил, но ничего не произошло. Куда смотреть в первую очередь?

Проверьте, стартовала ли сборка вообще. Нет сборки — проблема с подключением (не та ветка, отозванный доступ, переименованный репозиторий). Упавшая сборка — смотрите лог сборки. Успешная сборка при на вид старом сайте обычно означает, что вы видите закешированный ответ.