尧图网页设计 
Dagger v0.21.5 版本发布解析container.exists 的 expand 选项、Dang v1/v2 双版本路由与关键修复清单【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/daggerDagger v0.21.5 发布于 2026-06-10是一个以语言运行时分叉和缓存正确性为主线的特性版本。读完本文你能掌握本版本引入的container.exists路径环境变量展开能力、模块按engineVersion路由到 Dang v1 或 v2 语言语义的机制并逐条了解磁盘压力下的本地缓存修剪、trivial 对象持久化等 16 项变更与修复的源码级依据从而判断该版本对你现有模块尤其是engineVersion较低的老模块的影响范围。一、版本概览变更全景v0.21.5 的完整变更清单分为四个部分Added / Changed / Fixed共 16 个条目。按照与仓库源码的对应关系可以归纳为四条主线语言运行时Dang 语言同时支持 v1 与 v2 两套语义按模块engineVersion路由PR #13388并配套两个 Dang 语义修复PR #13377、#13318API 扩展container.exists新增expand选项PR #13310缓存与持久化磁盘压力时修剪本地缓存PR #13375、持久化 trivial 核心对象PR #13387外加一组镜像元数据缓存修复PR #13341、#13346正确性修复TypeScript SDK 在 Bun 运行时上的 exec 错误呈现、filesync 导入身份忽略 host xattr、lazy 容器父链保留、withChanges 父层保留、snapshot owner lease 竞态、layercopy 符号链接跟随、git 遥测标签不再浅克隆用户仓库等。二、新增能力一container.exists支持expand展开路径环境变量2.1 变更内容本版本为Container.exists查询新增了expand布尔参数默认false。开启后path参数中的$VAR/${VAR}形式占位符会用容器自身的镜像环境变量展开使检查由环境变量指定的路径是否存在这类场景无需先取出变量值。2.2 源码实现拆解在 schema 层参数结构体位于 core/schema/container.gotype containerExistsArgs struct { Path string ExpectedType dagql.Optional[core.ExistsType] DoNotFollowSymlinks bool default:false Expand bool default:false // 本版本新增 }exists解析函数core/schema/container.go#L2599-L2619的执行顺序是通过cache.Evaluate(ctx, parent)先求值父容器对象调用expandEnvVar(ctx, parent.Self(), args.Path, args.Expand)处理路径将展开后的路径传给parent.Self().Exists(...)。expand的核心逻辑在 core/schema/container.go#L3445-L3485 的expandEnvVar函数中值得注意三个细节展开来源是镜像配置函数先调用parent.ImageConfig(ctx)再用os.Expand遍历$VAR形式引用从cfg.Env中取值。即展开只使用容器声明的环境变量不涉及运行时注入安全边界如果展开引用了 secret 环境变量parent.Secrets或 volatile 环境变量会直接报错expand cannot be used with secret env variable/expand cannot be used with volatile env variable防止敏感值经由路径查询泄漏到缓存键或日志中默认关闭Expand默认false未显式开启时行为与本版本之前完全一致向后兼容。在引擎核心侧(*Container).Exists实现于 core/container.go#L6360-L6410它先用locatePath把目标路径定位到 rootfs 或某个目录挂载点然后分别通过srv.Select转调Directory.exists携带path、expectedType、doNotFollowSymlinks参数。这也解释了expand为何设计在 schema 层而非核心层——环境变量属于 DAG 对象的声明状态在 schema 层展开路径后核心层只需接收一个具体路径即可。2.3 使用方式在 Dagger 查询中典型用法为对path使用环境变量占位符并显式开启expand例如检查/opt/${APP_DIR}/bin形式的路径。该参数与expectedType、doNotFollowSymlinks正交组合可精确表达某类型文件/目录/符号链接是否在指定路径存在的断言。三、新增能力二Dang v1 与 v2 双版本支持按engineVersion路由这是本版本最重要的架构级变更引擎同时内嵌两套 Dang 语言运行时按模块声明的engineVersion把每个模块路由到匹配的版本使既有模块保持其编写时所依赖的语言语义。3.1 版本门槛v0.21.5 即分界线路由门槛常量定义在 engine/version.go#L45-L48// MinimumDangV2ModuleVersion is the minimum module engine version that gets // Dang v2 semantics (.{ } is dot-block application, .{{ }} is // selection); older modules keep Dang v1 semantics (.{ } is selection). MinimumDangV2ModuleVersion v0.21.5语义差异的关键在点选语法Dang v1.{ }是字段选择selectionDang v2.{ }变为点块应用dot-block application选择改为.{{ }}。也就是说engineVersion低于v0.21.5的模块继续使用 v1 语义v0.21.5及以上的模块进入 v2 语义。3.2 路由机制SDK 分派器从 core/sdk/dang/README.md 可以确认仓库中完整的版本支持布局组件包角色core/sdk/dang_sdk.gosdk分派器持有与版本无关的core.SDK行为每次调用经dangImplFor选择具体实现shared/dangshared版本无关管道嵌套客户端代理服务器、客户端元数据、错误转换禁止 import 任何大版本的github.com/vito/dangv2/dangv2活动living实现importgithub.com/vito/dang/v2所有新功能都在这里开发v1/dangv1冻结快照服务于engineVersion v0.21.5的模块冻结时与活动包字节一致仅包名、注释与 import 路径不同分派逻辑在 core/sdk/dang_sdk.go 中dangImplFor将模块的engineVersion经engine.NormalizeVersion归一化后与engine/version.go中的MinimumDangV*ModuleVersion常量做最新优先阶梯比较命中则返回dangv2.Impl{}否则回退dangv1.Impl{}。该 README 同时给出了维护政策对使用者有实际意义功能只加到活动包当前是 v2新 Dagger 特性必然要求新的engineVersion而新engineVersion总是路由到最新大版本因此冻结大版本永远不需要补功能引擎侧胶合层类型转换、调用分派的 bug 修复修活动包仅当影响老模块时才回移冻结包Dang 语言本身的 bug走上游维护分支打补丁例如release/v1分支上的 v1.0.x tag。3.3 对模块开发者的影响dagger.json中engineVersion字段本仓库集成测试 core/integration/engine_test.go 中有大量以engineVersion: v2.0.0等形式固定模块版本的用例成为决定语言语义的开关旧模块零改动即可获得与之前一致的行为这是本版本Support both Dang v1 and v2承诺的实现方式若要使用 v2 新语法点块应用需要将模块engineVersion提升到v0.21.5或更高。四、行为变更磁盘压力修剪与 trivial 对象持久化4.1 磁盘压力期间修剪本地缓存PR #13375引擎在本地磁盘空间紧张时会自动修剪prune本地缓存。缓存修剪的实现集中在 dagql/cache_prune.go配套测试 dagql/cache_prune_test.go。对使用者的影响是在磁盘压力场景下Dagger 不再依赖人工清理会按内部策略回收缓存空间同时意味着在极端磁盘压力下部分可再生的构建缓存可能被提前回收再次执行相应步骤时会出现缓存未命中。4.2 持久化 trivial 核心对象PR #13387trivial 对象指状态简单、可直接物化的核心对象。本版本将其纳入持久化路径减少跨会话恢复时的重新求值。相关持久化实现分布在 dagql/cache_persistence_self.go、dagql/cache_persistence_resolver.go 等文件中。从源码结构看这类变更降低了引擎重启后恢复历史对象图的开销属于性能与可恢复性改进不改变查询语义。五、缺陷修复逐项解析5.1 Dang 语言与模块系统3 项修复命名空间类型名 mangling 与跨依赖接口分派PR #13377Dang 模块在跨依赖cross-dependency调用时带命名空间的类型名在 mangle 后会出现接口分派错误本版本修正了该映射。这直接影响多模块 workspace 中按接口消费其他模块类型的场景接口符合性不再要求id字段PR #13318此前模块接口interface conformance要求类型声明id字段对不符合的模块产生不必要的报错本版本移除了该硬性要求scale-out 使用模块本地 check 名称PR #13329修复了模块在 scale-out 场景下 check 命名冲突/错乱的问题使同一模块在分布式执行时 check 名称保持模块局部一致。5.2 缓存与镜像元数据2 项缓存注册表镜像元数据PR #13341Registry 拉取时的镜像元数据清单、config 等现在会被缓存避免同一镜像在短时间内重复查询注册表不完整的镜像元数据视为缓存未命中PR #13346与上一条配套的健壮性修复——若缓存中的镜像元数据不完整不再被当作可用命中而是按 miss 处理重新获取防止基于残缺元数据构建出错误结果。这两项修复的组合效应是镜像元数据查询既更快又不会因为缓存中残留残缺数据而产出错误构建。5.3 容器状态与层操作2 项保留 pending 的 lazy 容器父链PR #13365lazy 求值模式下尚未物化的容器父对象引用会被完整保留修复了父链丢失导致的对象图重建错误保留withChanges的父层PR #13342withChanges操作现在正确保留父容器的既有层避免层被意外丢弃导致的镜像膨胀或内容丢失。5.4 TypeScript SDK 运行时1 项Bun 运行时正确呈现 exec 错误PR #13395TypeScript SDK 在 Bun 运行时上执行exec失败时错误信息此前无法正确透传给调用者本版本修复了错误表面化路径使失败原因非零退出码、stderr在 Bun 环境下与 Node 环境表现一致。5.5 文件同步与存储2 项filesync 本地导入身份忽略 host xattrPR #13389本地文件经 filesync 导入时文件标识identity计算不再包含宿主机扩展属性xattr。这消除了因不同宿主机/挂载点 xattr 差异导致的同一文件被判定为不同内容的问题。实现位于 engine/filesync/ 目录layercopy 复制目录内容时跟随源符号链接PR #13326util/layercopy/ 在拷贝目录内容时对源侧 symlink 现在会跟随解析修复了符号链接指向的内容被丢失或保留为悬空链接的问题。5.6 引擎基础设施2 项修复 snapshot owner lease 挂载/摘除竞态PR #13321快照属主租约lease的 attach 与 remove 存在并发竞态本版本修复了该 racegit 遥测标签不再浅克隆用户仓库PR #13363为采集 git 遥测标签而进行的仓库克隆此前使用 shallow clone可能对用户的仓库克隆行为产生副作用现改为避免浅克隆用户仓库。六、版本影响评估与升级建议从本版本的变更构成看v0.21.5 的关键决策点只有一个你的模块engineVersion是否已达到 v0.21.5 门槛。若模块engineVersion低于v0.21.5语言语义保持 Dang v1.{ }为选择本版本对该模块的行为是纯修复性的可放心升级若计划启用 Dang v2 语法.{{ }}选择、点块应用需要将dagger.json的engineVersion提升至v0.21.5及以上并参考 core/sdk/dang/README.md 中关于语义差异的说明使用container.exists做路径存在性断言的查询脚本可评估引入expand参数以简化基于环境变量的路径拼接对镜像元数据敏感的高频拉取场景CI 中反复 build 同一基础镜像可受益于 PR #13341 引入的元数据缓存同时注意 PR #13346 保证缓存数据完整性。如需继续深入建议直接查阅 core/schema/container.go 中exists解析链、engine/version.go 中的版本门槛常量以及 dagql/cache_prune.go 与 dagql/cache_persistence_self.go 了解缓存修剪与持久化的具体实现。【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Dagger v0.21.5 版本发布解析：container.exists 的 expand 选项、Dang v1/v2 双版本路由与关键修复清单
Dagger v0.21.5 版本发布解析container.exists 的 expand 选项、Dang v1/v2 双版本路由与关键修复清单【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/daggerDagger v0.21.5 发布于 2026-06-10是一个以语言运行时分叉和缓存正确性为主线的特性版本。读完本文你能掌握本版本引入的container.exists路径环境变量展开能力、模块按engineVersion路由到 Dang v1 或 v2 语言语义的机制并逐条了解磁盘压力下的本地缓存修剪、trivial 对象持久化等 16 项变更与修复的源码级依据从而判断该版本对你现有模块尤其是engineVersion较低的老模块的影响范围。一、版本概览变更全景v0.21.5 的完整变更清单分为四个部分Added / Changed / Fixed共 16 个条目。按照与仓库源码的对应关系可以归纳为四条主线语言运行时Dang 语言同时支持 v1 与 v2 两套语义按模块engineVersion路由PR #13388并配套两个 Dang 语义修复PR #13377、#13318API 扩展container.exists新增expand选项PR #13310缓存与持久化磁盘压力时修剪本地缓存PR #13375、持久化 trivial 核心对象PR #13387外加一组镜像元数据缓存修复PR #13341、#13346正确性修复TypeScript SDK 在 Bun 运行时上的 exec 错误呈现、filesync 导入身份忽略 host xattr、lazy 容器父链保留、withChanges 父层保留、snapshot owner lease 竞态、layercopy 符号链接跟随、git 遥测标签不再浅克隆用户仓库等。二、新增能力一container.exists支持expand展开路径环境变量2.1 变更内容本版本为Container.exists查询新增了expand布尔参数默认false。开启后path参数中的$VAR/${VAR}形式占位符会用容器自身的镜像环境变量展开使检查由环境变量指定的路径是否存在这类场景无需先取出变量值。2.2 源码实现拆解在 schema 层参数结构体位于 core/schema/container.gotype containerExistsArgs struct { Path string ExpectedType dagql.Optional[core.ExistsType] DoNotFollowSymlinks bool default:false Expand bool default:false // 本版本新增 }exists解析函数core/schema/container.go#L2599-L2619的执行顺序是通过cache.Evaluate(ctx, parent)先求值父容器对象调用expandEnvVar(ctx, parent.Self(), args.Path, args.Expand)处理路径将展开后的路径传给parent.Self().Exists(...)。expand的核心逻辑在 core/schema/container.go#L3445-L3485 的expandEnvVar函数中值得注意三个细节展开来源是镜像配置函数先调用parent.ImageConfig(ctx)再用os.Expand遍历$VAR形式引用从cfg.Env中取值。即展开只使用容器声明的环境变量不涉及运行时注入安全边界如果展开引用了 secret 环境变量parent.Secrets或 volatile 环境变量会直接报错expand cannot be used with secret env variable/expand cannot be used with volatile env variable防止敏感值经由路径查询泄漏到缓存键或日志中默认关闭Expand默认false未显式开启时行为与本版本之前完全一致向后兼容。在引擎核心侧(*Container).Exists实现于 core/container.go#L6360-L6410它先用locatePath把目标路径定位到 rootfs 或某个目录挂载点然后分别通过srv.Select转调Directory.exists携带path、expectedType、doNotFollowSymlinks参数。这也解释了expand为何设计在 schema 层而非核心层——环境变量属于 DAG 对象的声明状态在 schema 层展开路径后核心层只需接收一个具体路径即可。2.3 使用方式在 Dagger 查询中典型用法为对path使用环境变量占位符并显式开启expand例如检查/opt/${APP_DIR}/bin形式的路径。该参数与expectedType、doNotFollowSymlinks正交组合可精确表达某类型文件/目录/符号链接是否在指定路径存在的断言。三、新增能力二Dang v1 与 v2 双版本支持按engineVersion路由这是本版本最重要的架构级变更引擎同时内嵌两套 Dang 语言运行时按模块声明的engineVersion把每个模块路由到匹配的版本使既有模块保持其编写时所依赖的语言语义。3.1 版本门槛v0.21.5 即分界线路由门槛常量定义在 engine/version.go#L45-L48// MinimumDangV2ModuleVersion is the minimum module engine version that gets // Dang v2 semantics (.{ } is dot-block application, .{{ }} is // selection); older modules keep Dang v1 semantics (.{ } is selection). MinimumDangV2ModuleVersion v0.21.5语义差异的关键在点选语法Dang v1.{ }是字段选择selectionDang v2.{ }变为点块应用dot-block application选择改为.{{ }}。也就是说engineVersion低于v0.21.5的模块继续使用 v1 语义v0.21.5及以上的模块进入 v2 语义。3.2 路由机制SDK 分派器从 core/sdk/dang/README.md 可以确认仓库中完整的版本支持布局组件包角色core/sdk/dang_sdk.gosdk分派器持有与版本无关的core.SDK行为每次调用经dangImplFor选择具体实现shared/dangshared版本无关管道嵌套客户端代理服务器、客户端元数据、错误转换禁止 import 任何大版本的github.com/vito/dangv2/dangv2活动living实现importgithub.com/vito/dang/v2所有新功能都在这里开发v1/dangv1冻结快照服务于engineVersion v0.21.5的模块冻结时与活动包字节一致仅包名、注释与 import 路径不同分派逻辑在 core/sdk/dang_sdk.go 中dangImplFor将模块的engineVersion经engine.NormalizeVersion归一化后与engine/version.go中的MinimumDangV*ModuleVersion常量做最新优先阶梯比较命中则返回dangv2.Impl{}否则回退dangv1.Impl{}。该 README 同时给出了维护政策对使用者有实际意义功能只加到活动包当前是 v2新 Dagger 特性必然要求新的engineVersion而新engineVersion总是路由到最新大版本因此冻结大版本永远不需要补功能引擎侧胶合层类型转换、调用分派的 bug 修复修活动包仅当影响老模块时才回移冻结包Dang 语言本身的 bug走上游维护分支打补丁例如release/v1分支上的 v1.0.x tag。3.3 对模块开发者的影响dagger.json中engineVersion字段本仓库集成测试 core/integration/engine_test.go 中有大量以engineVersion: v2.0.0等形式固定模块版本的用例成为决定语言语义的开关旧模块零改动即可获得与之前一致的行为这是本版本Support both Dang v1 and v2承诺的实现方式若要使用 v2 新语法点块应用需要将模块engineVersion提升到v0.21.5或更高。四、行为变更磁盘压力修剪与 trivial 对象持久化4.1 磁盘压力期间修剪本地缓存PR #13375引擎在本地磁盘空间紧张时会自动修剪prune本地缓存。缓存修剪的实现集中在 dagql/cache_prune.go配套测试 dagql/cache_prune_test.go。对使用者的影响是在磁盘压力场景下Dagger 不再依赖人工清理会按内部策略回收缓存空间同时意味着在极端磁盘压力下部分可再生的构建缓存可能被提前回收再次执行相应步骤时会出现缓存未命中。4.2 持久化 trivial 核心对象PR #13387trivial 对象指状态简单、可直接物化的核心对象。本版本将其纳入持久化路径减少跨会话恢复时的重新求值。相关持久化实现分布在 dagql/cache_persistence_self.go、dagql/cache_persistence_resolver.go 等文件中。从源码结构看这类变更降低了引擎重启后恢复历史对象图的开销属于性能与可恢复性改进不改变查询语义。五、缺陷修复逐项解析5.1 Dang 语言与模块系统3 项修复命名空间类型名 mangling 与跨依赖接口分派PR #13377Dang 模块在跨依赖cross-dependency调用时带命名空间的类型名在 mangle 后会出现接口分派错误本版本修正了该映射。这直接影响多模块 workspace 中按接口消费其他模块类型的场景接口符合性不再要求id字段PR #13318此前模块接口interface conformance要求类型声明id字段对不符合的模块产生不必要的报错本版本移除了该硬性要求scale-out 使用模块本地 check 名称PR #13329修复了模块在 scale-out 场景下 check 命名冲突/错乱的问题使同一模块在分布式执行时 check 名称保持模块局部一致。5.2 缓存与镜像元数据2 项缓存注册表镜像元数据PR #13341Registry 拉取时的镜像元数据清单、config 等现在会被缓存避免同一镜像在短时间内重复查询注册表不完整的镜像元数据视为缓存未命中PR #13346与上一条配套的健壮性修复——若缓存中的镜像元数据不完整不再被当作可用命中而是按 miss 处理重新获取防止基于残缺元数据构建出错误结果。这两项修复的组合效应是镜像元数据查询既更快又不会因为缓存中残留残缺数据而产出错误构建。5.3 容器状态与层操作2 项保留 pending 的 lazy 容器父链PR #13365lazy 求值模式下尚未物化的容器父对象引用会被完整保留修复了父链丢失导致的对象图重建错误保留withChanges的父层PR #13342withChanges操作现在正确保留父容器的既有层避免层被意外丢弃导致的镜像膨胀或内容丢失。5.4 TypeScript SDK 运行时1 项Bun 运行时正确呈现 exec 错误PR #13395TypeScript SDK 在 Bun 运行时上执行exec失败时错误信息此前无法正确透传给调用者本版本修复了错误表面化路径使失败原因非零退出码、stderr在 Bun 环境下与 Node 环境表现一致。5.5 文件同步与存储2 项filesync 本地导入身份忽略 host xattrPR #13389本地文件经 filesync 导入时文件标识identity计算不再包含宿主机扩展属性xattr。这消除了因不同宿主机/挂载点 xattr 差异导致的同一文件被判定为不同内容的问题。实现位于 engine/filesync/ 目录layercopy 复制目录内容时跟随源符号链接PR #13326util/layercopy/ 在拷贝目录内容时对源侧 symlink 现在会跟随解析修复了符号链接指向的内容被丢失或保留为悬空链接的问题。5.6 引擎基础设施2 项修复 snapshot owner lease 挂载/摘除竞态PR #13321快照属主租约lease的 attach 与 remove 存在并发竞态本版本修复了该 racegit 遥测标签不再浅克隆用户仓库PR #13363为采集 git 遥测标签而进行的仓库克隆此前使用 shallow clone可能对用户的仓库克隆行为产生副作用现改为避免浅克隆用户仓库。六、版本影响评估与升级建议从本版本的变更构成看v0.21.5 的关键决策点只有一个你的模块engineVersion是否已达到 v0.21.5 门槛。若模块engineVersion低于v0.21.5语言语义保持 Dang v1.{ }为选择本版本对该模块的行为是纯修复性的可放心升级若计划启用 Dang v2 语法.{{ }}选择、点块应用需要将dagger.json的engineVersion提升至v0.21.5及以上并参考 core/sdk/dang/README.md 中关于语义差异的说明使用container.exists做路径存在性断言的查询脚本可评估引入expand参数以简化基于环境变量的路径拼接对镜像元数据敏感的高频拉取场景CI 中反复 build 同一基础镜像可受益于 PR #13341 引入的元数据缓存同时注意 PR #13346 保证缓存数据完整性。如需继续深入建议直接查阅 core/schema/container.go 中exists解析链、engine/version.go 中的版本门槛常量以及 dagql/cache_prune.go 与 dagql/cache_persistence_self.go 了解缓存修剪与持久化的具体实现。【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考