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 で新しいバージョンを選択する方法

Skaffold の新しいバージョンが 90 日ごとに選択されます。この 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 日

次のステップ