Dockerfile 發行說明 (Dockerfile Release Notes)

此版本的完整發行說明可在 GitHub 上 找到。

# syntax=docker/dockerfile:1.8.1

錯誤修正和增強功能

• 修復處理變數展開時空字串的問題。moby/buildkit#5052
• 改進建置警告的格式。 moby/buildkit#5037, moby/buildkit#5045, moby/buildkit#5046
• 修復多階段建置中UndeclaredVariable警告可能出現無效輸出的問題。 moby/buildkit#5048

1.8.0

此版本的完整發行說明可在 GitHub 上

# syntax=docker/dockerfile:1.8.0

• 新增許多驗證規則，用於驗證您的 Dockerfile 是否符合最佳實務。這些規則會在建置期間進行驗證，新的 check 前端方法可用於僅觸發驗證，而無需完成整個建置。
• 新的指令 #check 和建置參數 BUILDKIT_DOCKERFILE_CHECK 可讓您控制建置檢查的行為。 moby/buildkit#4962
• 已改善解析包含多個階段的大型 Dockerfile 的效能。moby/buildkit#4970
• 修正一些 Windows 路徑處理一致性錯誤。moby/buildkit#4825

1.7.0

穩定版

# syntax=docker/dockerfile:1.7

• 變數展開現在允許字串替換和修剪。moby/buildkit#4427
• 具有本地來源的命名上下文現在可以正確地僅傳輸 Dockerfile 中使用的檔案，而不是整個來源目錄。moby/buildkit#4161...
• Dockerfile 現在可以更好地驗證階段的順序，如果順序不正確，則會返回帶有堆疊追蹤的良好錯誤訊息。moby/buildkit#4568...、moby/buildkit#4567...
• 歷史提交訊息現在包含與 `COPY` 和 `ADD` 一起使用的標記。moby/buildkit#4597...
• 來自 Git 和 HTTP 來源的 `ADD` 命令的進度訊息已得到改進。moby/buildkit#4408...

Labs 版本

# syntax=docker/dockerfile:1.7-labs

• 新的 `--parents` 標記已添加到 `COPY` 中，用於在保留父目錄結構的同時複製檔案。moby/buildkit#4598...、moby/buildkit#3001...、moby/buildkit#4720...、moby/buildkit#4728...、文件
• 新的 `--exclude` 旗標可以在 `COPY` 和 `ADD` 指令中使用，用於篩選複製的檔案。 moby/buildkit#4561, 文件

1.6.0

新增

• 在 `HEALTHCHECK` 指令 中新增 `--start-interval` 旗標。

以下功能已從實驗通道升級到穩定版

• `ADD` 指令現在可以 直接從 Git URL 導入檔案
• `ADD` 指令現在支援 `--checksum` 旗標 來驗證遠端 URL 內容的校驗和

錯誤修正和增強功能

