尧图网页设计 
Dagger TypeScript SDK 中 ContainerWithSymlinkOpts 详解容器内符号链接与环境变量展开【免费下载链接】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本篇技术指南以 Dagger 项目docs/versioned_docs/version-0.21/reference/typescript/api/client.gen/type-aliases/ContainerWithSymlinkOpts.md为核心系统讲解 TypeScript SDK 中ContainerWithSymlinkOpts类型别名的定义与用法。该类型用于配置Container.withSymlink()调用时的行为选项其唯一可选属性expand控制链接路径中$VAR/${VAR}是否按容器内环境变量展开。读完本文你将掌握在 Dagger 流水线中创建符号链接、利用环境变量动态构造路径的完整实战方法并理解该选项从 GraphQL Schema 到引擎底层快照实现的完整调用链。一、ContainerWithSymlinkOpts类型定义ContainerWithSymlinkOpts是 Dagger TypeScript SDK 为Container.withSymlink()方法提供的选项对象类型。根据 类型别名文档它定义为一个object类型结构如下type ContainerWithSymlinkOpts { /** * Replace ${VAR} or $VAR in the value of path according to the current * environment variables defined in the container (e.g. /$VAR/foo.txt). */ expand?: boolean }属性一览属性类型必填默认值说明expandboolean可选false是否在target与linkName路径值中按容器当前定义的环境变量展开${VAR}或$VAR占位符在生成的 SDK 源码中该类型定义位于 sdk/typescript/src/api/client.gen.ts#L1117-L1122其 JSDoc 注释与文档描述完全一致export type ContainerWithSymlinkOpts { /** * Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). */ expand?: boolean }二、withSymlink()方法签名与基本用法ContainerWithSymlinkOpts作为withSymlink方法的最后一个可选参数被使用。在生成的 SDK 中sdk/typescript/src/api/client.gen.ts#L6268-L6281/** * Return a snapshot with a symlink * param target Location of the file or directory to link to (e.g., /existing/file). * param linkName Location where the symbolic link will be created (e.g., /new-file-link). * param opts.expand Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). */ withSymlink ( target: string, linkName: string, opts?: ContainerWithSymlinkOpts, ): Container { const ctx this._ctx.select(withSymlink, { target, linkName, ...opts }) return new Container(ctx) }两个必填参数的含义target符号链接指向的文件或目录位置例如/existing/filelinkName符号链接将被创建的位置例如/new-file-link。withSymlink属于 Dagger 的不可变构建语义它不会修改原容器而是返回一个包含新符号链接的快照snapshot的全新Container原容器保持不变。这也解释了其 JSDoc 中 Return a snapshot with a symlink 的表述。基础示例为可执行文件创建别名链接一个典型的场景是为容器内的二进制创建别名方便后续命令引用import { connect } from dagger.io/dagger connect(async (client) { const ctr client .container() .from(alpine:latest) .withExec([apk, add, --no-cache, curl]) // 为 curl 创建 /usr/local/bin/curl-alias 符号链接 .withSymlink(/usr/bin/curl, /usr/local/bin/curl-alias) const out await ctr.withExec([curl-alias, --version]).stdout() console.log(out) })三、expand选项路径中的环境变量展开3.1 展开规则当expand为true时withSymlink会先对target和linkName两个路径值执行环境变量展开支持两种占位符写法${VAR}花括号形式$VAR简写形式展开依据是容器当前定义的环境变量即该容器此前通过withEnvVariable等方法注入的变量。例如路径/$VAR/foo.txt中若容器定义了VAR/etc则展开为/etc/foo.txt。从 GraphQL Schema 的定义可见core/schema/testdata/base_schema.graphqls#L1279-L1292该选项的描述即为Return a snapshot with a symlink withSymlink( Location of the file or directory to link to (e.g., /existing/file). target: String! Location where the symbolic link will be created (e.g., /new-file-link). linkName: String! Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). expand: Boolean! false )注意 Schema 层expand的默认值为false。在 Go 后端 Schema 实现中core/schema/container.go#L1750-L1754参数结构体也显式声明了该默认值type containerWithSymlinkArgs struct { Target string LinkName string Expand bool default:false }3.2 展开的实际执行逻辑在 core/schema/container.go#L1756-L1769 中withSymlink的 Schema 处理器会对两个路径参数分别调用expandEnvVarfunc (s *containerSchema) withSymlink(ctx context.Context, parent dagql.ObjectResult[*core.Container], args containerWithSymlinkArgs) (inst dagql.ObjectResult[*core.Container], _ error) { // ... target, err : expandEnvVar(ctx, parent.Self(), args.Target, args.Expand) if err ! nil { return inst, err } linkName, err : expandEnvVar(ctx, parent.Self(), args.LinkName, args.Expand) if err ! nil { return inst, err } // ... 克隆 FS / Mounts / MetaSnapshot 后构建新的 Container }expandEnvVar的实现位于 core/schema/container.go#L3445-L3485其行为要点如下当expand为false时直接原样返回输入路径不做任何处理当expand为true时通过os.ExpandGo 标准库支持$VAR与${VAR}两种形式逐段替换占位符变量值取自容器的镜像配置环境变量cfg.Env安全限制如果被引用的变量属于 Secret 环境变量parent.Secrets或易变环境变量parent.VolatileEnv即withEnvVariable注入的变量会直接返回错误例如expand cannot be used with secret env variable VAR。这是刻意设计的安全约束——避免敏感值被意外写入符号链接路径或泄露到产物中。3.3 结合withEnvVariable的实战示例由于expand展开的是容器镜像配置层面的环境变量一个典型的用法是先通过withEnvVariable定义变量再在withSymlink中引用import { connect } from dagger.io/dagger connect(async (client) { const ctr client .container() .from(alpine:latest) .withEnvVariable(APP_DIR, /opt/app) .withEnvVariable(BIN_NAME, my-tool) .withExec([mkdir, -p, /opt/app]) .withNewFile(/opt/app/my-tool, #!/bin/sh\necho hello\n) // expand 打开后${APP_DIR}/${BIN_NAME} 会被展开为 /opt/app/my-tool .withSymlink(${APP_DIR}/${BIN_NAME}, /usr/local/bin/tool, { expand: true, }) const out await ctr.withExec([tool]).stdout() console.log(out) // hello })该用法有对应的集成测试佐证。在 core/integration/container_test.go#L5652-L5663 中env variable is expanded in WithSymlink 用例展示了完整流程t.Run(env variable is expanded in WithSymlink, func(ctx context.Context, t *testctx.T) { output, err : c.Container(). From(alpine:latest). WithEnvVariable(a, alpha). WithEnvVariable(b, bravo). WithNewFile(bravo.txt, phonetic data). WithSymlink(${b}.txt, ${a}.txt, dagger.ContainerWithSymlinkOpts{Expand: true}). File(alpha.txt).Contents(ctx) require.NoError(t, err) require.Equal(t, phonetic data, output) })该测试清晰地展示了expand: true的完整链路WithSymlink(${b}.txt, ${a}.txt, ...)将target展开为bravo.txt、linkName展开为alpha.txt随后File(alpha.txt)读取到的正是bravo.txt的内容phonetic data。同理core/integration/container_test.go#L5665-L5678中的Exists测试也展示了同类展开机制可作为对照参考。3.4 与其他容器路径 API 的对照expand选项并非withSymlink独有它是 Dagger 容器路径类 API 的通用约定。在 TypeScript SDK 生成代码中ContainerWithUnixSocketOptssdk/typescript/src/api/client.gen.ts#L1124同样包含expand属性用于withUnixSocket的路径展开sdk/typescript/src/api/client.gen.ts#L6293。这种一致性意味着你掌握ContainerWithSymlinkOpts.expand后可以类推到容器路径相关的其他 API。四、底层原理从 GraphQL 调用到快照生成理解expand的作用后再看withSymlink的整体实现有助于把握该选项在引擎中的位置。4.1 惰性求值与容器克隆withSymlink采用 Dagger 的惰性求值lazy evaluation模型。在 core/schema/container.go#L1772-L1808 中Schema 层先克隆父容器的 FS、Mounts、MetaSnapshot 与镜像配置再创建一个携带ContainerWithSymlinkLazy状态的新容器ctr : core.Container{ FS: clonedFS, MetaSnapshot: clonedMeta, Config: core.CloneContainerImageConfig(parent.Self().Config), Mounts: clonedMounts, // ... Lazy: core.ContainerWithSymlinkLazy{ LazyState: core.NewLazyState(), Parent: parent, Target: target, LinkPath: linkName, }, }ContainerWithSymlinkLazy的定义在 core/container.go#L416其Evaluate方法core/container.go#L4054-L4060在真正需要该容器快照时才执行底层的container.WithSymlink(ctx, lazy.Parent, lazy.Target, lazy.LinkPath)。也就是说仅当后续有读取操作如file().contents()、stdout()等触发求值时符号链接才会真正被写入快照。4.2 引擎层的核心实现引擎核心实现位于 core/container.go#L5640-L5689关键逻辑包括路径定位通过locatePath解析linkPath判断符号链接落在文件系统FS还是某个挂载点Mount上挂载点覆盖处理如果要覆盖的路径恰好是挂载点会先WithoutMount卸载该挂载点再递归重试保证链接能正确写入下层文件系统空 FS 初始化如果容器尚无文件系统会先加载规范的 scratch 目录作为根文件系统委托给目录实现最终通过dir.WithSymlink(ctx, targetParent, target, mntSubpath)在目标目录上创建链接并将container.ImageRef置空以标记镜像引用失效。Directory.WithSymlinkcore/directory.go#L3558-L3612则负责实际的快照写入它基于父快照创建一个带symlink linkName - target描述的新快照在挂载点内解析出链接目录并MkdirAll创建父目录最后调用os.Symlink(target, resolvedLinkName)完成符号链接的物理创建。4.3 缓存与可重复性从源码可见withSymlink的产物是内容寻址的快照Directory.WithSymlink通过cache.Evaluate(ctx, parent)求值父目录再基于父快照生成新快照并提交newRef.Commit。这意味着相同的父容器与相同的target、linkName参数会得到相同的快照从而被 Dagger 缓存系统复用。集成测试 core/integration/container_test.go#L6007-L6024 中的用例正是验证了WithSymlink(bar, foo)与WithSymlink(barf, oo)参数不同之间缓存区分的正确性。五、边界行为与安全约束5.1 路径穿越与越界防护在 core/integration/container_test.go#L5951-L5988 中覆盖了大量边界用例例如链接名位于深层子目录submarine/my-symlink目标使用大量../试图越出根文件系统../../../../../../../../../../../../../../../this-should-be-in-the-root-fs链接名本身尝试路径逃逸escape、escape/foo/bar。这些用例验证了引擎会将链接严格约束在容器文件系统边界之内防止符号链接逃逸到宿主机或相邻挂载。5.2 Secret 与易变环境变量的限制如 3.2 节所述expand不允许引用 Secret 或易变volatile环境变量。如果withSymlink(..., { expand: true })的路径中出现了这类变量名expandEnvVar会返回显式错误core/schema/container.go#L3467-L3473secretEnvFoundError fmt.Errorf(expand cannot be used with secret env variable %q, k)这在设计上防止了敏感信息被写入符号链接目标或链接名进而避免其在快照描述、缓存键或产物清单中留下痕迹。六、速查清单类型ContainerWithSymlinkOpts { expand?: boolean }定义见 docs/versioned_docs/version-0.21/reference/typescript/api/client.gen/type-aliases/ContainerWithSymlinkOpts.md生成源码见 sdk/typescript/src/api/client.gen.ts#L1117-L1122方法container.withSymlink(target, linkName, opts?)返回包含符号链接快照的新Container原容器不变expand 默认关闭false开启后支持$VAR与${VAR}两种占位符按容器镜像配置中的环境变量展开展开失败场景引用了 Secret 环境变量或易变withEnvVariable注入的环境变量会报错实现参考Schema 处理 core/schema/container.go#L1756-L1809、环境变量展开 core/schema/container.go#L3445-L3485、核心实现 core/container.go#L5640-L5689、目录快照 core/directory.go#L3558-L3612、集成测试 core/integration/container_test.go#L5652-L5663。掌握ContainerWithSymlinkOpts后你可以在 Dagger 的 TypeScript 流水线中安全、可缓存地构造符号链接并借助expand将链接路径与容器环境变量解耦从而写出更具可移植性的构建、测试与发布流程。【免费下载链接】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 TypeScript SDK 中 ContainerWithSymlinkOpts 详解：容器内符号链接与环境变量展开
Dagger TypeScript SDK 中 ContainerWithSymlinkOpts 详解容器内符号链接与环境变量展开【免费下载链接】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本篇技术指南以 Dagger 项目docs/versioned_docs/version-0.21/reference/typescript/api/client.gen/type-aliases/ContainerWithSymlinkOpts.md为核心系统讲解 TypeScript SDK 中ContainerWithSymlinkOpts类型别名的定义与用法。该类型用于配置Container.withSymlink()调用时的行为选项其唯一可选属性expand控制链接路径中$VAR/${VAR}是否按容器内环境变量展开。读完本文你将掌握在 Dagger 流水线中创建符号链接、利用环境变量动态构造路径的完整实战方法并理解该选项从 GraphQL Schema 到引擎底层快照实现的完整调用链。一、ContainerWithSymlinkOpts类型定义ContainerWithSymlinkOpts是 Dagger TypeScript SDK 为Container.withSymlink()方法提供的选项对象类型。根据 类型别名文档它定义为一个object类型结构如下type ContainerWithSymlinkOpts { /** * Replace ${VAR} or $VAR in the value of path according to the current * environment variables defined in the container (e.g. /$VAR/foo.txt). */ expand?: boolean }属性一览属性类型必填默认值说明expandboolean可选false是否在target与linkName路径值中按容器当前定义的环境变量展开${VAR}或$VAR占位符在生成的 SDK 源码中该类型定义位于 sdk/typescript/src/api/client.gen.ts#L1117-L1122其 JSDoc 注释与文档描述完全一致export type ContainerWithSymlinkOpts { /** * Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). */ expand?: boolean }二、withSymlink()方法签名与基本用法ContainerWithSymlinkOpts作为withSymlink方法的最后一个可选参数被使用。在生成的 SDK 中sdk/typescript/src/api/client.gen.ts#L6268-L6281/** * Return a snapshot with a symlink * param target Location of the file or directory to link to (e.g., /existing/file). * param linkName Location where the symbolic link will be created (e.g., /new-file-link). * param opts.expand Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). */ withSymlink ( target: string, linkName: string, opts?: ContainerWithSymlinkOpts, ): Container { const ctx this._ctx.select(withSymlink, { target, linkName, ...opts }) return new Container(ctx) }两个必填参数的含义target符号链接指向的文件或目录位置例如/existing/filelinkName符号链接将被创建的位置例如/new-file-link。withSymlink属于 Dagger 的不可变构建语义它不会修改原容器而是返回一个包含新符号链接的快照snapshot的全新Container原容器保持不变。这也解释了其 JSDoc 中 Return a snapshot with a symlink 的表述。基础示例为可执行文件创建别名链接一个典型的场景是为容器内的二进制创建别名方便后续命令引用import { connect } from dagger.io/dagger connect(async (client) { const ctr client .container() .from(alpine:latest) .withExec([apk, add, --no-cache, curl]) // 为 curl 创建 /usr/local/bin/curl-alias 符号链接 .withSymlink(/usr/bin/curl, /usr/local/bin/curl-alias) const out await ctr.withExec([curl-alias, --version]).stdout() console.log(out) })三、expand选项路径中的环境变量展开3.1 展开规则当expand为true时withSymlink会先对target和linkName两个路径值执行环境变量展开支持两种占位符写法${VAR}花括号形式$VAR简写形式展开依据是容器当前定义的环境变量即该容器此前通过withEnvVariable等方法注入的变量。例如路径/$VAR/foo.txt中若容器定义了VAR/etc则展开为/etc/foo.txt。从 GraphQL Schema 的定义可见core/schema/testdata/base_schema.graphqls#L1279-L1292该选项的描述即为Return a snapshot with a symlink withSymlink( Location of the file or directory to link to (e.g., /existing/file). target: String! Location where the symbolic link will be created (e.g., /new-file-link). linkName: String! Replace ${VAR} or $VAR in the value of path according to the current environment variables defined in the container (e.g. /$VAR/foo.txt). expand: Boolean! false )注意 Schema 层expand的默认值为false。在 Go 后端 Schema 实现中core/schema/container.go#L1750-L1754参数结构体也显式声明了该默认值type containerWithSymlinkArgs struct { Target string LinkName string Expand bool default:false }3.2 展开的实际执行逻辑在 core/schema/container.go#L1756-L1769 中withSymlink的 Schema 处理器会对两个路径参数分别调用expandEnvVarfunc (s *containerSchema) withSymlink(ctx context.Context, parent dagql.ObjectResult[*core.Container], args containerWithSymlinkArgs) (inst dagql.ObjectResult[*core.Container], _ error) { // ... target, err : expandEnvVar(ctx, parent.Self(), args.Target, args.Expand) if err ! nil { return inst, err } linkName, err : expandEnvVar(ctx, parent.Self(), args.LinkName, args.Expand) if err ! nil { return inst, err } // ... 克隆 FS / Mounts / MetaSnapshot 后构建新的 Container }expandEnvVar的实现位于 core/schema/container.go#L3445-L3485其行为要点如下当expand为false时直接原样返回输入路径不做任何处理当expand为true时通过os.ExpandGo 标准库支持$VAR与${VAR}两种形式逐段替换占位符变量值取自容器的镜像配置环境变量cfg.Env安全限制如果被引用的变量属于 Secret 环境变量parent.Secrets或易变环境变量parent.VolatileEnv即withEnvVariable注入的变量会直接返回错误例如expand cannot be used with secret env variable VAR。这是刻意设计的安全约束——避免敏感值被意外写入符号链接路径或泄露到产物中。3.3 结合withEnvVariable的实战示例由于expand展开的是容器镜像配置层面的环境变量一个典型的用法是先通过withEnvVariable定义变量再在withSymlink中引用import { connect } from dagger.io/dagger connect(async (client) { const ctr client .container() .from(alpine:latest) .withEnvVariable(APP_DIR, /opt/app) .withEnvVariable(BIN_NAME, my-tool) .withExec([mkdir, -p, /opt/app]) .withNewFile(/opt/app/my-tool, #!/bin/sh\necho hello\n) // expand 打开后${APP_DIR}/${BIN_NAME} 会被展开为 /opt/app/my-tool .withSymlink(${APP_DIR}/${BIN_NAME}, /usr/local/bin/tool, { expand: true, }) const out await ctr.withExec([tool]).stdout() console.log(out) // hello })该用法有对应的集成测试佐证。在 core/integration/container_test.go#L5652-L5663 中env variable is expanded in WithSymlink 用例展示了完整流程t.Run(env variable is expanded in WithSymlink, func(ctx context.Context, t *testctx.T) { output, err : c.Container(). From(alpine:latest). WithEnvVariable(a, alpha). WithEnvVariable(b, bravo). WithNewFile(bravo.txt, phonetic data). WithSymlink(${b}.txt, ${a}.txt, dagger.ContainerWithSymlinkOpts{Expand: true}). File(alpha.txt).Contents(ctx) require.NoError(t, err) require.Equal(t, phonetic data, output) })该测试清晰地展示了expand: true的完整链路WithSymlink(${b}.txt, ${a}.txt, ...)将target展开为bravo.txt、linkName展开为alpha.txt随后File(alpha.txt)读取到的正是bravo.txt的内容phonetic data。同理core/integration/container_test.go#L5665-L5678中的Exists测试也展示了同类展开机制可作为对照参考。3.4 与其他容器路径 API 的对照expand选项并非withSymlink独有它是 Dagger 容器路径类 API 的通用约定。在 TypeScript SDK 生成代码中ContainerWithUnixSocketOptssdk/typescript/src/api/client.gen.ts#L1124同样包含expand属性用于withUnixSocket的路径展开sdk/typescript/src/api/client.gen.ts#L6293。这种一致性意味着你掌握ContainerWithSymlinkOpts.expand后可以类推到容器路径相关的其他 API。四、底层原理从 GraphQL 调用到快照生成理解expand的作用后再看withSymlink的整体实现有助于把握该选项在引擎中的位置。4.1 惰性求值与容器克隆withSymlink采用 Dagger 的惰性求值lazy evaluation模型。在 core/schema/container.go#L1772-L1808 中Schema 层先克隆父容器的 FS、Mounts、MetaSnapshot 与镜像配置再创建一个携带ContainerWithSymlinkLazy状态的新容器ctr : core.Container{ FS: clonedFS, MetaSnapshot: clonedMeta, Config: core.CloneContainerImageConfig(parent.Self().Config), Mounts: clonedMounts, // ... Lazy: core.ContainerWithSymlinkLazy{ LazyState: core.NewLazyState(), Parent: parent, Target: target, LinkPath: linkName, }, }ContainerWithSymlinkLazy的定义在 core/container.go#L416其Evaluate方法core/container.go#L4054-L4060在真正需要该容器快照时才执行底层的container.WithSymlink(ctx, lazy.Parent, lazy.Target, lazy.LinkPath)。也就是说仅当后续有读取操作如file().contents()、stdout()等触发求值时符号链接才会真正被写入快照。4.2 引擎层的核心实现引擎核心实现位于 core/container.go#L5640-L5689关键逻辑包括路径定位通过locatePath解析linkPath判断符号链接落在文件系统FS还是某个挂载点Mount上挂载点覆盖处理如果要覆盖的路径恰好是挂载点会先WithoutMount卸载该挂载点再递归重试保证链接能正确写入下层文件系统空 FS 初始化如果容器尚无文件系统会先加载规范的 scratch 目录作为根文件系统委托给目录实现最终通过dir.WithSymlink(ctx, targetParent, target, mntSubpath)在目标目录上创建链接并将container.ImageRef置空以标记镜像引用失效。Directory.WithSymlinkcore/directory.go#L3558-L3612则负责实际的快照写入它基于父快照创建一个带symlink linkName - target描述的新快照在挂载点内解析出链接目录并MkdirAll创建父目录最后调用os.Symlink(target, resolvedLinkName)完成符号链接的物理创建。4.3 缓存与可重复性从源码可见withSymlink的产物是内容寻址的快照Directory.WithSymlink通过cache.Evaluate(ctx, parent)求值父目录再基于父快照生成新快照并提交newRef.Commit。这意味着相同的父容器与相同的target、linkName参数会得到相同的快照从而被 Dagger 缓存系统复用。集成测试 core/integration/container_test.go#L6007-L6024 中的用例正是验证了WithSymlink(bar, foo)与WithSymlink(barf, oo)参数不同之间缓存区分的正确性。五、边界行为与安全约束5.1 路径穿越与越界防护在 core/integration/container_test.go#L5951-L5988 中覆盖了大量边界用例例如链接名位于深层子目录submarine/my-symlink目标使用大量../试图越出根文件系统../../../../../../../../../../../../../../../this-should-be-in-the-root-fs链接名本身尝试路径逃逸escape、escape/foo/bar。这些用例验证了引擎会将链接严格约束在容器文件系统边界之内防止符号链接逃逸到宿主机或相邻挂载。5.2 Secret 与易变环境变量的限制如 3.2 节所述expand不允许引用 Secret 或易变volatile环境变量。如果withSymlink(..., { expand: true })的路径中出现了这类变量名expandEnvVar会返回显式错误core/schema/container.go#L3467-L3473secretEnvFoundError fmt.Errorf(expand cannot be used with secret env variable %q, k)这在设计上防止了敏感信息被写入符号链接目标或链接名进而避免其在快照描述、缓存键或产物清单中留下痕迹。六、速查清单类型ContainerWithSymlinkOpts { expand?: boolean }定义见 docs/versioned_docs/version-0.21/reference/typescript/api/client.gen/type-aliases/ContainerWithSymlinkOpts.md生成源码见 sdk/typescript/src/api/client.gen.ts#L1117-L1122方法container.withSymlink(target, linkName, opts?)返回包含符号链接快照的新Container原容器不变expand 默认关闭false开启后支持$VAR与${VAR}两种占位符按容器镜像配置中的环境变量展开展开失败场景引用了 Secret 环境变量或易变withEnvVariable注入的环境变量会报错实现参考Schema 处理 core/schema/container.go#L1756-L1809、环境变量展开 core/schema/container.go#L3445-L3485、核心实现 core/container.go#L5640-L5689、目录快照 core/directory.go#L3558-L3612、集成测试 core/integration/container_test.go#L5652-L5663。掌握ContainerWithSymlinkOpts后你可以在 Dagger 的 TypeScript 流水线中安全、可缓存地构造符号链接并借助expand将链接路径与容器环境变量解耦从而写出更具可移植性的构建、测试与发布流程。【免费下载链接】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），仅供参考