如何在Golang项目中引入Dagger完成容器化流水线

首先需要明确一点：Dagger 本质上是一个独立的 CI/CD 引擎，而不是 Go 语言生态里那种能直接用 go get 拉下来、在代码里 import 的库。官方没有提供标准的 Go SDK，社区实现的版本既不稳定也不被推荐。所以，所谓“在 Go 项目中引入 Dagger”，正确的理解是把 Dagger 当作一个外部 CLI 工具来集成——通过工作流中的 dagger do 来调用你定义好的函数，而不是在 main.go 里写 import "dagger.io/dagger"。

为什么 Dagger 不适合直接“引入”进 Go 项目

这其实是个很常见的误解。Dagger 不是 Go 的库，也不是 go mod 能管理的依赖。你没法用 go get 安装它，更不可能在代码里 import "dagger.io/dagger"。所谓“引入”，本质上是把 Dagger 当作外部工具链，集成进你的 Go 项目工作流——它位于项目之外，而不是语言级别依赖。

本地安装 Dagger CLI 并验证是否可用

所有 Dagger 流水线都依赖 dagger 这个 CLI 来驱动，所以第一步是在开发机或 CI 环境里把它装好。Go 项目本身不会感知 Dagger，但你的构建脚本和 CI 配置需要能调用它。

• macOS：Homebrew 用户直接运行 brew install dagger/tap/dagger
• Linux / macOS 手动：下载二进制文件并加到 $PATH，比如 curl -L https://dl.dagger.io/dagger/install.sh | sh
• 验证：运行 dagger version，输出应包含版本号；再跑 dagger init，看能否生成 dagger.json

需要特别注意的是：Dagger CLI 依赖 Docker 或 Podman（需要后台 daemon 运行）。如果 dagger version 报错 Cannot connect to the Docker daemon，那说明容器运行时没启动，这不是 Dagger 的问题。

用 dagger init 生成基础配置并适配 Go 构建场景

dagger init 会创建 dagger.json 和一个默认的 dagger/main.go（基于 Go SDK 模板）。不过这只是个起点，你需要手动改写函数逻辑，让它真正去 build 你的 Go 服务。

• 确认 dagger/main.go 中的 Build 函数调用的是你项目的 go build 命令，而不是模板里的 demo 代码
• 用 WithExec([]string{"go", "build", "-o", "./bin/app", "."}) 替换默认命令，路径要和你项目结构匹配
• 如果需要静态编译（比如 CGO_ENABLED=0），要显式设置环境变量：WithEnvVariable("CGO_ENABLED", "0")
• Go module 路径需与 go.mod 保持一致；Dagger 默认工作目录是项目根，如果 go.mod 在子目录（比如 src/），要用 WithWorkdir("src")

示例代码片段：

func (m *Main) Build(ctx context.Context) (*File, error) {
    return dag.Container().
        From("golang:1.22-alpine").
        WithMountedDirectory("/app", dag.WorkingDirectory()).
        WithWorkdir("/app").
        WithEnvVariable("CGO_ENABLED", "0").
        WithExec([]string{"go", "build", "-o", "./bin/app", "."}).
        File("./bin/app")
}

CI 中调用 dagger do 而不是 go run

在 GitHub Actions 或 GitLab CI 里，千万别写成 go run dagger/main.go。Dagger 流水线必须通过 dagger do 触发——这是最容易踩的坑：很多人以为写个 Go 文件就能直接跑，结果 CI 报错 command not found: dagger 或 no function named 'Build'。

• 确保 CI 步骤先安装 dagger CLI（用 setup-dagger action 或手动 curl）
• 用 dagger do build 调用函数（函数名默认小写，除非用 //+dagger:output 注释覆盖）
• 函数参数需要显式传入：比如 dagger do build --target-arch amd64 对应 func Build(ctx context.Context, targetArch string)
• 输出文件用 --output ./dist/app 保存，后续步骤才能拿到

复杂之处在于：Dagger 函数返回 *File 或 *Directory，这些对象只在 Dagger 执行上下文中有效，不能直接当作本地文件路径使用。想存到 CI 工作区，必须显式调用 .Export() 或用 --output 参数。