Хуки и переменные окружения
Хук передаётся строкой скрипта с shebang в configuration.hooks. Рабочий каталог соответствует workspace сессии. Выберите интерпретатор, установленный в шаблоне.
| Переменная | Доступность | Назначение |
|---|---|---|
ORPHEUS_SESSION_ID | Все выполняемые хуки | UUID сессии |
ORPHEUS_WORKSPACE_PATH | Все выполняемые хуки | Абсолютный путь workspace |
ORPHEUS_HOOK_OPERATION_ID | Все выполняемые хуки | Устойчивый ID операции хука |
ORPHEUS_RUN_ID | before_run, after_run | UUID запуска |
ORPHEUS_INPUT_FINGERPRINT | before_run, after_run, если задан | Версия входных данных |
ORPHEUS_AGENT_STATUS | after_run, если известен | completed, failed, cancelled |
ORPHEUS_STOP_REASON | after_run, если известна | Причина остановки |
Переменные запуска не становятся переменными агента. Передайте нужный несекретный контекст через подготовленный файл или текст задачи.
При совпадении имён поля env, env_from и services на верхнем уровне запроса запуска перекрывают сессионные значения для before_run и after_run. Они не влияют на after_create и процесс агента.
Хуки: after_create выполняется после создания окружения, before_run перед задачей, after_run после подтверждённого завершения. before_remove не выполняется.
Ненулевой код завершения или таймаут фиксируются как ошибка хука. Лимит сохраняемого stdout/stderr не останавливает сам скрипт. Для сетевых вызовов задавайте таймаут меньше общего таймаута хука.