Ручная FTP-заливка ломает сайт не из-за самого протокола, а потому что production некоторое время содержит смесь старых и новых файлов, а состав изменения нигде не зафиксирован. Первый шаг — не подключать сложный CI, а собрать текущий код в репозиторий, отделить uploads и конфигурацию, затем выпускать один неизменяемый artifact. Сервер получает полную версию в новый каталог и переключается на неё только после проверок.
Не начинайте автоматизацию с копирования всей рабочей папки разработчика. В неё могут попасть .env, кеши, node_modules другой платформы, локальные дампы и временные файлы. Manifest релиза перечисляет commit SHA, зависимости, миграции и checksum artifact. Благодаря этому два одинаковых запуска разворачивают один и тот же набор.
Сначала разделите содержимое сервера
| Класс | Где живёт | Как обновляется |
|---|---|---|
| код приложения | release artifact | целиком из проверенной версии |
| собранные CSS/JS | тот же artifact | создаются один раз в CI |
| uploads | shared storage | никогда не заменяются релизом |
| секреты и env | защищённая конфигурация | отдельный контролируемый процесс |
| cache/tmp | воспроизводимые каталоги | создаются с нужными правами |
| база данных | внешнее состояние | миграции с совместимостью и backup |
Сделайте инвентаризацию до первого автоматического копирования. Если пользовательские изображения лежат внутри каталога кода, вынесите их в shared-путь или объектное хранилище и подключайте к каждому релизу предсказуемо. Удалять «лишние» файлы в production можно только после подтверждения класса; иначе команда очистки затронет данные, которых нет в репозитории.
Минимальный pipeline собирает, проверяет и доставляет
- checkout выполняется по конкретному commit или tag;
- зависимости устанавливаются по lockfile в чистом окружении;
- тесты и сборка завершаются до доступа к production;
- artifact архивируется и получает checksum и manifest;
- секреты deployment environment доступны только задаче доставки;
- одновременные deploy одного окружения запрещаются concurrency-lock.
GitHub deployments связывают релиз с конкретным ref и позволяют хранить состояния queued, in_progress, success или failure. Это один из вариантов контроля, а не обязательный сервис. Тот же принцип реализуется другим CI: production всегда знает, какой commit развёрнут и где находится журнал доставки.
Переключение происходит после подготовки каталога
releases/
20261009-1211-a1b2c3/
20261008-1840-9f8e7d/
shared/
uploads/
app.env
current -> releases/20261009-1211-a1b2c3/
# порядок: unpack -> shared links -> checks -> pointer switch -> health checkСхема условная и требует прав, подходящих вашему серверу. Новый каталог заполняется вне document root current, затем подключаются shared-ресурсы, выполняются проверки конфигурации и только потом атомарно меняется указатель. Rsync полезен для доставки, но параметры --delete и направление source/destination проверяют dry-run: ошибка пути способна удалить production-файлы.
Миграция базы диктует возможность отката
Откат к предыдущему каталогу не восстановит удалённый столбец. Изменения схемы проектируют совместимыми на время двух версий: сначала добавление, затем код начинает использовать новое поле, и только отдельным поздним релизом удаляется старое. Перед рискованной миграцией создаётся проверяемая резервная копия, а health check охватывает реальную бизнес-операцию.
После переключения проверьте HTTP-код, версию приложения, чтение конфигурации, подключение к базе и один безопасный read-only сценарий. Если проверка падает, current возвращают на предыдущий релиз и останавливают дальнейшие шаги. Не редактируйте новый каталог вручную: исправление оформляется следующим commit и новым artifact, иначе история перестаёт соответствовать серверу.
Переход можно сделать без одномоментной революции
- Зафиксировать текущее состояние production и исключить секреты и пользовательские данные из репозитория.
- Собрать локально artifact и сравнить его состав с ручной заливкой без изменения сервера.
- Развернуть release-каталог в staging и выполнить smoke-test и пробный rollback.
- Первый production-релиз запустить вручную одной задокументированной командой с наблюдением.
- После нескольких успешных выпусков перенести ту же процедуру в CI с защищённым environment.
Для проектирования подготовьте дерево production без содержимого секретов, lockfiles, команды сборки, список shared-данных и текущую процедуру отката. Пароль FTP лучше заменить ограниченным deployment credential и ротировать после перехода. Старый способ оставляют только как аварийный read-only reference, а не как параллельный канал изменений.