Перед следующим релизом отключите шаг, который очищает каталог назначения. Не запускайте повторную синхронизацию «для проверки»: опция удаления может убрать и оставшиеся файлы. Снимите копию текущего состояния, найдите последнюю проверенную резервную копию и восстановите один объект в отдельное место.
После восстановления нужно убрать сам конфликт владения. Код релиза и пользовательский upload имеют разный жизненный цикл: код можно заменить и откатить по commit, а загруженный сегодня договор должен пережить оба действия.
Сначала определяем команду, которая удалила файл
| Признак | Вероятная причина | Где смотреть |
|---|---|---|
| Исчез весь uploads | Очистка каталога release | deploy log и target path |
| Исчезли только старые файлы | sync с delete/retention | rsync flags и cleanup job |
| В контейнере были до recreate | Writable layer | mounts и image update |
| Файлы есть на host, сайт не видит | Неверный mount/symlink | runtime path |
| Пропала часть CDN | Origin key/version mismatch | storage inventory |
| После rollback ссылки битые | База и storage откатились несогласованно | release procedure |
Официальная документация rsync описывает `--delete` как удаление на стороне назначения файлов, которых нет у источника, в синхронизируемых каталогах. Если uploads лежит внутри target release и отсутствует в build artifact, команда может считать его лишним.
Постоянные данные живут вне release
/srv/example/
├── releases/
│ ├── 20261006-153900/ # код и собранные assets
│ └── 20261006-162400/
├── shared/
│ └── uploads/ # пользовательские файлы
└── current -> releases/20261006-162400
В приложении: public/uploads -> /srv/example/shared/uploadsЭто условная раскладка. Twelve-Factor разделяет build, release и run, а здесь дополнительно выделено постоянное состояние. Для Docker постоянные данные размещают в volume или bind mount, а не в writable layer контейнера: Docker указывает, что изменения слоя теряются при удалении контейнера, тогда как volumes живут независимо.
Способ хранения выбирают по нагрузке и окружению
| Вариант | Подходит | Что предусмотреть |
|---|---|---|
| Shared directory | Один сервер | Права, backup, atomic switch |
| Docker volume | Один host/Compose | Явное имя и restore test |
| Network filesystem | Несколько приложений | Latency и блокировки |
| Object storage | Масштабирование и CDN | ACL, keys, metadata, lifecycle |
| Release directory | Только код/assets | Никаких uploads |
Перенос в object storage не ограничивается сменой URL. Нужно перенести существующие объекты, сохранить соответствие ключей базе, настроить доступ и проверить чтение старых ссылок. До cutover полезен режим двойного чтения или controlled migration, но двойная запись требует обработки частичных сбоев.
Dry-run показывает будущие удаления
- Синхронизацию сначала запускают с `--dry-run` и itemized output.
- Target path выводится в лог до выполнения команды.
- Uploads, cache, logs и secrets перечислены по владельцу и lifecycle.
- Шаг удаления разрешён только внутри конкретного release-каталога.
- Symlink или mount проверяется после сборки и до переключения current.
- Backup имеет проверенную процедуру восстановления, а не только статус success.
Exclude снижает риск, но остаётся хрупким, если постоянные данные физически находятся внутри дерева, которое deploy считает своим. Надёжнее изменить границу каталогов, а exclude оставить дополнительной защитой.
Rollback кода не откатывает uploads вслепую
Переключение current на прошлый release должно сохранить тот же shared storage. Откат всего диска может удалить новые файлы, появившиеся после snapshot. База и объекты также связаны: запись может ссылаться на ключ, которого нет, или объект может остаться сиротой. План восстановления задаёт отдельные точки для code, database и files.
Тест переживания файла входит в pipeline
- В тестовом окружении загрузить файл через обычный интерфейс.
- Записать object id, путь или key и контрольную сумму.
- Выполнить deploy новой версии тем же механизмом.
- Скачать объект и сравнить контрольную сумму.
- Откатить code release и повторить чтение.
- Проверить backup/restore на отдельном каталоге или bucket.
Проблема закрыта, когда release можно создавать, переключать и удалять без изменения shared files, а восстановление одного объекта проверено. Для разбора подготовьте deploy command в обезличенном виде, дерево путей, mounts, время пропажи и inventory до/после — сами пользовательские документы передавать не нужно.