Ручная FTP-заливка ломает сайт не из-за самого протокола, а потому что production некоторое время содержит смесь старых и новых файлов, а состав изменения нигде не зафиксирован. Первый шаг — не подключать сложный CI, а собрать текущий код в репозиторий, отделить uploads и конфигурацию, затем выпускать один неизменяемый artifact. Сервер получает полную версию в новый каталог и переключается на неё только после проверок.

Не начинайте автоматизацию с копирования всей рабочей папки разработчика. В неё могут попасть .env, кеши, node_modules другой платформы, локальные дампы и временные файлы. Manifest релиза перечисляет commit SHA, зависимости, миграции и checksum artifact. Благодаря этому два одинаковых запуска разворачивают один и тот же набор.

Сначала разделите содержимое сервера

КлассГде живётКак обновляется
код приложенияrelease artifactцеликом из проверенной версии
собранные CSS/JSтот же artifactсоздаются один раз в CI
uploadsshared 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, иначе история перестаёт соответствовать серверу.

Переход можно сделать без одномоментной революции

  1. Зафиксировать текущее состояние production и исключить секреты и пользовательские данные из репозитория.
  2. Собрать локально artifact и сравнить его состав с ручной заливкой без изменения сервера.
  3. Развернуть release-каталог в staging и выполнить smoke-test и пробный rollback.
  4. Первый production-релиз запустить вручную одной задокументированной командой с наблюдением.
  5. После нескольких успешных выпусков перенести ту же процедуру в CI с защищённым environment.

Для проектирования подготовьте дерево production без содержимого секретов, lockfiles, команды сборки, список shared-данных и текущую процедуру отката. Пароль FTP лучше заменить ограниченным deployment credential и ротировать после перехода. Старый способ оставляют только как аварийный read-only reference, а не как параллельный канал изменений.

Проверенные источники