自訂 Dockerfile 語法

Dockerfile 前端

BuildKit 支援從容器映像檔動態載入前端。要使用外部 Dockerfile 前端，您的 Dockerfile 的第一行需要設定 syntax 指示詞，指向您要使用的特定映像檔。

# syntax=[remote image reference]

例如：

# syntax=docker/dockerfile:1
# syntax=docker.io/docker/dockerfile:1
# syntax=example.com/user/repo:tag@sha256:abcdef...

您也可以使用預先定義的 BUILDKIT_SYNTAX 建置引數，在命令列上設定前端映像檔參考。

$ docker build --build-arg BUILDKIT_SYNTAX=docker/dockerfile:1 .

這定義了用於建置 Dockerfile 的 Dockerfile 語法位置。BuildKit 後端允許無縫使用以 Docker 映像檔形式發佈並在容器沙盒環境中執行的外部實作。

自訂 Dockerfile 實作允許您：

• 自動取得錯誤修正，無需更新 Docker Daemon。
• 確保所有使用者都使用相同的實作來建置您的 Dockerfile。
• 使用最新功能，無需更新 Docker Daemon。
• 在 Docker Daemon 整合新功能或第三方功能之前試用它們。
• 使用 替代建置定義，或建立您自己的定義

  注意

  BuildKit 隨附內建的 Dockerfile 前端，但建議使用外部映像檔，以確保所有使用者在建置器上使用相同的版本，並自動取得錯誤修正，而無需等待新版本的 BuildKit 或 Docker Engine。

  正式版本

  Docker 在 Docker Hub 上的 docker/dockerfile 儲存庫中發佈可用於建置 Dockerfile 的官方版本映像檔。新映像檔會在兩個通道中發佈：stable 和 labs。

  穩定版通道

  stable 通道遵循 語義化版本控制。例如：

  • docker/dockerfile:1 - 持續更新最新的 1.x.x 次要 *和* 修補程式版本。
  • docker/dockerfile:1.2 - 持續更新最新的 1.2.x 修補程式版本，並在版本 1.3.0 發佈後停止接收更新。
  • docker/dockerfile:1.2.1 - 不可變：永不更新。

  我們建議使用 docker/dockerfile:1，它始終指向版本 1 語法的最新穩定版本，並在版本 1 發佈週期中接收「次要」和「修補程式」更新。 BuildKit 在執行建置時會自動檢查語法更新，確保您使用的是最新版本。

  如果使用特定版本，例如 1.2 或 1.2.1，則需要手動更新 Dockerfile 才能繼續接收錯誤修正和新功能。舊版本的 Dockerfile 仍與新版本的建置器相容。

  實驗室通道

  labs 通道提供對 stable 通道中尚未提供的 Dockerfile 功能的搶先體驗。labs 映像檔與穩定版本同時發佈，並遵循相同的版本模式，但使用 -labs 後綴，例如：

  • docker/dockerfile:labs - labs 通道上的最新版本。
  • docker/dockerfile:1-labs - 與 dockerfile:1 相同，但啟用了實驗性功能。
  • docker/dockerfile:1.2-labs - 與 dockerfile:1.2 相同，但啟用了實驗性功能。
  • docker/dockerfile:1.2.1-labs - 不可變：永不更新。與 dockerfile:1.2.1 相同，但啟用了實驗性功能。

  選擇最符合您需求的通道。如果您想使用新功能，請使用 labs 通道。labs 通道中的映像包含 stable 通道中的所有功能，以及搶先體驗功能。labs 通道中的穩定功能遵循語義化版本控制，但搶先體驗功能則不遵循，且較新的版本可能無法向下相容。請固定版本以避免處理重大變更。

  其他資源

  有關 labs 功能、主要版本和夜間功能版本的說明文件，請參閱 GitHub 上的 BuildKit 原始程式碼儲存庫中的說明。如需可用映像的完整清單，請瀏覽 Docker Hub 上的 docker/dockerfile 儲存庫docker/dockerfile-upstream 儲存庫

  編輯此頁面 要求變更

  目錄