Dagger：更优的交付方式

Dagger 是一个用于自动化软件交付的平台。它能够可靠地大规模构建、测试并部署任何代码库。

Dagger 可以在本地运行，也可以在 CI 服务器上或直接在云端运行。

brew install dagger/tap/dagger

为什么选择 Dagger？

Dagger 让您的软件交付具备 可编程性、本地优先、可重复性 和 可观测性。

可编程性。用于自动化软件交付的 Shell 脚本和专有 YAML 已经不再适用。Dagger 提供：完整的执行引擎和系统 API；8 种语言的 SDK；交互式 REPL；丰富的可复用模块生态系统等。

本地优先。一旦您使用 Dagger 自动化某项任务，它就能在任何支持的环境中可靠运行：您的笔记本电脑、AI 沙盒、CI 服务器，或是专用的云基础设施。唯一的依赖是像 Docker 这样的容器运行时。

可重复性。工具在容器中运行，并由沙箱化的函数进行编排。宿主机依赖被显式定义且严格类型化。中间产物按需即时构建。默认情况下，所有操作都是增量式的，并提供高级缓存控制。无论是测试报告、构建产物还是部署结果，Dagger 都能为您提供值得信赖的输出。

可观测性。每项操作都会发出完整的 OpenTelemetry 跟踪信息，并附带细粒度的日志和指标。您可以在终端中直接可视化跟踪，也可以通过 Web 界面查看。无需再从大段文本日志中猜测问题所在，即可立即调试复杂的工作流。

功能特性

系统 API。跨语言的 API，用于编排容器、文件系统、密钥、Git 仓库、网络隧道等资源。所有操作都具有类型安全，并且可以自由组合。

8 种语言的 SDK。为 Go、Python、TypeScript、PHP、Java、.NET、Elixir 和 Rust 提供原生 SDK。每个 SDK 均基于 API 模式生成，因此您可以获得符合语言习惯、具备完整类型安全性和编辑器支持的代码。

类型化工件。定义带有封装状态和方法的自定义对象类型。这些类型采用内容寻址，可在不同 SDK 语言边界和模块边界之间传递，而无需序列化。

增量式执行。每项操作都根据其输入进行键值索引。只需更改一个文件，只有受影响的操作才会重新运行。缓存采用内容寻址，在本地运行和 CI 环境中都能自动生效。

随处运行。唯一的要求是 Linux 容器运行时。在 Linux 上可原生运行，而在 macOS 和 Windows 上则可通过 Docker Desktop 等工具运行。本地与 CI 环境的行为完全一致。

内置追踪。每项操作都会生成 OpenTelemetry 的跨度。命令行工具包含实时 TUI；跟踪数据也可导出到 Jaeger、Honeycomb 或任何兼容 OTel 的后端。

开始使用

• 文档
• 快速入门

社区

• Discord
• GitHub 讨论区

贡献

请参阅 CONTRIBUTING.md。

Dagger 快速上手指南

Dagger 是一个用于自动化软件交付的平台，支持在本地、CI 服务器或云端可靠地构建、测试和部署代码。它将交付流程变为可编程、本地优先、可重复且可观测的体验。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：
  • Linux（原生支持）
  • macOS 或 Windows（需安装 Docker Desktop 或兼容的容器运行时）
• 前置依赖：
  • 必须安装 Linux 容器运行时（如 Docker）。Dagger 的所有操作均在容器中沙箱化运行。
  • 根据您的开发语言偏好，安装对应的运行时环境（如 Node.js, Python, Go 等），以便使用相应的 SDK。

安装步骤

推荐使用 Homebrew（macOS/Linux）进行安装。如果您在中国大陆地区，建议先配置 Homebrew 国内镜像以加速下载。

1. 配置 Homebrew 国内镜像（可选但推荐）

export HOMEBREW_BOTTLE_HOST=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
export HOMEBREW_CORE_GIT_REMOTE=https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
export HOMEBREW_CASK_GIT_REMOTE=https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

2. 安装 Dagger

执行以下命令添加 Dagger 源并安装：

brew tap dagger/tap
brew install dagger/tap/dagger

注意：如果未使用 Homebrew，也可通过直接下载二进制文件或使用其他包管理器安装，具体请参考官方文档。

基本使用

Dagger 的核心优势在于“本地优先”。您可以直接在终端使用交互式 REPL 探索功能，或使用支持的编程语言编写脚本。

方式一：使用交互式 CLI (REPL)

安装完成后，直接输入 dagger 进入交互模式。您可以在此处组合容器操作、查看实时追踪日志。

dagger shell

在 REPL 中尝试一个简单的构建任务（示例逻辑）：

# 加载一个基础镜像
from("alpine:latest") 
# 执行命令
withExec(["apk", "add", "--no-cache", "curl"]) 
# 查看结果
stdout()

方式二：使用 SDK 编写脚本 (以 TypeScript 为例)

Dagger 支持 8 种语言的原生 SDK。以下是一个最简单的 TypeScript 示例，展示如何定义一个构建流程：

1. 初始化项目并安装 SDK：

npm init -y
npm install @dagger.io/dagger

2. 创建 index.ts 文件：

import { Client, Container } from "@dagger.io/dagger";

async function main() {
  await new Client().connect(async (client) => {
    // 定义一个基于 Node 镜像的容器
    const nodeContainer: Container = client.container()
      .from("node:20-slim")
      .withExec(["node", "--version"]);

    // 执行并输出结果
    const version = await nodeContainer.stdout();
    console.log("Node version:", version);
  });
}

main();

3. 运行脚本：

tsx index.ts

核心体验：

• 可观测性：运行过程中，Dagger CLI 会自动弹出终端 UI (TUI)，实时展示每一步操作的 OpenTelemetry 追踪链路和日志，无需猜测错误原因。
• 增量缓存：修改代码后再次运行，未受影响的步骤将自动跳过，利用内容寻址缓存加速执行。

更多详细用法和模块示例，请访问 Dagger 官方文档。