Uppgradera hubbklustertyp för Azure Kubernetes Fleet Manager-resurs

Artikel
12/11/2024

I den här artikeln får du lära dig hur du uppgraderar en Kubernetes Fleet Manager-resurs (Kubernetes Fleet) utan hubbkluster till en Kubernetes Fleet-resurs som har ett hubbkluster. När en Kubernetes Fleet-resurs skapas utan ett hubbkluster skapas inte ett centralt Azure Kubernetes Service-kluster (AKS) för Kubernetes Fleet-resursen. När en Kubernetes Fleet-resurs med ett hubbkluster skapas skapas ett centralt och hanterat AKS-kluster för att aktivera scenarier som arbetsbelastningsorkestrering och lager-4-belastningsutjämning.

Mer information finns i Välja ett Azure Kubernetes Fleet Manager-alternativ.

Förutsättningar och begränsningar

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Installera eller uppgradera Azure CLI till den senaste versionen.
Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Du måste ha en befintlig Kubernetes Fleet-resurs utan ett hubbkluster. Stegen i den här artikeln visar hur du skapar en Kubernetes Fleet-resurs utan ett hubbkluster. Om du redan har en kan du hoppa över den första konfigurationen och börja med klustertypen Uppgradera hubb för Kubernetes Fleet-resursen.
Den här artikeln innehåller även steg för att ansluta till medlemskluster. Om du planerar att följa med behöver du minst ett AKS-kluster.

Viktigt!

Kubernetes Fleet-resurser utan hubbkluster kan uppgraderas till en Kubernetes Fleet-resurs med ett hubbkluster. En Kubernetes Fleet-resurs som redan har ett hubbkluster kan dock inte nedgraderas till en Kubernetes Fleet-resurs utan ett hubbkluster. Alla konfigurationsalternativ och inställningar som är associerade med Kubernetes Fleet-resursen som har ett hubbkluster är oföränderliga och kan inte ändras när du har skapat eller uppgraderat. Du kan bara uppgradera från en Kubernetes Fleet-resurs utan ett hubbkluster till ett med ett hubbkluster via Azure CLI. För närvarande finns det ingen motsvarande Azure Portal upplevelse.

Inledande installation

Börja med att skapa en resursgrupp och en Kubernetes Fleet-resurs utan hubbkluster och ansluta till ditt befintliga AKS-kluster som medlem. Du måste upprepa az fleet member create kommandot för varje enskilt medlemskluster som du vill associera med vagnparksresursen.

RG=myResourceGroup
LOCATION=eastus
FLEET=myKubernetesFleet
FLEET_MEMBER=<name-identifying-member-cluster>
SUBSCRIPTION_ID=<your-subscription-id>
CLUSTER=<your-aks-cluster-name>

# Create resource group
az group create -n $RG -l $LOCATION

# Create a hubless fleet resource 
az fleet create -g $RG -n $FLEET

# Join member cluster to hubless fleet resource
az fleet member create --name $FLEET_MEMBER --fleet-name $FLEET --resource-group $RG --member-cluster-id /subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER

Uppgradera hubbklustertyp för Kubernetes Fleet-resursen

Om du vill uppgradera hubbklustertypen för Kubernetes Fleet-resursen az fleet create använder du kommandot med flagguppsättningen --enable-hub . Se till att inkludera andra relevanta konfigurationsalternativ eftersom vagnparksresursen blir oföränderlig när den här åtgärden har slutförts.

# Upgrade the Kubernetes fleet resource without a hub cluster to one with a hub cluster
az fleet create --name $FLEET --resource-group $RG --enable-hub

Verifiera uppgraderingen

När du har kört az fleet create kommandot för att uppgradera vagnparksresursen kontrollerar du att uppgraderingen lyckades genom att visa utdata. Bör provisioningState läsa Succeeded och fältet hubProfile ska finnas. Se till exempel följande utdata:

{
  ...
  "hubProfile": {
    "agentProfile": {
      "subnetId": null,
      "vmSize": null
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": false,
      "enableVnetIntegration": false,
      "subnetId": null
    },
    "dnsPrefix": "contoso-user-xxxx-xxxxxxx",
    "fqdn": "contoso-user-flth-xxxxxx-xxxxxxxx.hcp.eastus.azmk8s.io",
    "kubernetesVersion": "1.28.5",
    "portalFqdn": "contoso-user-flth-xxxxxxx-xxxxxxxx.portal.hcp.eastus.azmk8s.io"
  },
  "provisioningState": "Succeeded"
  ...
}

Återansluta till medlemskluster

Om du vill ansluta medlemskluster till den nyligen uppgraderade flottan använder du az fleet member reconcile kommandot för varje enskilt medlemskluster.

az fleet member reconcile -g $RG -f $FLEET -n $FLEET_MEMBER

Kommentar

Alla AKS-kluster som du ansluter till vagnparksresursen för första gången efter uppgraderingen redan har ägt rum behöver inte stämmas av med hjälp av az fleet member reconcile.

Kontrollera att medlemskluster har anslutits

För varje medlemskluster som du återansluter till den nyligen uppgraderade flottan visar du utdata och kontrollerar att provisioningState läser Succeeded. Till exempel:

{
  ...
  "provisioningState": "Succeeded"
  ...
}

Verifiera funktioner

Du behöver åtkomst till Kubernetes API för hubbklustret. Om du inte har åtkomst kan du läsa Mer information om Kubernetes-API:et för Access Fleet Hub-klustret.

Kontrollera att den nyligen uppgraderade Kubernetes Fleet-resursen fungerar korrekt och att medlemsklustren har anslutits genom att bekräfta att du kan komma åt hubbklustrets API-server med hjälp av kubectl get memberclusters kommandot .

Om det lyckas bör dina utdata se ut ungefär som i följande exempelutdata:

NAME           JOINED   AGE
aks-member-1   True     2m
aks-member-2   True     2m
aks-member-3   True     2m

Rensa resurser

När du är klar kan du ta bort flottans resurs och relaterade resurser genom att ta bort resursgruppen. Tänk på att den här åtgärden inte tar bort dina AKS-kluster om de finns i en annan resursgrupp.

az group delete -n $RG

Nästa steg

Nu när kubernetes Fleet-resursen har uppgraderats för att ha ett hubbkluster kan du dra nytta av funktioner som tidigare inte var tillgängliga för dig. Se till exempel:

Layer-4-belastningsutjämning mellan medlemskluster i flottan

Dela via