管理 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.11.x（版本说明） v4beta10 2024 年 5 月 6 日 ✓
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.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 日
2.6.x（版本说明） 2023 年 7 月 6 日 2024 年 7 月 6 日 2024 年 9 月 4 日
2.3.x（版本说明） 2023 年 4 月 24 日 2024 年 5 月 1 日 2024 年 7 月 1 日

后续步骤