跳转到主内容

接口：BuildImageOptions

定义于： packages/extension-api/src/extension-api.d.ts:3577

属性​

abortController?​

可选 abortController: AbortController

定义于： packages/extension-api/src/extension-api.d.ts:3601

用于运行构建镜像操作的 abort controller

buildargs?​

可选 buildargs: object

定义于： packages/extension-api/src/extension-api.d.ts:3685

用于构建时变量的 JSON 字符串对映射。用户在构建时传递这些值。Docker 将 buildargs 作为通过 Dockerfile RUN 指令运行的命令的环境上下文，或用于其他 Dockerfilev 指令中的变量展开。此选项不用于传递敏感值。例如，构建参数 FOO=bar 在 JSON 中将变为 {"FOO":"bar"}。这将导致查询参数 buildargs={"FOO":"bar"}。请注意，{"FOO":"bar"} 应进行 URI 组件编码。

索引签名​

[key: string]: string

cachefrom?​

可选 cachefrom: string

定义于： packages/extension-api/src/extension-api.d.ts:3627

用于构建缓存解析的镜像的 JSON 数组。

containerFile?​

可选 containerFile: string

定义于： packages/extension-api/src/extension-api.d.ts:3581

指定一个 Containerfile，其中包含构建镜像的指令

cpuperiod?​

可选 cpuperiod: number

定义于： packages/extension-api/src/extension-api.d.ts:3671

CPU 周期的长度（微秒）。

cpuquota?​

可选 cpuquota: number

定义于： packages/extension-api/src/extension-api.d.ts:3676

容器在一个 CPU 周期内可以获得的 CPU 时间（微秒）。

cpusetcpus?​

可选 cpusetcpus: number

定义于： packages/extension-api/src/extension-api.d.ts:3666

允许执行的 CPU（例如，0-3, 0,1）。

cpushares?​

可选 cpushares: number

定义于： packages/extension-api/src/extension-api.d.ts:3661

CPU 份额（相对权重）。

extrahosts?​

可选 extrahosts: string

定义于： packages/extension-api/src/extension-api.d.ts:3606

要添加到 /etc/hosts 的额外主机

forcerm?​

可选 forcerm: boolean

定义于： packages/extension-api/src/extension-api.d.ts:3646

默认值：false

即使失败，也始终删除中间容器。

labels?​

可选 labels: object

定义于： packages/extension-api/src/extension-api.d.ts:3700

要设置在镜像上的任意键/值标签，作为字符串对的 JSON 映射。

索引签名​

[key: string]: string

memory?​

可选 memory: number

定义于： packages/extension-api/src/extension-api.d.ts:3651

设置构建的内存限制。

memswap?​

可选 memswap: number

定义于： packages/extension-api/src/extension-api.d.ts:3656

总内存（内存 + 交换）。设置为 -1 可禁用交换。

networkmode?​

可选 networkmode: string

定义于： packages/extension-api/src/extension-api.d.ts:3707

设置构建期间运行命令的网络模式。支持的标准值为：bridge、host、none 和 container:<name|id>。任何其他值都将被视为此容器应连接到的自定义网络的名称或 ID。

nocache?​

可选 nocache: boolean

定义于： packages/extension-api/src/extension-api.d.ts:3728

默认值：false

构建镜像时不要使用缓存。

outputs?​

可选 outputs: string

定义于： packages/extension-api/src/extension-api.d.ts:3721

默认值：""

BuildKit 输出配置

platform?​

可选 platform: string

定义于： packages/extension-api/src/extension-api.d.ts:3591

将构建的镜像（以及使用时）的操作系统/架构设置为提供的值，而不是使用主机的当前操作系统和架构。

provider?​

可选 provider: ContainerProviderConnection

定义于： packages/extension-api/src/extension-api.d.ts:3596

设置要使用的提供者，如果未设置，我们将尝试选择第一个可用的（按 Podman 优先排序）。

pull?​

可选 pull: string | boolean

定义于： packages/extension-api/src/extension-api.d.ts:3632

即使本地存在旧镜像，也尝试拉取镜像。

q?​

可选 q: boolean

定义于： packages/extension-api/src/extension-api.d.ts:3622

默认值：false

抑制详细的构建输出。

remote?​

可选 remote: string

定义于： packages/extension-api/src/extension-api.d.ts:3615

一个 Git 仓库 URI 或 HTTP/HTTPS 上下文 URI。如果 URI 指向单个文本文件，则将文件的内容放入名为 Dockerfile 的文件中，并从此文件构建镜像。如果 URI 指向一个 tar 包，则该文件将由守护进程下载，并将其中的内容用作构建的上下文。如果 URI 指向一个 tar 包并且还指定了 dockerfile 参数，则 tar 包中必须有一个具有相应路径的文件。

rm?​

可选 rm: boolean

定义于： packages/extension-api/src/extension-api.d.ts:3639

默认值：true

成功构建后删除中间容器。

shmsize?​

可选 shmsize: number

定义于： packages/extension-api/src/extension-api.d.ts:3690

/dev/shm 的大小（以字节为单位）。大小必须大于 0。如果省略，系统将使用 64MB。

squash?​

可选 squash: boolean

定义于： packages/extension-api/src/extension-api.d.ts:3695

将生成的镜像层压缩成一层。

tag?​

可选 tag: string

定义于： packages/extension-api/src/extension-api.d.ts:3586

指定如果构建过程成功完成，将分配给生成镜像的名称。

target?​

可选 target: string

定义于： packages/extension-api/src/extension-api.d.ts:3714

默认值：""

目标构建阶段