Перед следующим релизом отключите шаг, который очищает каталог назначения. Не запускайте повторную синхронизацию «для проверки»: опция удаления может убрать и оставшиеся файлы. Снимите копию текущего состояния, найдите последнюю проверенную резервную копию и восстановите один объект в отдельное место.

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

Сначала определяем команду, которая удалила файл

ПризнакВероятная причинаГде смотреть
Исчез весь uploadsОчистка каталога releasedeploy log и target path
Исчезли только старые файлыsync с delete/retentionrsync flags и cleanup job
В контейнере были до recreateWritable layermounts и image update
Файлы есть на host, сайт не видитНеверный mount/symlinkruntime path
Пропала часть CDNOrigin key/version mismatchstorage 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Масштабирование и CDNACL, 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

  1. В тестовом окружении загрузить файл через обычный интерфейс.
  2. Записать object id, путь или key и контрольную сумму.
  3. Выполнить deploy новой версии тем же механизмом.
  4. Скачать объект и сравнить контрольную сумму.
  5. Откатить code release и повторить чтение.
  6. Проверить backup/restore на отдельном каталоге или bucket.

Проблема закрыта, когда release можно создавать, переключать и удалять без изменения shared files, а восстановление одного объекта проверено. Для разбора подготовьте deploy command в обезличенном виде, дерево путей, mounts, время пропажи и inventory до/после — сами пользовательские документы передавать не нужно.

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