Upgrade typu clusteru centra pro prostředek Azure Kubernetes Fleet Manager

Článek
10/15/2024

V tomto článku se dozvíte, jak upgradovat prostředek Azure Kubernetes Fleet Manager (Kubernetes Fleet) bez clusteru centra na prostředek Kubernetes Fleet, který má cluster centra. Když se prostředek Kubernetes Fleet vytvoří bez clusteru centra, pro prostředek Kubernetes Fleet se nevytvořil centrální cluster Azure Kubernetes Service (AKS). Když se vytvoří prostředek Kubernetes Fleet s clusterem centra, vytvoří se centrální a spravovaný cluster AKS, který umožňuje scénáře, jako je orchestrace úloh a vyrovnávání zatížení vrstvy 4.

Další informace najdete v tématu Volba možnosti Azure Kubernetes Fleet Manager.

Předpoklady a omezení

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Nainstalujte nebo upgradujte Azure CLI na nejnovější verzi.
Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Musíte mít existující prostředek Kubernetes Fleet bez clusteru centra. Kroky v tomto článku ukazují, jak vytvořit prostředek Kubernetes Fleet bez clusteru centra. Pokud ho už máte, můžete počáteční nastavení přeskočit a začít u typu clusteru Centra upgradu pro prostředek Kubernetes Fleet.
Tento článek obsahuje také postup při připojování členských clusterů. Pokud budete chtít postup sledovat, potřebujete aspoň jeden cluster AKS.

Důležité

Prostředky Kubernetes Fleet bez clusteru centra je možné upgradovat na prostředek Kubernetes Fleet s clusterem centra. Prostředek Kubernetes Fleet, který už má cluster centra, ale nejde downgradovat na prostředek Kubernetes Fleet bez clusteru centra. Všechny možnosti konfigurace a nastavení přidružené k prostředku Kubernetes Fleet, který má cluster centra, jsou neměnné a po vytvoření nebo upgradu není možné změnit. Upgrade z prostředku Kubernetes Fleet bez clusteru centra na cluster s centrem je možné provést pouze prostřednictvím Azure CLI. V současné době neexistuje žádné ekvivalentní prostředí webu Azure Portal.

Počáteční nastavení

Začněte tím, že vytvoříte skupinu prostředků a prostředek Kubernetes Fleet bez clusteru centra a připojíte existující cluster AKS jako člena. Tento příkaz budete muset zopakovat az fleet member create pro každý jednotlivý členský cluster, který chcete přidružit k prostředku flotily.

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

Upgrade typu clusteru centra pro prostředek Kubernetes Fleet

Pokud chcete upgradovat typ clusteru centra pro prostředek Kubernetes Fleet, použijte az fleet create příkaz se --enable-hub sadou příznaků. Nezapomeňte zahrnout všechny další relevantní možnosti konfigurace, protože prostředek flotily se po dokončení této operace změní na neměnný.

# 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

Ověření upgradu

Po spuštění az fleet create příkazu pro upgrade prostředku flotily ověřte, že upgrade proběhl úspěšně, a to zobrazením výstupu. Mělo provisioningState by se číst Succeeded a hubProfile pole by mělo existovat. Podívejte se například na následující výstup:

{
  ...
  "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"
  ...
}

Znovu se připojit ke členským clusterům

Pokud chcete znovu připojit členské clustery k nově upgradovaného prostředku flotily, použijte az fleet member reconcile příkaz pro každý jednotlivý členský cluster.

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

Poznámka:

Všechny clustery AKS, ke kterým se připojujete k prostředku flotily poprvé po dokončení upgradu, není potřeba odsouhlasit použití az fleet member reconcile.

Ověření úspěšného připojení členských clusterů

Pro každý členský cluster, který se znovu připojíte k nově upgradovanému vozovému parku, zobrazte výstup a ověřte, že provisioningState se Succeededčte . Příklad:

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

Ověření funkčnosti

Potřebujete přístup k rozhraní Kubernetes API clusteru centra. Pokud nemáte přístup, přečtěte si téma o rozhraní Kubernetes API clusteru centra Access Fleet Hub.

Pokud chcete ověřit, že váš nově upgradovaný prostředek Kubernetes Fleet funguje správně a že se členské clustery úspěšně připojily, pomocí příkazu ověřte, že máte přístup k serveru kubectl get memberclusters rozhraní API clusteru centra.

Pokud je výstup úspěšný, měl by vypadat podobně jako v následujícím příkladu výstupu:

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

Vyčištění prostředků

Jakmile budete hotovi, můžete prostředky vozového parku a související prostředky odebrat odstraněním skupiny prostředků. Mějte na paměti, že tato operace neodebere clustery AKS, pokud se nacházejí v jiné skupině prostředků.

az group delete -n $RG

Další kroky

Teď, když je váš prostředek Kubernetes Fleet upgradovaný tak, aby měl cluster centra, můžete využít funkce, které pro vás byly dříve nedostupné. Příklad:

Vyrovnávání zatížení vrstvy 4 napříč clustery členů flotily

Sdílet prostřednictvím