管理 Skaffold 版本

Cloud Deploy 會透過 Cloud Build 使用 Skaffold，藉由轉譯及部署資訊清單來部署應用程式。

本頁面說明 Cloud Deploy 如何選擇要使用的 Skaffold 版本。本頁面也提供以下資訊：

Cloud Deploy 使用何種版本的 Skaffold？

Cloud Deploy 會使用自訂映像檔執行作業，其中包含 Skaffold LTS 版本。本文件的表格列出了每個支援的 Skaffold 版本，並連結至所有 Cloud Deploy 映像檔的存放區。每個 Cloud Deploy 映像檔的版本號碼都會對應至 Skaffold 版本號碼。

支援的版本

Skaffold 版本 結構定義版本上限 截至日期 預設值？
2.16.x (版本資訊) v4beta13 2025 年 5 月 16 日 ✓
2.14.x (版本資訊) v4beta12 2025 年 2 月 17 日
2.13.x (版本資訊) v4beta11 2024 年 8 月 1 日
2.11.x (版本資訊) v4beta10 2024 年 5 月 6 日

此表格中的每個版本都會連結至 Artifact Registry 中的存放區。在該存放區中，找出最新版本或所需版本的最近日期。連結的存放區位於 us-central1 區域，但這些映像檔可在 Cloud Deploy 可用的每個區域使用。所使用的圖片位於建立提交管道的地區。

Cloud Deploy 會使用每個支援的 Skaffold 版本的最新修補程式版本。我們會在版本資訊中宣布支援新版本，包括特定的 Skaffold 版本修補程式。

預先發布版

您可以使用包含預先發布版功能的 Cloud Deploy 預先發布版映像檔。

預覽圖片中的 Skaffold 版本可隨時更新，且不遵循定期發布時程。我們建議您不要將預覽版用於實際工作環境工作負載。

預覽版與支援的版本位於相同的存放區。尋找標記開頭為 skaffold_preview 的圖片。

部分預覽功能需要使用 Cloud Deploy 預覽圖片。針對這些功能，Cloud Deploy 會使用預先發布版，您不必採取任何行動。如果您在使用預覽功能建立版本時，嘗試選取其他 Skaffold 版本，指令就會失敗。

找出與版本相關聯的 Skaffold 版本

您可以隨時執行下列指令，找出 Cloud Deploy 使用的版本：

gcloud deploy releases describe RELEASE \
       --delivery-pipeline=DELIVERY_PIPELINE \
       --region=REGION

版本會顯示在輸出內容的 skaffoldVersion 屬性中。

選擇要使用的 Skaffold 版本

您可以使用任何支援的 Skaffold 版本。如要選取要使用的版本，請在 gcloud deploy releases create 指令上加入 --skaffold-version 標記：

gcloud deploy releases create RELEASE_NAME \
       --delivery-pipeline=PIPELINE_NAME \
       --skaffold-version=SKAFFOLD_VERSION \
       --region=REGION

其中「SKAFFOLD_VERSION」是這個版本要使用的 (支援的) Skaffold 版本。版本的格式應為 n.nn (用於編號版本)，或 skaffold_preview (用於使用預覽版本)。

舉例來說，下列指令會選取 Skaffold 版本 2.8：

gcloud deploy releases create release-001 \
                              --delivery-pipeline=my-pipeline \
                              --skaffold-version=2.8 \
                              --region=us-central1

而這個指令會選取 Skaffold 預先發布版本：

gcloud deploy releases create release-001 \
                       --delivery-pipeline=my-pipeline \
                       --skaffold-version=skaffold_preview \
                       --region=us-central1

Cloud Deploy 選擇新版本的方式

系統會每隔 90 天選取新的 Skaffold 版本。在 90 天週期結束時， Google Cloud 會新增對新版 Skaffold 的支援。您現在可以使用該版本搭配 Cloud Deploy。這會成為下一個 90 天週期的預設版本，用於建立及管理所有版本。

我們會更新 Cloud Deploy 版本資訊，宣布每個新支援的版本。

Skaffold 版本淘汰和維護政策

我們會為 Skaffold 版本提供 12 個月的支援，並提供 60 天的維護期。這個維護期表示，與某個版本相關聯的版本，在該版本的支援期限結束後，仍可獲得 60 天的支援。您仍可透過這些版本建立推播，但無法使用處於維護期間的 Skaffold 版本建立版本。

60 天的維護期過後，系統就不再支援該 Skaffold 版本。您無法再從使用不支援版本的版本建立推行計畫。不過，與發布內容相關的所有資料都會保留。

Skaffold 版本 截至日期 維護作業開始 有效期限
2.16.x (版本資訊) 2025 年 5 月 12 日 2026 年 5 月 14 日 2026 年 7 月 13 日
2.14.x (版本資訊) 2025 年 2 月 17 日 2026 年 2 月 25 日 2026 年 4 月 26 日
2.13.x (版本資訊) 2024 年 8 月 1 日 2025 年 8 月 14 日 2025 年 10 月 13 日
2.11.x (版本資訊) 2024 年 5 月 6 日 2025 年 5 月 6 日 2025 年 7 月 5 日

後續步驟