dagger

可编程的容器化构建与流水线引擎

补充说明

Dagger 用代码描述构建和流水线，所有步骤在容器中执行，可本地运行也可接入 CI。它通过模块和函数暴露操作，dagger call 是常用入口。

常用示例

dagger version
dagger init --sdk=go
dagger develop
dagger functions
dagger call test
dagger call build --output ./dist
dagger run go test ./...
dagger run npm test
dagger call container-echo --string-arg=hello stdout

易错点与排错

• Dagger 需要可用的容器运行时（Docker、Podman 或 Dagger Engine）；引擎没起来时命令会卡住或报连接错误。
• 模块函数要靠 dagger develop 生成绑定；改了 SDK 或依赖后要重新生成。
• 不同 Dagger 版本的 API 和 CLI 参数可能变化；在 dagger.json 里固定引擎版本。
• dagger call 的参数类型和函数签名必须匹配；先用 dagger functions 查看。
• 缓存能加速，但缓存键依赖输入声明；输入没声明会导致错误复用。
• 在 CI 中运行要确认引擎的权限和网络；嵌套容器和特权模式可能受限。
• Dagger Cloud 是可选的；没有 token 不影响本地运行，但会缺少远端缓存和追踪。
• 复杂流水线应拆成模块函数并写测试；把所有逻辑塞进一个 shell 步骤会失去可移植性。

相关命令

• docker — 容器运行时
• github-actions — 接入 CI
• gitlab-ci — 接入 CI