Версии

Как безопасно обновить статический сайт

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

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

## Полная замена

Новая версия содержит только загруженный набор. Если в прежней версии был `old-banner.jpg`, а в новой папке его нет, после публикации файл исчезнет. Этот режим предсказуем для сборок: содержимое `dist` полностью заменяет предыдущий `dist`.

Перед отправкой проверяются:

- наличие главной страницы;
- папки с изображениями и шрифтами;
- файлы, которые исключил архиватор или `.gitignore`;
- общий размер проекта.

## Только изменённые файлы

Deploya берёт текущую версию и накладывает на неё загруженные пути. Загрузка одного `style.css` не трогает HTML и изображения. Удалить файл этим способом нельзя: отсутствующий в загрузке путь считается неизменённым.

Такой режим опасен после переименования. Если `app.js` стал `main.js`, старый `app.js` останется на сервере. Это не всегда ломает страницу, но создаёт мусор и усложняет проверку. После смены структуры лучше выполнить полную замену.

```text
До обновления:  index.html, app.js, old-logo.png
Patch:          index.html, main.js
После patch:    index.html, app.js, main.js, old-logo.png
```

> Место для скриншота: переключатель «Все файлы / Только изменённые» в окне обновления проекта.

## Что проверить после

Основной адрес открывается в новой вкладке с жёстким обновлением страницы. Браузер может держать прежний CSS или JavaScript в кеше; сочетание `Ctrl+F5` запрашивает ресурсы заново. Затем проверяются вложенные страницы, форма и мобильная ширина.

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

Все статьи