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）
--callbuild設定評估構建的方法（check，outline，targets）
--cgroup-parent設定構建期間 RUN 指令的父 cgroup
--check--call=check 的簡寫
-f, --fileDockerfile 的名稱（預設：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設定構建的目標平臺
--progressauto設定進度輸出型別（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設定要構建的目標構建階段
--ulimitUlimit 選項

示例

啟動請求引數

支援以下 啟動請求引數。這些引數作為 JSON 正文的一部分隨啟動請求傳送。

名稱型別預設值描述
dockerfile字串DockerfileDockerfile 的名稱
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。