このページは Cloud Translation API によって翻訳されました。

Kubernetes 1.27 の非推奨 API

Autopilot Standard

このページでは、GKE バージョン 1.27 へのアップグレード用にクラスタを準備する方法について説明します。1.27 で削除された非推奨 API を呼び出している API クライアントを確認し、それらのクライアントを更新して一般提供 API を使用できます。詳しくは、Kubernetes 非推奨 API 移行ガイドをご覧ください。

重要: 2024 年 6 月 30 日（1.26 の標準サポートの終了日）を過ぎると、GKE はバージョン 1.26 と非推奨の API（バージョン 1.27 で削除）を使用しているクラスタをバージョン 1.27 に自動的にアップグレードします。バージョン 1.27 で削除された非推奨の API を使用しているクラスタについては、2024 年 6 月 30 日を過ぎると、自動アップグレードの一時停止が解除されます。サポート終了になった GKE のマイナーバージョンに対してはセキュリティパッチとバグ修正は提供されません。クラスタをできるだけ早くバージョン 1.27 にアップグレードすることをおすすめします。GKE のマイナーバージョンのライフサイクルの詳細については、GKE のバージョニングとサポートをご覧ください。

バージョン 1.27 で削除された API

Kubernetes バージョン 1.27 で廃止された API は、GA に移行したベータ API (v2 など) か、ベータ版間 (v1beta1 から v1beta2 など) です。GA API は長期の互換性を保証するものであり、非推奨のベータ API の代わりに使用する必要があります。

新しいバージョンに移行した API の既存のオブジェクトはすべて、更新された API を使用して操作できます。

CSIStorageCapacity

CSIStorageCapacity の storage.k8s.io/v1beta1 API バージョンは、v1.27 で提供されなくなりました。

v1.24 以降で利用可能な storage.k8s.io/v1 API バージョンを使用するように、マニフェストと API クライアントを移行してください。既存のすべての永続オブジェクトには、新しい API を使用してアクセスできます。一般提供のバージョンでは大きな変更はありません。

バージョン 1.27 へのアップグレードの準備

ユーザーは API オブジェクトを削除して再生成することは必要ありません。一般提供が開始された API の既存のすべての API オブジェクトは、すでに新しい API バージョンを使用して読み込み、更新できる状態になっています。

しかしながら、ユーザーは Kubernetes 1.27 にアップグレードする前に、クライアントとマニフェストを移行することを推奨します。詳細については、Kubernetes の非推奨になった API の移行ガイドをご覧ください。

非推奨化に関する分析情報と推奨事項を表示して、クラスタが Kubernetes 1.27 の非推奨 API を使用しているかどうかを判断できます。GKE は、Kubernetes オブジェクトの構成からではなく、ユーザーエージェントが非推奨 API を呼び出したときに非推奨化に関する分析情報を生成します。

非推奨の API を使用しているクラスタを確認する

非推奨の API を使用しているクラスタは、非推奨に関する分析情報で確認できます。また、非推奨に関する分析情報では、どの API クライアントがクラスタ内で非推奨の API を呼び出しているのかなどの情報も表示できます。

監査ログを使用して、非推奨の API を呼び出しているクライアントを確認することもできます。

非推奨の API への書き込み呼び出しを行う API クライアントを特定する

Google Cloud Observability が有効になっているクラスタでは、次の管理アクティビティ監査ログクエリを使用すると、Google の管理外のユーザーエージェントによる非推奨の API の使用を確認できます。

resource.type="k8s_cluster"
labels."k8s.io/removed-release"="DEPRECATED_API_MINOR_VERSION"
protoPayload.authenticationInfo.principalEmail:("system:serviceaccount" OR "@")
protoPayload.authenticationInfo.principalEmail!~("system:serviceaccount:kube-system:")

DEPRECATED_API_MINOR_VERSION は、非推奨の API が削除されたマイナーバージョン（1.22 など）に置き換えます。

GKE クラスタに対して管理アクティビティ監査ログが自動的に有効になります。このクエリを使用して、非推奨の API への書き込み呼び出しを行っているユーザーエージェントがログに表示されます。

非推奨の API への読み取り呼び出しを行う API クライアントを特定する

デフォルトでは、監査ログには非推奨の API への書き込み呼び出しのみが表示されます。非推奨の API への読み取り呼び出しも表示するには、データアクセス監査ログを構成します。

手順に沿って、Google Cloud コンソールでデータアクセスの監査ログを構成します。Google Cloud コンソールで、Kubernetes Engine API を選択します。情報パネルの [ログタイプ] タブで、Admin Read と Data Read を選択します。

これらのログを有効にすると、元のクエリを使用して、非推奨の API に対する読み取り呼び出しと書き込み呼び出しの両方を確認できます。

サードパーティコンポーネントのアップグレード

非推奨に関する分析情報に、クラスタ内の非推奨の API を呼び出すサードパーティエージェントの結果が表示されます。

非推奨の API を呼び出しているサードパーティエージェントを解決するには、次のベストプラクティスをおすすめします。

サードパーティソフトウェアのプロバイダに問い合わせて、最新バージョンを確認します。
サードパーティソフトウェアを最新バージョンにアップグレードします。ソフトウェアをアップグレードできない場合は、GKE を非推奨の API を削除したバージョンにアップグレードするとサービスが停止するかどうかをテストする必要があります。

本番環境クラスタをアップグレードする前に、ステージングクラスタでこのアップグレードと GKE バージョンのアップグレードを行って、中断が発生しないかどうかモニタリングすることをおすすめします。

非推奨化の影響を受けるクラスタを更新する

非推奨の影響を受けるクラスタをアップグレードする手順は、次のとおりです。

ログで、非推奨の API を使用しているユーザーエージェントを確認します。
非推奨の API を使用するユーザーエージェントを、サポート対象の API バージョンを使用するように更新します。
非推奨の API を呼び出すサードパーティソフトウェアを最新バージョンに更新します。
非推奨の API が使用不能になった場合の中断のリスクを軽減するために、本番環境クラスタをアップグレードする前に、テスト用クラスタをアップグレードしてテスト環境でアプリケーションをテストします。
影響を受けるユーザーエージェントを更新できない場合は、別のテストクラスタをアップグレードして、アップグレードで中断が発生するかどうかを確認します。アップグレードで中断が発生しない場合は、クラスタを手動でアップグレードできます。
すべてのユーザーエージェントを更新すると、GKE は非推奨の API の使用が 30 日間観察されなくなるまで待機し、その後、自動アップグレードのブロックを解除します。自動アップグレードはリリーススケジュールに沿って行われます。

リソース

詳細については、以下の OSS Kubernetes ドキュメントをご覧ください。