管理 Skaffold 版本

Cloud Deploy 通过 Cloud Build 使用 Skaffold，通过渲染和部署清单来部署应用。

本页面介绍了 Cloud Deploy 如何选择要使用的 Skaffold 版本。本页面还包含关于以下内容的信息：

Cloud Deploy 使用哪个版本的 Skaffold？

Cloud Deploy 使用包含 Skaffold LTS 版本的自定义映像执行操作。本文的表格中列出了每个受支持的 Skaffold 版本，该表链接到所有 Cloud Deploy 映像的代码库。每个 Cloud Deploy 映像的版本号均与 Skaffold 版本号相对应。

在 2022 年 8 月 30 日之前，Cloud Deploy 使用最新公开提供的 Skaffold 映像的 LTS 版本。

支持的版本

Skaffold 版本 最大架构版本 截至以下日期 是否为默认？
2.10.x（版本说明） v4beta9 2024 年 2 月 2 日 ✓
2.8.x（版本说明） v4beta7 2023 年 10 月 27 日
2.6.x（版本说明） v4beta6 2023 年 7 月 6 日
2.3.x（版本说明） v4beta4 2023 年 4 月 24 日
2.0.x（版本说明） v4beta1 2023 年 1 月 9 日

此表中的每个版本都链接到 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.10.x（版本说明） 2024 年 2 月 2 日 2025 年 2 月 2 日 2025 年 4 月 3 日
2.8.x（版本说明） 2023 年 10 月 26 日 2024 年 10 月 26 日 2024 年 12 月 25 日
2.6.x（版本说明） 2023 年 7 月 6 日 2024 年 7 月 6 日 2024 年 9 月 4 日
2.3.x（版本说明） 2023 年 4 月 24 日 2024 年 5 月 1 日 2024 年 7 月 1 日
2.0.x（版本说明） 2023 年 1 月 9 日 2024 年 1 月 9 日 2024 年 3 月 10 日

后续步骤