• 變數替換現在支援其他 POSIX 相容的變體，無需使用 `:`。 moby/buildkit#36112023-02-14

  錯誤修正和增強功能

  • 修復從缺少分支名稱但包含子目錄的 Git 參考進行建置的問題
  • 386 平台映像檔現已包含在發行版中

  1.5.1

  2023-01-18

  錯誤修正和增強功能

  • 修復在多平台建置中出現警告情況時可能發生的嚴重錯誤

  1.5.0 (labs)

  2023-01-10

  **實驗性**

  「實驗室」通道提供對穩定通道中尚不可用的 Dockerfile 功能的搶先體驗。

  新增

  • `ADD` 指令現在支援 `--checksum` 旗標 來驗證遠端 URL 內容的校驗和

  1.5.0

  2023-01-10

  新增

  • `ADD` 指令現在可以 直接從 Git URL 導入檔案

  錯誤修正和增強功能

  • 具名上下文現在支援 `oci-layout://` 協定，用於包含來自本地 OCI 佈局結構的映像檔
  • Dockerfile 現在支援次要請求，用於列出所有建置目標或列印特定建置目標的接受參數概要
  • 將 Dockerfile `#syntax` 指令重定向到外部前端映像檔現在允許使用 `//` 註釋或 JSON 設定該指令。 該檔案也可能包含 shebang 標頭
  • 具名上下文現在可以使用空的 scratch 映像檔初始化
  • 具名上下文現在可以使用 SSH Git URL 初始化
  • 修復導入 Schema1 映像檔時 `ONBUILD` 的處理問題

  1.4.3

  2022-08-23

  錯誤修正和增強功能

  • 修復從 `docker-image://` 具名上下文建置映像檔時建立時間戳記未重置的問題
  • 修復載入 `docker-image://` 具名上下文時傳遞 `FROM` 指令的 `--platform` 旗標的問題

  1.4.2

  2022-05-06

  錯誤修正和增強功能

  • 修復從使用建置上下文傳遞的映像檔載入某些環境變數的問題

  1.4.1

  2022-04-08

  錯誤修正和增強功能

  • 修復輸入的平台與建置平台不同時，針對跨平台編譯案例的具名上下文解析問題

  1.4.0

  2022-03-09

  新增

  • `COPY --link` 和 `ADD --link` 允許以更高的快取效率複製檔案並重建基礎映像檔，而無需重建它們。 `--link` 將檔案複製到單獨的圖層，然後使用新的 LLB MergeOp 實作將獨立的圖層鏈接在一起
  • Heredoc 支援已從實驗通道升級到穩定版。 此功能允許編寫多行內聯腳本和檔案
  • 可以將其他 具名建置上下文 傳遞給建置，以新增或覆蓋建置內的階段或映像檔。 上下文的來源可以是本地來源、映像檔、Git 或 HTTP URL
  • `BUILDKIT_SANDBOX_HOSTNAME` 建置參數 可用於設定 `RUN` 步驟的預設主機名稱

  錯誤修正和增強功能

  • 使用跨平台編譯階段時，步驟的目標平台現在會顯示在進度輸出中
  • 修復 Heredocs 錯誤地從內容中移除引號的一些情況

  1.3.1

  2021-10-04

  錯誤修正和增強功能

  • 修復解析沒有值的「required」掛載鍵的問題

  1.3.0 (labs)

  2021-07-16

  **實驗性**

  「實驗室」通道提供對穩定通道中尚不可用的 Dockerfile 功能的搶先體驗。

  新增

  • `RUN` 和 `COPY` 指令現在支援 Heredoc 語法，允許編寫多行內聯腳本和檔案

  1.3.0

  2021-07-16

  新增

  • `RUN` 指令允許使用 `--network` 旗標 來請求特定類型的網路條件。 `--network=host` 需要允許 `network.host` 權限。 此功能先前僅在實驗通道上可用

  錯誤修正和增強功能

  • 使用遠端 URL 輸入的 `ADD` 指令現在可以正確處理 `--chmod` 旗標
  • `RUN --mount` 旗標 的值現在支援變數展開，`from` 欄位除外
  • 允許 `BUILDKIT_MULTI_PLATFORM` 建置參數 強制始終建立多平台映像檔，即使僅包含單個平台

  1.2.1 (labs)

  2020-12-12

  **實驗性**

  「實驗室」通道提供對穩定通道中尚不可用的 Dockerfile 功能的搶先體驗。

  錯誤修正和增強功能

  • `RUN` 指令允許使用 `--network` 旗標 來請求特定類型的網路條件。 `--network=host` 需要允許 `network.host` 權限

  1.2.1

  2020-12-12

  錯誤修正和增強功能

  • 還原「確保 ENTRYPOINT 指令至少有一個參數」
  • 最佳化多平台跨平台編譯建置中的 `COPY` 呼叫處理

  1.2.0 (labs)

  2020-12-03

  **實驗性**

  「實驗室」通道提供對穩定通道中尚不可用的 Dockerfile 功能的搶先體驗。

  錯誤修正和增強功能

  • 實驗通道已更名為 *實驗室*

  1.2.0

  2020-12-03

  新增

  • 用於建立 secret、ssh、bind 和 cache 掛載的 `RUN --mount` 語法 已移至主線通道
  • `ARG` 指令 現在支援在同一行上定義多個建置參數，類似於 `ENV`

  錯誤修正和增強功能

  • 中繼資料載入錯誤現在被視為致命錯誤，以避免建置結果不正確
  • 允許使用小寫 Dockerfile 名稱
  • `ADD` 中的 `--chown` 旗標現在允許參數展開
  • `ENTRYPOINT` 需要至少一個參數，以避免建立損壞的映像檔

  1.1.7

  2020-04-18

  錯誤修正和增強功能

  • 將 `FrontendInputs` 轉發到閘道器

  1.1.2 (實驗性)

  2019-07-31

  **實驗性**

  「實驗室」通道提供對穩定通道中尚不可用的 Dockerfile 功能的搶先體驗。

  錯誤修正和增強功能

  • 允許使用 `RUN --security=sandbox|insecure` 設定程序的安全模式
  • 允許為快取掛載設定 uid/gid
  • 避免請求將內部連結的路徑拉取到建置上下文
  • 確保遺漏的快取 ID 預設為目標路徑
  • 允許使用BUILDKIT_CACHE_MOUNT_NS 建置參數設定快取掛載的命名空間

  1.1.2

  2019-07-31

  錯誤修正和增強功能

  • 使用正確的使用者修復工作目錄建立，並且不重置自定義所有權
  • 修復處理也被用作 ENV 的空建置參數
  • 偵測循環相依性

  1.1.0

  2019-04-27

  新增

  • ADD/COPY 指令現在支援基於 llb.FileOp 的實作，如果支援內建檔案操作，則不需要輔助映像檔
  • COPY 指令的 --chown 旗標現在支援變數展開

  錯誤修正和增強功能

  • 為了尋找從建置上下文中忽略的檔案，Dockerfile 前端將首先尋找檔案 <path/to/Dockerfile>.dockerignore，如果找不到，將從建置上下文的根目錄尋找 .dockerignore 檔案。這允許多個 Dockerfile 的專案使用不同的 .dockerignore 定義