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

Мне удобнее хранить выпуски рядом, а корень сайта направлять на ссылку current:

/srv/www/site/
├── releases/
│   ├── 20261026-01/
│   └── 20261027-01/
└── current -> releases/20261026-01/

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

Одна замена ссылки

Следующие команды предполагают, что новый каталог уже готов, current — символическая ссылка, а имя current.next свободно. Выполняются из каталога сайта:

cd /srv/www/site
readlink current
ln -s releases/20261027-01 current.next
mv -Tf current.next current

Временная ссылка создаётся рядом с рабочей. mv -T заменяет саму ссылку, не переносит её внутрь каталога назначения. Если nginx уже смотрит на current и конфигурация не менялась, ради одной замены ссылки перечитывать конфигурацию обычно не требуется.

Атомарна здесь только замена имени. HTML и картинки загружаются отдельными запросами. В новый каталог включаю и версионные ресурсы предыдущего выпуска, пока они нужны уже открытым страницам. Другой вариант — общее хранилище неизменяемых ресурсов. О версиях в адресах записал отдельно.

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