State machine
Локальная песочница - создание неприхотливое: живёт, пока жив ваш процесс Python, и денег не просит. Облачная устроена иначе. Это настоящая виртуалка, за которую платят по минутам, и жизнь у неё сложнее, чем «включена или выключена». Она проходит через несколько состояний, и от каждого перехода зависит счёт в конце месяца.
Разберём четыре состояния, два совершенно разных таймера и вечный вопрос о том, что считать признаками жизни агента. Урок чисто теоретический - код писать не нужно.
Слова, которые встретятся
- Состояние (state) - в каком режиме сейчас виртуалка: поднимается, работает, засыпает или уже спит.
- Жёсткий срок (hard expiry) - потолок жизни VM у провайдера, обычно от часа до нескольких. Продлить его нельзя ни уговорами, ни настройками, но можно успеть сохранить снимок.
- Окно простоя (inactivity) - сколько минут без работы вы сами готовы оплачивать, прежде чем усыпить песочницу. Эту цифру, в отличие от предыдущей, назначаете вы.
Какие файлы трогаем
| Файл | Что делать |
|---|---|
| всё в проекте | Не трогать. Урок чисто теоретический - код писать не нужно. |
Четыре состояния
provisioning → active → hibernating → hibernated
↑ │
└─────────────┘ (restore из снимка)
| Состояние | Что происходит | Деньги |
|---|---|---|
| provisioning | VM поднимается, ставятся зависимости | Счёт уже идёт |
| active | Агент работает, команды и файлы | Полная цена за минуту |
| hibernating | Делается снимок, sandbox сворачивается | Ещё полная цена |
| hibernated | VM выключена, снимок лежит на диске | В основном хранение |
Вывод из таблицы простой: дорого обходится active,
дёшево - hibernated. Переходы между ними короткие,
но тарифицируются по полной, так что дёргать песочницу туда-сюда
без повода - способ платить за одни только пробуждения.
Два таймера
Жёсткий срок
Этот таймер ставит провайдер, и обычно речь про интервал от часа до четырёх. Время вышло - VM убивают, и ей глубоко всё равно, что агент сидел в середине прогона тестов. Договориться нельзя, можно только закончить раньше или успеть снять снимок.
Окно простоя
А вот этот таймер полностью ваш, и тут есть где ошибиться. Пять минут без работы - разумная отправная точка. Поставите две - песочница начнёт засыпать между вашими репликами, пока вы наливаете чай. Поставите двадцать - будете щедро оплачивать воздух.
# идея, не копировать в проект
INACTIVITY_WINDOW_SEC = 5 * 60
Что считать активностью
| Событие | Двигает таймер простоя? |
|---|---|
| Сообщение пользователя | да |
| Вызов tool | да |
| Запись файла / запуск процесса в sandbox | да |
| Опрос статуса («жив ли?») | нет |
| Проверка reconnect / health-check | нет |
Границу тут важно провести аккуратно, потому что ошибиться можно в обе стороны и обе неприятные. Засчитаете опрос статуса за активность - песочница не уснёт никогда, ваш же health-check будет бодро будить её каждые тридцать секунд, а счёт пойдёт часами. Не засчитаете вызов инструмента - уснёт ровно посреди работы. И то, и другое встречается в проде с завидной регулярностью.
Пример по минутам
0:00 пользователь написал → sandbox поднимается
0:02 active, агент работает
0:05 агент гоняет долгую установку (~3 мин)
0:08 ответ пользователю
0:13 5 минут без дел → начинается hibernating (снимок)
0:14 hibernated
0:20 новое сообщение → restore из снимка → снова active
1:30 жёсткий срок → VM убита
Посмотрите на этот таймлайн и подумайте над двумя вопросами, на которые нет единственно верного ответа. В какой момент стоит предупредить пользователя, что жёсткий срок на подходе? И когда сделать снимок на всякий случай, не дожидаясь беды? Часто берут отметку в районе восьмидесяти процентов срока. Спорить с этой цифрой можно сколько угодно, а вот вариант «ничего не делать и надеяться» проигрывает ей заведомо.
after_start и
before_stop как раз то место, куда со временем
приедут поля вроде времени последней активности и момента
смерти VM. Локальный бэкенд никаких таймеров не жжёт, но форма
под них у вас в harness уже готова.
Проверьте (без кода)
- Нарисуйте четыре состояния и стрелки между ними.
- Одним предложением: почему жёсткий срок нельзя продлить.
- Возьмите одно событие из таблицы активности и объясните, почему оно да / нет.
Готово, если:
- Называете четыре состояния по порядку
- Отличаете жёсткий срок от окна простоя
- Знаете, что считать активностью, а что - шумом
- Можете по таймлайну сказать, когда имеет смысл автоснимок