次の方法で共有

Azure Kubernetes Fleet Manager プレビュー インスタンスをサポートされている状態に移行する

Azure Kubernetes Fleet Manager (Kubernetes Fleet) のプレビュー 段階で、サービス パブリック プレビュー中に作成された少数の Kubernetes Fleet インスタンスに影響する内部カスタム リソース定義 (CRD) API の変更が行われました。

この記事を使用して、変更の影響を受ける Kubernetes Fleet インスタンスを特定できる、影響を受ける Kubernetes Fleet ユーザーに Microsoft が通知しました。

Kubernetes Fleet カスタム リソース定義 (CRD) API の変更を表に示します。

古い API 定義 (サポートされていません) 新しい API 定義 (サポート)
memberclusters.fleet.azure.com/v1alpha1 memberclusters.cluster.kubernetes-fleet.io/v1
internalmemberclusters.fleet.azure.com/v1alpha1 internalmemberclusters.cluster.kubernetes-fleet.io/v1

2025 年 3 月の時点で、古い API 定義はサポートや更新プログラムを受け取らなくなり、プラットフォームのデプロイから削除されます。

影響を受ける Kubernetes Fleet インスタンスを持つ管理者は、新しい Kubernetes Fleet インスタンスを作成し、メンバー クラスターを手動で転送する必要があります。 これは 1 回限りのアクティビティです。

前提条件

  • このアクティビティを実行するユーザーには、 Azure Kubernetes Fleet Manager RBAC Cluster Admin Entra ID ロールを割り当てる必要があります。

  • Azure CLI バージョン 2.70.0 以降がインストールされている必要があります。 インストールとアップグレードについては、「Azure CLI のインストール」を参照してください。

  • fleet Azure CLI 拡張機能バージョン 1.5.0 以降が必要です。これは、次のコマンドを実行してインストールできます。

    az extension add --name fleet

    次のコマンドを実行して、リリースされた最新バージョンの拡張機能に更新します：

    az extension update --name fleet

影響を受けるインスタンスを特定する

  1. 適切な Azure サブスクリプションを設定します。 Microsoft から通知を受け取った場合、その通知には、使用する必要がある 1 つ以上のサブスクリプション ID が含まれています。

    az account set \
    --subscription <subscription-id>

  2. サブスクリプションに含まれているすべての Kubernetes Fleet インスタンスを見つけます。

    az resource list \
    --resource-type 'Microsoft.ContainerService/fleets'

    複数の Kubernetes Fleet インスタンスがデプロイされている場合は、影響を受ける可能性がある 2022 または 2023 で作成されたインスタンスにフィルター処理できます。 2024 のインスタンスは影響を受けません。

    az resource list \
    --resource-type 'Microsoft.ContainerService/fleets' \
    --query "[?contains(createdTime, '2023') || contains(createdTime, '2022')]"

    上記のクエリで一致するインスタンスが返される場合は、次の手順で説明するように、インスタンスが廃止された Kubernetes CRD API を使用しているかどうかを判断します。

  3. Kubernetes Fleet ハブ クラスターの Kubernetes 資格情報をダウンロードします。

    az fleet get-credentials \
    --resource-group <resource-group> \
    --name <fleet-name>

  4. Kubernetes Fleet ハブ クラスター Kubernetes API にクエリを実行して、古い CRD バージョンがデプロイされているかどうかを確認します。

    kubectl get crd memberclusters.fleet.azure.com
kubectl get crd internalmemberclusters.fleet.azure.com

    両方のクエリで Error from server (NotFound) customresourcedefinitions.apiextensions.k8s.ioが返された場合、選択した Kubernetes Fleet インスタンスは影響を受けず、それ以上のアクションは必要ありません。

    影響を受けるインスタンスがある場合は、次のセクションで修復手順を参照してください。

影響を受けるインスタンスの修復

影響を受ける Kubernetes Fleet インスタンスを特定する場合は、次の手順を実行する必要があります。

  1. 影響を受ける Kubernetes Fleet インスタンスで定義されている更新プログラムの実行とクラスター リソースの配置規則を文書化します。
  2. 影響を受ける Kubernetes Fleet インスタンスからすべてのメンバー クラスターを削除します。
  3. 新しい Kubernetes Fleet Manager インスタンスを作成し、必要に応じてメンバー クラスターを関連付けます。
  4. 古い Kubernetes Fleet インスタンスから指定したすべての構成を再適用して検証します。
  5. 古い Kubernetes Fleet インスタンスを削除します。