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 руками.
git stash: семантика, конечно, совсем другая, зато
место в интерфейсе то же самое - метод snapshot на
Sandbox. В учебный harness это класть не обязательно, но знать
про такой трюк полезно.
Проверьте (без кода)
- Назовите три ловушки «вызвали дважды».
- Своими словами: что снимок хранит и чего нет.
- Почему после restore иногда снова нужен
after_start?
Готово, если:
- Понимаете, что сохраняет snapshot
- Знаете три ловушки и простую защиту для каждой
- Можете объяснить, зачем после restore снова setup