管理 Skaffold 版本

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

本页介绍 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.13.x（版本说明） v4beta11 2024 年 8 月 1 日 ✓
2.11.x（版本说明） v4beta10 2024 年 5 月 6 日
2.10.x（版本说明） v4beta9 2024 年 2 月 2 日
2.8.x（版本说明） v4beta7 2023 年 10 月 27 日

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

后续步骤