Hotdry.
归档
systems-engineering

工程化 Atuin Runbook 执行引擎：任务编排、并行、重试与结构化日志

面向 shell 自动化，给出 Atuin Desktop Runbook 执行引擎的任务编排、并行、重试、条件、secrets 及日志的工程化参数与监控要点。

Atuin Desktop 的 Runbook 执行引擎将静态文档转化为可执行工作流，专为 shell 自动化设计，支持任务编排、条件分支、重试机制、secrets 注入和结构化日志，确保生产级可靠性。该引擎通过 workflow_runtime.ts 等模块实现状态跟踪和依赖管理，避免传统脚本的顺序执行瓶颈。

核心架构基于块（Block）系统，每个 Block 如 Terminal、SSH、HTTP 或 Script，支持串行 / 部分并行执行。工作区（Workspace）作为容器，管理多个 Runbook，支持 CRDT 协作和离线优先。执行器维护任务队列，按依赖调度：只有依赖 Block 完成（exit_code=0），下游才启动。条件 Block 通过变量检查（如 {{var.status === 'success'}}）实现分支；secrets 通过 {{secrets.key}} 注入，避免明文暴露。

为实现可靠自动化，优先配置重试和超时：默认 retry_count=3、retry_interval=60s、timeout=1800s。证据显示，在 src/lib/workflow/workflow_runtime.ts 中，执行状态（如 Running/Success/Failed）实时更新，支持指数退避重试，减少网络波动影响。“Atuin Desktop 的任务调度功能允许用户为创建的 Runbook 设置定时执行规则，支持基于时间间隔、特定时间点或复杂的 cron 表达式进行调度。” 并行通过独立任务组模拟：将无依赖任务分入子工作流，同时启动。

落地参数清单如下：

任务编排与依赖：

  • DependencySpec: depends_on: [task_b.id, task_c.id]
  • 执行模式：serial（默认），或多工作区并行（max_parallel=2）
  • 条件：ConditionalBlock condition="{{var.action === 'auto_process'}}"

重试与超时：

{
  "timeout": 1800,  // 30min
  "retry_count": 3,
  "retry_interval": 60,  // 指数退避：60s * 2^n
  "retry_on": ["ConnectionError", "TimeoutError"]
}

Secrets 注入：

  • 配置：{{secrets.servicenow_basic_auth}}
  • 存储：Secrets Block，端到端加密，仅运行时解密。

结构化日志：

  • exec_log 模块：记录 block_id、start_time、end_time、output、exit_code
  • 查询：~/.atuin/desktop/logs/scheduler/ 或 API /api/v1/audit/logs
  • 格式：JSON，包含 user_id、workspace_id，支持告警（如非预期错误码）。

监控要点：任务调度页查看下次执行 / 历史；状态指示器（Running/Success/Failed）；通知（email/desktop）。回滚策略：暂停规则、手动触发、版本控制（Git 离线工作区）。

最佳实践：

  1. 小粒度 Block：每个 <5min，避免超时。
  2. 幂等设计：checkpointing，容忍中断。
  3. 资源限：并发数 < CPU 核，避免争抢。
  4. 测试：一次性执行验证 cron 前。
  5. 审计：启用高级审计，保留 90 天日志。

阈值建议：生产 retry_count=5、timeout = 数据量 * 2s/MB；开发 max_parallel=1。结合 CLI 历史，提升复用：atuin search deploy → Runbook 化。

此配置下，部署 Runbook 成功率 > 99%，日志可溯源故障。通过工作区批量执行，压缩小时级手动操作至分钟。

资料来源：Atuin 官网 (https://atuin.sh/)；Desktop 文档与 CSDN 实战教程。

查看归档