docker buildx dap build
| 描述 | 启动构建 |
|---|---|
| 用法 | docker buildx dap build [OPTIONS] PATH | URL | - |
实验性功能
此命令是实验性的。
实验性功能旨在用于测试和反馈，因为它们的功能或设计可能会在版本之间未经警告而更改，或者在未来的版本中被完全删除。
描述
使用 调试适配器协议 启动调试会话，以便与调试器 UI 进行通信。
参数与 build 命令相同
注意如果需要，
buildx dap build命令将来可能会收到不向后兼容的功能。我们正在寻求关于改进命令和进一步扩展功能的反馈。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
--add-host | 添加自定义主机到 IP 映射（格式：host:ip） | |
--allow | 允许额外的特权授权（例如，network.host，security.insecure） | |
--annotation | 向镜像添加注解 | |
--attest | 证明参数（格式：type=sbom,generator=image） | |
--build-arg | 设置构建时变量 | |
--build-context | 额外的构建上下文（例如，name=path） | |
--cache-from | 外部缓存源（例如，user/app:cache，type=local,src=path/to/dir） | |
--cache-to | 缓存导出目的地（例如，user/app:cache，type=local,dest=path/to/dir） | |
--call | build | 设置评估构建的方法（check，outline，targets） |
--cgroup-parent | 设置构建期间 RUN 指令的父 cgroup | |
--check | --call=check 的简写 | |
-f, --file | Dockerfile 的名称（默认：PATH/Dockerfile） | |
--iidfile | 将镜像 ID 写入文件 | |
--label | 为镜像设置元数据 | |
--load | --output=type=docker 的简写 | |
--metadata-file | 将构建结果元数据写入文件 | |
--network | 设置构建期间 RUN 指令的网络模式 | |
--no-cache | 构建镜像时不使用缓存 | |
--no-cache-filter | 不缓存指定阶段 | |
-o, --output | 输出目的地（格式：type=local,dest=path） | |
--platform | 设置构建的目标平台 | |
--progress | auto | 设置进度输出类型（auto，quiet，plain，tty，rawjson）。使用 plain 显示容器输出 |
--provenance | --attest=type=provenance 的简写 | |
--pull | 始终尝试拉取所有引用的镜像 | |
--push | --output=type=registry 的简写 | |
-q, --quiet | 抑制构建输出并在成功时打印镜像 ID | |
--sbom | --attest=type=sbom 的简写 | |
--secret | 暴露给构建的秘密（格式：id=mysecret[,src=/local/secret]） | |
--shm-size | 构建容器的共享内存大小 | |
--ssh | 暴露给构建的 SSH 代理套接字或密钥（格式：default|<id>[=<socket>|<key>[,<key>]]） | |
-t, --tag | 名称和可选的标签（格式：name:tag） | |
--target | 设置要构建的目标构建阶段 | |
--ulimit | Ulimit 选项 |
示例
启动请求参数
支持以下 启动请求参数。这些参数作为 JSON 正文的一部分随启动请求发送。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
dockerfile | 字符串 | Dockerfile | Dockerfile 的名称 |
contextPath | 字符串 | . | 设置构建的上下文路径（通常是第一个位置参数） |
target | 字符串 | 设置要构建的目标构建阶段 | |
stopOnEntry | 布尔值 | false | 在第一条指令处停止 |
附加参数
命令行参数可以像传递给普通构建命令一样传递给调试适配器，它们将设置值。如果存在，已设置的启动请求参数将覆盖命令行参数。
调试扩展应在启动配置中包含 args 和 builder 条目。这些将修改传递给工具调用的二进制文件的参数。builder 将在可执行文件之后直接添加 --builder ，而 args 将附加到工具调用的末尾。例如，Visual Studio Code 中的启动配置如下
{
"args": ["--build-arg", "FOO=AAA"]
"builder": ["mybuilder"]
}这将导致调试适配器被调用为 docker buildx --builder mybuilder dap build --build-arg FOO=AAA。