MODULE_07 · УРОК 7.2

Snapshot и restore

Сами по себе эти две операции скучные до неприличия. Снимок замораживает файлы на диске виртуалки и выдаёт вам id. Restore поднимает по этому id новую машину с теми же файлами. Два вызова, обе строчки помещаются в твит.

Ломается, как водится, не вокруг этих строчек, а вокруг вопроса «а что если позвать дважды». Таймер решил сделать снимок, пользователь нажал кнопку, harness на всякий случай сделал restore - и вот у вас две виртуалки, битый id и счёт, который вы не планировали. Об этом и поговорим. Урок чисто теоретический - код писать не нужно, наброски ниже смотрите как иллюстрации.

ЧТО ПОЛУЧИТСЯ Вы будете понимать, что снимок сохраняет, а что теряет безвозвратно, и узнаете три типичные ловушки повторного вызова вместе с обезоруживающе простыми защитами от них. Урок чисто теоретический - код писать не нужно.

Слова, которые встретятся

  • Snapshot - снимок файловой системы песочницы, то есть застывшая картинка диска на конкретный момент.
  • Restore - поднятая из снимка новая виртуалка. Именно новая: старую вы уже не вернёте, вернёте только её файлы.
  • Идемпотентность - свойство операции, при котором позвать её дважды примерно то же самое, что позвать один раз. Для stop и snapshot это не теория, а необходимость: второй вызов не должен крушить VM или плодить дубли.

Какие файлы трогаем

Файл Что делать
проект ученика Не трогать. Урок чисто теоретический - код писать не нужно. Наброски ниже - по желанию, в проект копировать не обязательно.

Как выглядит снаружи

# идея API, не копировать в ai_loop_agent
snap = await sandbox.snapshot()          # → {"snapshot_id": "..."}
restored = await create_cloud_sandbox({"snapshot_id": snap["snapshot_id"]})

Что снимок сохраняет

Всё, что лежит на диске: файлы в рабочей папке, установленные пакеты, любые артефакты, которые агент успел насоздавать. А вот живого состояния снимок не знает - ни бегущих процессов, ни открытых соединений, ни содержимого памяти. Сборка, прерванная на половине, после restore сама не продолжится, её придётся запускать заново. Формула, которую стоит запомнить: файлы переживают, работа в полёте нет.

Три ловушки «вызвали дважды»

1. Снимок уже идёт

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

# идея защиты
_in_flight = None

async def snapshot(self):
    global _in_flight
    if _in_flight is not None:
        return await _in_flight
    _in_flight = self._vm.snapshot()
    try:
        return await _in_flight
    finally:
        _in_flight = None

Идея в одну строку: второй вызов не стартует новый снимок, а садится ждать результат первого. Оба получат один и тот же id и разойдутся довольные.

2. Restore поверх уже живой VM

Сессия ещё в состоянии active, а harness на всякий случай делает restore. В итоге у вас две виртуалки: одна работает, другая тоже, счёт идёт за обе, и половина трафика продолжает уходить на старую. Заметить такое по логам на удивление трудно.

async def attach_or_restore(session_id: str, snapshot_id: str):
    existing = await find_active_sandbox(session_id)
    if existing is not None:
        return existing
    return await create_cloud_sandbox({"snapshot_id": snapshot_id})

Правило простое: сначала спросить, нет ли живой песочницы, и только потом поднимать что-то из снимка. Порядок действий тут важнее самого кода.

3. Двойной stop

Таймер простоя решил, что пора спать, и вызвал stop. Через секунду то же самое сделал пользователь. Или вместе сошлись hibernate и жёсткий срок. Второй stop прилетает в уже мёртвую виртуалку, и провайдер отвечает исключением, которое всплывает в самом неподходящем месте.

_stopped = False

async def stop(self):
    global _stopped
    if _stopped:
        return
    _stopped = True
    await self._vm.close()

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

Чего restore не чинит

Есть ещё одна вещь, о которой легко забыть в эйфории от работающих снимков. Снимок - это момент времени, и вчерашний снимок означает вчерашний код с вчерашними зависимостями. Пока песочница спала, репозиторий вполне мог уехать вперёд, и восстановленная машина проснётся с устаревшим состоянием. Поэтому после restore обычно заново прогоняют setup из after_start: поставить пакеты, подтянуть переменные окружения. Само это не случится, такое поведение надо закладывать в harness руками.

ЛОКАЛЬНО МОЖНО ПРИКИНУТЬ ФОРМУ Настоящих снимков VM у локального бэкенда, разумеется, нет. Для экспериментов иногда изображают снимок архивом папки или git stash: семантика, конечно, совсем другая, зато место в интерфейсе то же самое - метод snapshot на Sandbox. В учебный harness это класть не обязательно, но знать про такой трюк полезно.

Проверьте (без кода)

  1. Назовите три ловушки «вызвали дважды».
  2. Своими словами: что снимок хранит и чего нет.
  3. Почему после restore иногда снова нужен after_start?

Готово, если:

  • Понимаете, что сохраняет snapshot
  • Знаете три ловушки и простую защиту для каждой
  • Можете объяснить, зачем после restore снова setup