Migrace instancí Azure Kubernetes Fleet Manageru ve verzi Preview do podporovaného stavu

Během fáze Preview Azure Kubernetes Fleet Manageru (Kubernetes Fleet) došlo ke změně rozhraní API pro interní vlastní definici prostředků (CRD), která má vliv na malé množství instancí flotily Kubernetes vytvořených během veřejné verze Preview služby.

Společnost Microsoft oznámila ovlivněným uživatelům Kubernetes Fleet, kteří můžou tento článek použít k identifikaci instancí flotily Kubernetes ovlivněných touto změnou.

Změna rozhraní API pro vlastní definice prostředků kubernetes fleetu (CRD) se zobrazuje v tabulce.

Stará definice rozhraní API (nepodporovaná)	Nová definice rozhraní API (podporovaná)
memberclusters.fleet.azure.com/v1alpha1	memberclusters.cluster.kubernetes-fleet.io/v1
internalmemberclusters.fleet.azure.com/v1alpha1	internalmemberclusters.cluster.kubernetes-fleet.io/v1

Od března 2025 už staré definice rozhraní API nedostávají podporu ani aktualizace a budou odebrány z nasazení platformy.

Správci s ovlivněnými instancemi Kubernetes Fleet potřebují vytvořit novou instanci Flotily Kubernetes a ručně přenést členské clustery. Jedná se o jednorázovou aktivitu.

Požadavky

• Uživateli, který tuto aktivitu podniká, musí být přiřazena role Azure Kubernetes Fleet Manager RBAC Cluster Admin Entra ID.

• Potřebujete nainstalovat Azure CLI verze 2.70.0 nebo novější. Pokud chcete nainstalovat nebo upgradovat, přečtěte si téma Instalace Azure CLI.

• Potřebujete fleet rozšíření Azure CLI verze 1.5.0 nebo novější, které můžete nainstalovat spuštěním následujícího příkazu:

  az extension add --name fleet
  

  Spuštěním následujícího příkazu aktualizujte nejnovější verzi vydaného rozšíření:

  az extension update --name fleet
  

Identifikace ovlivněných instancí

1. Nastavte správné předplatné Azure. Pokud jste od Microsoftu dostali oznámení, obsahuje toto oznámení jedno nebo více ID předplatného, které byste měli použít.

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

2. Vyhledejte všechny instance Kubernetes Fleet, které máte v předplatném.

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

   Pokud máte nasazených více instancí Flotily Kubernetes, můžete filtrovat instance vytvořené v roce 2022 nebo 2023, které můžou být ovlivněné. Instance z roku 2024 nejsou ovlivněné.

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

   Pokud výše uvedený dotaz vrátí všechny odpovídající instance, určete, jestli instance používají vyřazené rozhraní CRD API Kubernetes, jak je popsáno v dalších krocích.

3. Stáhněte si přihlašovací údaje pro uzlový cluster flotily Kubernetes.

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

4. Dotazem na rozhraní Kubernetes Fleet Hub API centra Kubernetes zjistěte, jestli jsou nasazené staré verze CRD.

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

   Pokud se oba dotazy vrátí Error from server (NotFound) customresourcedefinitions.apiextensions.k8s.io, vybraná instance Kubernetes Fleet není ovlivněná a nevyžaduje se žádná další akce.

   Pokud jsou ovlivněné nějaké instance, pro kroky nápravy se podívejte do další části.

Řešení ovlivněných případů

Pokud identifikujete všechny ovlivněné instance Kubernetes Fleet, budete muset provést následující kroky.

1. Zdokumentujte všechna spuštění aktualizací a pravidla umístění prostředků clusteru definovaná v ovlivněné instanci Kubernetes Fleet.
2. Odeberte všechny členské clustery z ovlivněné instance Kubernetes Fleet.
3. Vytvořte novou instanci Kubernetes Fleet Manageru a podle potřeby přidružte členské clustery.
4. Znovu použít a ověřit všechny konfigurace, které jste si poznamenali ze staré instance Kubernetes Fleet.
5. Odstraňte starou instanci Kubernetes Fleet.