Workflow Engine

Galaxy-Flow

基于 GXL 的开源工作流引擎，用于定义流程、组织执行逻辑、编排工程动作，并把自动化过程沉淀为可复用工作流。

GXL Workflow Execution Reusable Automation

查看 Flow Repo 返回首页

Positioning

它解决的是流程定义与执行问题

Galaxy-Flow 的职责很清楚：把自动化流程写清楚、组织清楚、执行清楚。它关注的是流程模型、执行能力和工程动作编排，而不是系统交付结构。

Core Capabilities

关键特性

环境与流程分离

env 负责变量和上下文，flow 负责执行路径。环境切换不再和命令步骤混写在同一个脚本里。

流程与步骤灵活编排

支持前置、主流程、后置关系，也支持模块化复用与参数化调用。

内建事务与回滚

通过 #[transaction] 和 #[undo(...)] 显式定义失败后的回退关系，而不是把清理逻辑散落在脚本分支里。

执行结果可输出并可接入上报

执行结果会写入本地 report，日志和任务状态也可以接入上报链路，便于后续追踪与集成。

基于 Git 的外部 Mod 复用

支持通过 extern mod 直接引用远端仓库模块，例如 extern mod net { git = "https://example.com/repo.git", branch = "main"; }，也支持按 tag 或 channel 拉取。

配置文件模版化与受控修改

既可以通过 gx.tpl 生成模板化配置，也可以通过 gx.patch_file 按 marker 对现有文件做定点修改、注释或反注释，避免把配置变更散落在手写脚本里。

Boundary

为什么不是直接用 Python

Python 可以写自动化，行业里也有成熟 workflow runtime；但它们更多解决的是通用流程执行、调度和可靠性。Galaxy-Flow 解决的是另一层问题：把 Git Mod 复用、流程声明、回滚边界和运维动作统一进同一套模型。

Python 更适合

写单个脚本
处理局部逻辑
调用命令、接口和文件
作为某个流程步骤的实现手段

成熟 runtime 更适合

通用工作流执行
调度、重试与状态管理
长流程可靠运行
平台化编排与观测

Galaxy-Flow 额外解决

流程关系如何被定义成统一结构
环境、步骤、模板、命令如何放进同一套工作流模型
回滚关系如何被显式表达
自动化如何从“脚本集合”变成“可复用流程资产”

结论

Galaxy-Flow 不是在替代所有 workflow runtime，而是在提供一套更贴近交付与运维场景的流程语言和执行模型。

Python

runtime = DeliveryRuntime()
ops = runtime.load_git_mod("https://github.com/example/ops-mods.git", branch="main")
env = "prod"
def render():
    render_tpl("./tpls", "./out", "./values.json")
def patch():
    patch_file("./nginx.conf", marker="upstream", value="api_upstream")
def deploy():
    ops.deploy(env=env)
def rollback():
    run("./rollback.sh")
runtime.run_flow([render, patch, deploy], rollback=rollback)

Galaxy-Flow

extern mod ops { git = "https://github.com/example/ops-mods.git", branch = "main"; }
mod main {
  env prod : base;
  #[transaction, undo(rollback)]
  flow @release | render | patch | deploy;
  flow render   { gx.tpl(tpl: "./tpls", dst: "./out", file: "./values.json"); }
  flow patch    { gx.patch_file(file: "./nginx.conf", action: "set", marker: "upstream", value: "\"api_upstream\""); }
  flow deploy   { ops.deploy(env: "prod"); }
  flow rollback { gx.shell(shell: "./rollback.sh"); }
}

这个例子要表达的是：即便团队已经有成熟 runtime，仍然不等于已经有了 Galaxy-Flow 这一层能力。

通用 runtime 能解决“流程怎么跑”，但通常不会直接提供 extern mod 这样的 Git 模块复用模型，也不会把模板、配置修改、回滚关系和工程动作统一收进同一种语言结构。
如果团队要做到类似 load_git_mod(...)、run_flow(...) 这样的能力，通常还要在 runtime 之上再实现一层自己的交付或执行框架。
在 Galaxy-Flow 里，这些关系会直接落在 env、flow、gx.tpl、gx.patch_file、#[transaction]、#[undo(...)] 这些显式结构里。

Use Cases

适用场景

自动化工作流编排
构建、检查、模板处理与发布流程
工程动作封装与重复执行
从脚本到流程资产的重构

Galaxy-Flow is the execution layer

如果你要先理解“流程如何定义与执行”，从 Galaxy-Flow 开始。如果你要理解“系统如何组织与交付”，继续看 Galaxy-Ops。

查看 Galaxy-Ops 查看 Flow Repo