Udostępnij za pośrednictwem


Uaktualnianie typu klastra koncentratora dla zasobu usługi Azure Kubernetes Fleet Manager

Z tego artykułu dowiesz się, jak uaktualnić zasób usługi Azure Kubernetes Fleet Manager (Kubernetes Fleet) bez klastra koncentratora do zasobu Rozwiązania Kubernetes Fleet, który ma klaster koncentratora. Gdy zasób Platformy Kubernetes Fleet jest tworzony bez klastra koncentratora, centralny klaster usługi Azure Kubernetes Service (AKS) nie jest tworzony dla zasobu floty Kubernetes. Po utworzeniu zasobu Platformy Kubernetes Fleet z klastrem koncentratora tworzony jest centralny i zarządzany klaster usługi AKS w celu umożliwienia scenariuszy takich jak orkiestracja obciążeń i równoważenie obciążenia w warstwie 4.

Aby uzyskać więcej informacji, zobacz Wybieranie opcji Azure Kubernetes Fleet Manager.

Wymagania wstępne i ograniczenia

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

  • Zainstaluj lub uaktualnij interfejs wiersza polecenia platformy Azure do najnowszej wersji.
  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Musisz mieć istniejący zasób Rozwiązania Kubernetes Fleet bez klastra koncentratora. Kroki opisane w tym artykule pokazują, jak utworzyć zasób Rozwiązania Kubernetes Fleet bez klastra koncentratora. Jeśli masz już taką konfigurację, możesz pominąć początkową konfigurację i rozpocząć pracę z typem klastra centrum uaktualniania dla zasobu Floty Kubernetes.
  • Ten artykuł zawiera również kroki dotyczące dołączania do klastrów członkowskich. Jeśli planujesz wykonać te czynności, potrzebujesz co najmniej jednego klastra usługi AKS.

Ważne

Zasoby platformy Kubernetes Fleet bez klastra koncentratora można uaktualnić do zasobu Rozwiązania Kubernetes Fleet za pomocą klastra koncentratora. Jednak zasób Platformy Kubernetes Fleet, który ma już klaster koncentratora, nie może zostać obniżony do zasobu Platformy Kubernetes Fleet bez klastra koncentratora. Wszystkie opcje konfiguracji i ustawienia skojarzone z zasobem Rozwiązania Kubernetes Fleet, który ma klaster koncentratora, są niezmienne i nie można ich zmienić po utworzeniu ani czasie uaktualniania. Uaktualnienie z zasobu Platformy Kubernetes Fleet bez klastra koncentratora do jednego z klastrem koncentratora można wykonać tylko za pośrednictwem interfejsu wiersza polecenia platformy Azure. Obecnie nie ma równoważnego środowiska witryny Azure Portal.

Konfiguracja początkowa

Aby rozpocząć, utwórz grupę zasobów i zasób Rozwiązania Kubernetes Fleet bez klastra koncentratora i dołącz istniejący klaster usługi AKS jako członek. Należy powtórzyć az fleet member create polecenie dla każdego klastra członkowskiego, który chcesz skojarzyć z zasobem floty.

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

Uaktualnianie typu klastra koncentratora dla zasobu Rozwiązania Kubernetes Fleet

Aby uaktualnić typ klastra koncentratora dla zasobu Platformy Kubernetes Fleet, użyj az fleet create polecenia z zestawem --enable-hub flag. Pamiętaj, aby uwzględnić inne odpowiednie opcje konfiguracji, ponieważ zasób floty stanie się niezmienny po zakończeniu tej operacji.

# 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 

Weryfikowanie uaktualnienia

Po uruchomieniu az fleet create polecenia w celu uaktualnienia zasobu floty sprawdź, czy uaktualnienie zakończyło się pomyślnie, wyświetlając dane wyjściowe. Element provisioningState powinien zostać odczytany Succeeded , a hubProfile pole powinno istnieć. Zobacz na przykład następujące dane wyjściowe:

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

Ponowne dołączanie klastrów składowych

Aby ponownie połączyć klastry członkowskie z nowo uaktualnionym zasobem az fleet member reconcile floty, użyj polecenia dla każdego pojedynczego klastra członkowskiego.

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

Uwaga

Wszystkie klastry usługi AKS, które dołączasz do zasobu floty po raz pierwszy po przeprowadzeniu uaktualnienia, nie muszą być uzgadniane przy użyciu polecenia az fleet member reconcile.

Sprawdź, czy klastry członkowskie zostały pomyślnie przyłączone

Dla każdego klastra członkowskiego, który jest ponownie dołączany do nowo uaktualnionej floty, wyświetl dane wyjściowe i sprawdź, czy provisioningState odczytuje Succeededwartość . Na przykład:

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

Weryfikowanie funkcjonalności

Potrzebujesz dostępu do interfejsu API kubernetes klastra koncentratora. Jeśli nie masz dostępu, zobacz Access the Kubernetes API of the Fleet resource with Azure Kubernetes Fleet Manager (Uzyskiwanie dostępu do interfejsu API platformy Kubernetes w zasobie Fleet Manager za pomocą usługi Azure Kubernetes Fleet Manager).

Aby sprawdzić, czy nowo uaktualniony zasób Rozwiązania Kubernetes Fleet działa prawidłowo i czy klastry członkowskie zostały pomyślnie przyłączone, upewnij się, że możesz uzyskać dostęp do serwera interfejsu API klastra koncentratora przy użyciu kubectl get memberclusters polecenia .

W przypadku powodzenia dane wyjściowe powinny wyglądać podobnie do następujących przykładowych danych wyjściowych:

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

Czyszczenie zasobów

Po zakończeniu możesz usunąć zasób floty i powiązane zasoby, usuwając grupę zasobów. Pamiętaj, że ta operacja nie spowoduje usunięcia klastrów usługi AKS, jeśli znajdują się w innej grupie zasobów.

az group delete -n $RG

Następne kroki

Teraz, gdy zasób platformy Kubernetes Fleet został uaktualniony, aby mieć klaster koncentratora, możesz skorzystać z funkcji, które były wcześniej niedostępne. Zobacz na przykład: