dagu

环境要求

• Linux、macOS 或 Windows 系统
• 无需外部数据库或消息代理（Dagu 自带内置 Web UI）
• 使用 Docker 方式时需已安装 Docker
• 使用 Kubernetes 方式时需安装 Helm 并具备支持 ReadWriteMany 的 StorageClass

安装与启动步骤

1. 1脚本安装 Dagu

   macOS/Linux 下执行官方安装脚本，会启动向导，可将 Dagu 加入 PATH、设为后台服务并创建初始管理员账号。

   curl -fsSL https://raw.githubusercontent.com/dagucloud/dagu/main/scripts/installer.sh | bash

   复制

2. 2或用 Homebrew 安装

   macOS/Linux 已装 Homebrew 时可直接安装；此方式不运行安装向导。

   brew install dagu

   复制

3. 3编写工作流文件

   新建 hello.yaml，用声明式 YAML 定义 DAG 步骤，这里只有一个执行 echo 的步骤。

   cat > hello.yaml <<'EOF'
   steps:
     - id: hello
       run: echo "hello from Dagu"
   EOF

   复制

4. 4运行工作流

   用 dagu start 执行指定 YAML 文件，终端会输出步骤执行结果。

   dagu start hello.yaml

   复制

5. 5Docker 一键启动

   用官方镜像启动服务端、调度器和执行器，映射 8080 端口并挂载数据目录。

   docker run --rm -v ~/.dagu:/var/lib/dagu -p 8080:8080 ghcr.io/dagucloud/dagu:latest dagu start-all

   复制

6. 6Helm 部署到 K8s

   先添加并更新 dagu 仓库，再安装 Chart，存储类需支持 ReadWriteMany。

   helm repo add dagu https://dagucloud.github.io/dagu
   helm repo update
   helm install dagu dagu/dagu --set persistence.storageClass=<your-rwx-storage-class>

   复制

关键配置

如何确认成功

CLI 方式运行 hello.yaml 会输出 hello from Dagu；Docker 方式可访问 http://localhost:8080 打开 Web UI。

常见问题

注意事项

• 脚本安装（macOS/Linux 与 Windows）会运行引导向导，其余安装方式不会。
• Docker 运行方式若要执行容器步骤，需按官方文档配置 Docker 守护进程访问；挂载 Docker socket 会让工作流获得控制宿主守护进程的权限。
• Helm 安装时必须把 <your-rwx-storage-class> 替换为真实且支持 ReadWriteMany 的存储类。
• 同一份工作流 YAML 可用于单机、临时 worker 和分布式 worker 三种部署形态。