管理 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 日

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

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

預覽版

您可以使用 Cloud Deploy Preview 映像檔，其中包含預覽功能。

您可以隨時更新預覽映像檔中的 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 日

後續步驟