Dagu项目支持单文件中定义多工作流的YAML语法解析

在现代工作流自动化工具Dagu的最新版本中，引入了一项重要功能改进：允许用户在单个YAML文件中定义多个工作流(DAG)。这一特性显著提升了小型关联工作流的管理效率，特别是在处理具有父子关系的复杂工作流场景时。

多文档YAML语法支持

Dagu现在采用标准YAML文档分隔符(---)来实现单文件多工作流的定义。这种语法与Kubernetes等主流配置系统的多文档YAML格式保持一致，降低了用户的学习成本。每个分隔符后的内容被视为一个独立的工作流定义，系统会将其解析为不同的DAG对象。

典型应用场景

这项功能特别适合以下场景：

1. 主从工作流结构：当主工作流需要并行调用多个子工作流时，现在可以将它们全部定义在同一个文件中
2. 微服务工作流：相关联的小型工作流可以集中管理，避免文件碎片化
3. 测试场景：测试工作流与被测工作流可以放在一起，方便维护

语法规范与注意事项

实现该功能时，开发团队制定了明确的语法规范：

• 每个子工作流必须包含唯一的name字段作为标识符
• 引用子工作流时只需指定其名称
• 完全向后兼容现有的单工作流文件格式
• 文档分隔符前后可以包含YAML注释

技术实现解析

在底层实现上，Dagu的YAML解析器被增强为：

1. 首先按文档分隔符拆分原始文件内容
2. 然后对每个文档独立进行语法解析和验证
3. 最后构建完整的工作流依赖图

这种处理方式既保持了原有架构的简洁性，又提供了强大的多工作流支持能力。

最佳实践建议

基于此功能，我们推荐以下使用模式：

1. 将逻辑强相关的工作流组织在同一个文件中
2. 为主工作流和其直接调用的子工作流创建共享文件
3. 对独立性强或可能被多处引用的工作流保持单独文件
4. 在文件头部添加注释说明文件内包含的工作流及其关系

这一改进使得Dagu在复杂工作流编排方面更加灵活高效，同时保持了配置文件的简洁性和可维护性。