MODULE_07 · УРОК 7.3

Durable workflows

Сторож для песочницы придумывается за минуту: каждые полминуты заглядывать и спрашивать, не простаивает ли она дольше положенного, а если простаивает - снять снимок и погасить. На ноутбуке эта мысль прекрасно укладывается в цикл с asyncio.sleep, и на этом можно было бы разойтись.

Проблемы начинаются, когда harness переезжает в serverless. Там функция живёт минуту-другую, потом её убивают, и ваш сторож умирает вместе с ней - молча, не оставив записки. Песочница при этом продолжает исправно жечь деньги до жёсткого срока. Нужен сон, который переживает смерть процесса.

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

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

  • Serverless - способ хостинга, где код живёт короткими вспышками: пришёл запрос, ответили, процесс убили. Ничего «на подержать» в памяти не остаётся, и долгий sleep в том числе.
  • Durable workflow - сценарий, который умеет уснуть в хранилище и продолжиться позже, возможно уже на другой машине. Процесс смертен, сценарий нет.
  • Чекпоинт - сохранённая отметка о том, где именно сценарий остановился, чтобы проснуться ровно с этого места, а не с начала.

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

Файл Что делать
проект ученика Не трогать. Урок чисто теоретический - код писать не нужно. В учебном local-harness такой цикл не запускаем.

Почему обычный sleep ломается

# на ноутбуке ок; в serverless - нет
await asyncio.sleep(30)
await check_and_snapshot(sandbox_id)

Дальше происходит вот что. Функция вернула ответ, рантайм спокойно убил процесс, вместе с процессом испарился и таймер. Проверка так и не случилась, песочница крутится до жёсткого срока. Даже если первая проверка каким-то чудом успела пройти, ближайший деплой всё равно снесёт состояние таймера, и вы об этом узнаете из счёта.

Цикл с настоящим сном

Лекарство есть, и в каждой платформе его зовут по-своему: workflow sleep, wait в Step Functions, таймер в Temporal. Названия разные, смысл один - подождать, не удерживая процесс, потому что сам сценарий в это время лежит в хранилище.

# псевдокод идеи, не библиотека курса
POLL = 30
IDLE = 5 * 60

async def sandbox_lifecycle(sandbox_id: str):
    while True:
        await durable_sleep(POLL)  # чекпоинт → проснулись через 30с

        status = await check_sandbox_status(sandbox_id)
        if status == "expired":
            break

        if status.last_activity + IDLE < now():
            await snapshot_and_stop(sandbox_id)
            break

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

Шаги с побочными эффектами

Обращения к API провайдера и к собственной базе обычно оформляют отдельными шагами: сорвалось - повторим, прошло успешно - второй раз дёргать не будем. В коде цикла это выглядит как вызов обычной функции, а устойчивость подкладывает рантайм workflow. Здесь же аукается урок про идемпотентность: повторы бывают, и операции должны быть к ним готовы.

Грубая арифметика денег

Схема Поведение Оценка за сессию
Без lifecycle До жёсткого срока (например 4 часа) 4ч × цена минуты
С усыплением по простою Уснул через 5 мин idle Реально отработанные минуты

На длинных сессиях с паузами - а других у агентов практически не бывает, человек же отвлекается - разница выходит на порядок. Конкретные числа зависят от вашего тарифа, важна пропорция.

ГДЕ ЭТО В НАШЕМ HARNESS Local и memory живут ровно столько, сколько работает python main.py, так что никакой durable workflow им не нужен. А вот хуки из урока 4.5 - именно то место, куда облачный бэкенд однажды повесит запуск такого цикла в after_start и сигнал закругляться в before_stop. Интерфейс Sandbox при этом не меняется: workflow зовёт snapshot и stop точно так же, как любой другой код.
НЕ ПРИВЯЗЫВАЕМСЯ К ОДНОМУ ВЕНДОРУ Модные продукты для workflow меняются быстрее, чем выходят курсы про них, поэтому запоминать стоит паттерн: сон с чекпоинтом плюс шаги, которые не страшно повторить. Конкретную реализацию выберете под свой хостинг, когда дойдёте до живого облака.

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

  1. Одним предложением: почему обычный sleep плох в serverless.
  2. Где в цикле выше сценарий может «заснуть» и пережить деплой.
  3. Прикиньте: сколько у вас в среднем простой vs работа в сессии - что даст усыпление через 5 минут.

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

  • Объясняете провал обычного sleep в serverless
  • Можете набросать цикл wait → check → snapshot/stop
  • Понимаете, зачем sleep с чекпоинтом
  • Связываете это с хуками 4.5, а не с правкой local sandbox