Eseguire la migrazione delle istanze di anteprima di Azure Kubernetes Fleet Manager a uno stato supportato

Durante la fase di anteprima di Azure Kubernetes Fleet Manager (Kubernetes Fleet), è stata apportata una modifica dell'API CRD (Custom Resource Definition) interna che influisce su un numero ridotto di istanze di Kubernetes Fleet create durante l'anteprima pubblica del servizio.

Microsoft ha informato gli utenti interessati di Kubernetes Fleet che possono usare questo articolo per identificare le istanze di Kubernetes Fleet interessate dalla modifica.

La modifica dell'API CRD (Custom Resource Definitions) di Kubernetes Fleet è illustrata nella tabella.

Definizione API precedente (non supportata)	Nuova definizione dell'API (supportata)
memberclusters.fleet.azure.com/v1alpha1	memberclusters.cluster.kubernetes-fleet.io/v1
internalmemberclusters.fleet.azure.com/v1alpha1	internalmemberclusters.cluster.kubernetes-fleet.io/v1

A partire da marzo 2025, le definizioni api precedenti non ricevono più supporto o aggiornamenti e verranno rimosse dalle distribuzioni della piattaforma.

Gli amministratori con istanze di Kubernetes Fleet interessate devono creare una nuova istanza di Kubernetes Fleet e trasferire manualmente i cluster membri. Si tratta di un'attività monouso.

Prerequisiti

• All'utente che esegue questa attività deve essere assegnato il ruolo Entra ID Azure Kubernetes Fleet Manager RBAC Cluster Admin.

• Devi avere installata la versione 2.70.0 o successiva di Azure CLI. Per eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

• È necessaria l'estensione CLI di Azure versione 1.5.0 o successiva, è possibile installarla eseguendo il seguente comando:

  az extension add --name fleet
  

  Eseguire il comando seguente per aggiornare alla versione più recente dell'estensione rilasciata:

  az extension update --name fleet
  

Identificare le istanze interessate

1. Impostare la sottoscrizione di Azure corretta. Se è stata ricevuta una notifica da Microsoft, tale notifica contiene uno o più ID sottoscrizione da usare.

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

2. Trovare tutte le istanze di Kubernetes Fleet disponibili nella sottoscrizione.

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

   Se sono state distribuite più istanze di Kubernetes Fleet, è possibile filtrare le istanze create nel 2022 o 2023 che potrebbero essere interessate. Le istanze dal 2024 non sono interessate.

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

   Se la query precedente restituisce istanze corrispondenti, determinare se le istanze usano l'API CRD Kubernetes ritirata, come descritto nei passaggi successivi.

3. Scaricare le credenziali di Kubernetes per il cluster hub Kubernetes Fleet.

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

4. Eseguire query sull'API Kubernetes del cluster hub della flotta Kubernetes per determinare se vengono distribuite le vecchie versioni CRD.

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

   Se entrambe le query restituiscono Error from server (NotFound) customresourcedefinitions.apiextensions.k8s.io, l'istanza di Kubernetes Fleet selezionata non è interessata e non sono necessarie altre azioni.

   Se ci sono istanze interessate, vedere la sezione successiva per i passi di rimedio.

Risoluzione delle istanze interessate

Se si identificano istanze di Kubernetes Fleet interessate, è necessario eseguire i passaggi seguenti.

1. Documentare le esecuzioni degli aggiornamenti e le regole di posizionamento delle risorse del cluster definite nell'istanza di Kubernetes Fleet interessata.
2. Rimuovere tutti i cluster membri dall'istanza di Kubernetes Fleet interessata.
3. Creare una nuova istanza di Kubernetes Fleet Manager e associare i cluster membri in base alle esigenze.
4. Riapplicare e convalidare le configurazioni annotate dall'istanza precedente di Kubernetes Fleet.
5. Eliminare l'istanza precedente di Kubernetes Fleet.