视频教程：CLI工作流编排

视频教程：CLI工作流编排

视频概述

项目	内容
视频标题	RAILWISE-CLI 工作流编排进阶
视频时长	约25分钟
难度等级	⭐⭐⭐ 高级
目标观众	已掌握CLI基础的工程师、自动化需求用户
配套版本	CLI v2.0+

完成本视频学习后，您将能够：

• 定义和配置CLI工作流
• 编排多步骤自动化任务
• 设置定时执行和触发器
• 监控工作流执行状态

前置知识

前置知识	掌握程度	说明
CLI基础操作	掌握	已掌握数据导入、计算、导出
YAML格式	了解	了解YAML基本语法
自动化概念	了解	了解任务调度、依赖关系等概念

步骤详解

步骤1：工作流基础（约5分钟）

操作内容：

1. 查看工作流帮助：

railwise workflow --help

2. 创建示例工作流：

railwise workflow create --name "daily-processing" --template daily

3. 查看工作流定义：

cat ~/railwise-workspace/workflows/daily-processing.yaml

[截图占位符：工作流YAML文件内容]

步骤2：自定义工作流（约8分钟）

操作内容：

1. 编辑工作流定义：

daily-processing.yaml

name: "daily-processing"
version: "1.0"
trigger:
  schedule: "0 6 * * *"  # 每天6点执行
steps:
  - name: "import-data"
    command: "data import --format csv --dir ./data/inbox/"

  - name: "clean-data"
    command: "data clean --method outlier"
    depends_on: ["import-data"]

  - name: "calculate-settlement"
    command: "calc settlement --baseline yesterday"
    depends_on: ["clean-data"]

  - name: "generate-report"
    command: "export --format pdf --template daily --output ./reports/"
    depends_on: ["calculate-settlement"]

  - name: "send-notification"
    command: "notify --channel email --template daily-report"
    depends_on: ["generate-report"]

2. 验证工作流定义：

railwise workflow validate --name "daily-processing"

[截图占位符：工作流验证通过]

步骤3：执行工作流（约5分钟）

操作内容：

1. 手动执行工作流：

railwise workflow run --name "daily-processing"

2. 查看执行状态：

railwise workflow status --name "daily-processing"

3. 查看执行日志：

railwise workflow logs --name "daily-processing" --last

[截图占位符：工作流执行状态及日志]

步骤4：定时调度（约4分钟）

操作内容：

1. 启用定时调度：

railwise workflow schedule --name "daily-processing" --enable

2. 查看调度状态：

railwise workflow schedule --name "daily-processing" --status

3. 禁用调度：

railwise workflow schedule --name "daily-processing" --disable

[截图占位符：调度状态显示]

步骤5：监控与告警（约3分钟）

操作内容：

1. 设置告警规则：

railwise workflow alert --name "daily-processing" --on-failure --channel email

2. 查看执行历史：

railwise workflow history --name "daily-processing" --limit 10

[截图占位符：执行历史列表]

关键操作要点

要点	说明	重要性
依赖关系	使用 depends_on 定义步骤执行顺序	⭐⭐⭐
错误处理	设置 on_error 处理步骤失败	⭐⭐⭐
定时调度	使用Cron表达式设置执行时间	⭐⭐
日志监控	定期检查执行日志	⭐⭐
告警配置	配置失败告警及时响应	⭐⭐

常见问题

Q1: 工作流执行失败

原因：步骤依赖错误或命令参数错误

解决：

# 查看详细日志
railwise workflow logs --name "daily-processing" --verbose

# 单步调试
railwise workflow run --name "daily-processing" --step "import-data"

Q2: 定时调度不生效

原因：调度服务未启动

解决：

# 启动调度服务
railwise daemon start

# 检查服务状态
railwise daemon status

课后练习

练习1：创建工作流

创建一个“weekly-report”工作流，每周一早上8点执行数据汇总和周报生成。

练习2：错误处理

为工作流添加错误处理步骤，当数据处理失败时发送告警邮件。

练习3：条件执行

添加条件判断，只有当数据量大于100条时才生成报告。

---

相关文档

• CLI工作流编排
• 自动化监测脚本
• CLI故障排查