Klusterhanterare: Så här hanterar du klusterhanteraren i Operator Nexus

Artikel
05/31/2024

Klusterhanteraren distribueras i operatörens Azure-prenumeration för att hantera livscykeln för operatören Nexus-infrastrukturkluster.

Innan du börjar

Du behöver:

Azure-prenumerations-ID – Azure-prenumerations-ID där Klusterhanteraren måste skapas (bör vara samma prenumerations-ID för Network Fabric-styrenheten).
Network Fabric Controller-ID – Network Fabric Controller och Cluster Manager har en 1:1-association. Du behöver resurs-ID:t för nätverksinfrastrukturkontrollanten som är associerad med Klusterhanteraren.
Log Analytics-arbetsyte-ID – resurs-ID för Log Analytics-arbetsytan som används för loggsamlingen.
Azure-region – Klusterhanteraren ska skapas i samma Azure-region som Network Fabric Controller. Den här Azure-regionen ska användas i Location fältet klusterhanteraren och alla associerade Operator Nexus-instanser.

Begränsningar

Namngivning – Namngivningsregler finns här.

Globala argument

Vissa argument som är tillgängliga för varje Azure CLI-kommando

--debug – skriver ut ännu mer information om CLI-åtgärder som används för felsökning. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport.
--help -h – skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors – Visa bara fel, ignorera varningar.
--output -o – anger utdataformatet. De tillgängliga utdataformaten är Json, Jsonc (färgad JSON), tsv (Tab-Separated Values), table (humanläsbara ASCII-tabeller) och yaml. Som standard matar CLI ut Json.
--query – använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure-tjänster.
--verbose – skriver ut information om resurser som skapats i Azure under en åtgärd och annan användbar information

Klusterhanterarens element

Element	beskrivning
Namn, ID, plats, taggar, typ	Namn: Användarvänligt namn ID: < Resurs-ID > Plats: Azure-region där Klusterhanteraren skapas. Värden från: `az account list -locations`. Taggar: Resurstaggar Typ: Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	ExtendedLocation som är associerad med Klusterhanteraren
managedResourceGroupConfiguration	Information om den hanterade resursgruppen
fabricControllerId	En referens till nätverksinfrastrukturkontrollanten som är 1:1 med den här klusterhanteraren
analyticsWorkspaceId	Den här arbetsytan är den plats där alla loggar som är relevanta för kunden vidarebefordras.
clusterVersions[]	Lista över ClusterAvailableVersions-objekt. Klusterversioner som hanteraren stöder. Kommer att användas som indata i klusterklusterVersion-egenskapen.
provisioningState	Lyckades, misslyckades, avbröts, etablerades, accepterades, uppdaterades
detailedStatus	Detaljerade statusar som ger ytterligare information om status för Klusterhanteraren.
detailedStatusMessage	Beskrivande meddelande om aktuell detailedStatus.

Skapa en klusterhanterare

Skapa klusterhanteraren med AZ CLI:

az networkcloud clustermanager create Använd kommandot för att skapa en klusterhanterare. Det här kommandot skapar en ny Klusterhanterare eller uppdaterar egenskaperna för Klusterhanteraren om den finns. Om du har flera Azure-prenumerationer väljer du lämpligt prenumerations-ID med kommandot az account set .

az networkcloud clustermanager create \
    --name "$CLUSTER_MANAGER_NAME" \
    --location "$LOCATION" \
    --analytics-workspace-id "$LAW_NAME" \
    --fabric-controller-id "$NFC_ID" \
    --managed-resource-group-configuration name="$MRG_NAME" location="$MRG_LOCATION" \
    --tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2"
    --resource-group "$CLUSTER_MANAGER_RG"
    --subscription "$SUB_ID"

Argument
- --name -n [Required] – Namnet på Klusterhanteraren.
- --fabric-controller-id [Krävs] – resurs-ID för nätverksinfrastrukturkontrollanten som är associerad med Klusterhanteraren.
- --resource-group -g [Krävs] – Namnet på resursgruppen. Du kan konfigurera standardresursgruppen med .az configure --defaults group=<name>
- --analytics-workspace-id – resurs-ID för Log Analytics-arbetsytan som används för loggsamlingen
- --location -l - Location. Azure-region där Klusterhanteraren skapas. Värden från: az account list -locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location="$LOCATION".
- --managed-resource-group-configuration – Konfigurationen av den hanterade resursgruppen som är associerad med resursen.
  - Användning: --managed-resource-group-configuration location=XX name=XX
  - plats: Regionen för den hanterade resursgruppen. Om det inte anges väljs regionen för den överordnade resursen.
  - name: Namnet på den hanterade resursgruppen. Om det inte anges genereras ett unikt namn automatiskt.
- wait/--no-wait – Vänta tills kommandot har slutförts eller vänta inte på att den långvariga åtgärden ska slutföras.
- --tags – Blankstegsavgränsade taggar: key[=value] [key[=value]...]. Använd "" för att rensa befintliga taggar
- --subscription – Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Skapa Klusterhanteraren med hjälp av Azure Resource Manager-mallredigeraren:

Ett alternativt sätt att skapa en klusterhanterare är med ARM-mallredigeraren.

För att kunna skapa klustret på det här sättet måste du ange en mallfil (clusterManager.jsonc) och en parameterfil (clusterManager.parameters.jsonc).

Du hittar exempel på dessa två filer här:

clusterManager.jsonc , clusterManager.parameters.jsonc

Kommentar

Kopiera den råa kodfilen för att få rätt formatering. Värdena i filen clusterManager.parameters.jsonc är kundspecifika och är kanske inte en fullständig lista. Uppdatera värdefälten för din specifika miljö.

I en webbläsare går du till Azure-portalen och loggar in.
I sökfältet i Azure-portalen söker du efter "Distribuera en anpassad mall" och väljer den sedan från de tillgängliga tjänsterna.
Klicka på Skapa en egen mall i redigeraren.
Klicka på Läs in fil. Leta upp mallfilen clusterManager.jsonc och ladda upp den.
Klicka på Spara.
Klicka på Redigera parametrar.
Klicka på Läs in fil. Leta upp parameterfilen clusterManager.parameters.jsonc och ladda upp den.
Klicka på Spara.
Välj rätt prenumeration.
Sök efter resursgruppen om den redan finns eller skapa ny.
Kontrollera att all instansinformation är korrekt.
Klicka på Granska och skapa.

Lista/visa Klusterhanterare

List- och visningskommandon används för att hämta en lista över befintliga klusterhanterare eller egenskaperna för en specifik klusterhanterare.

Lista klusterhanterare i resursgrupp

Det här kommandot visar klusterhanterare i den angivna resursgruppen.

az networkcloud clustermanager list --resource-group "$CLUSTER_MANAGER_RG"

Lista klusterhanterare i prenumeration

Det här kommandot visar klusterhanterare i den angivna prenumerationen.

az networkcloud clustermanager list  --subscription "$SUB_ID"

Visa egenskaper för Klusterhanteraren

Det här kommandot visar egenskaperna för den angivna Klusterhanteraren.

az networkcloud clustermanager show \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Lista/visa kommandoargument

--name -n – Namnet på Klusterhanteraren.
--ID:t – Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID".
--resource-group -g – Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
--subscription – Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Uppdatera Klusterhanteraren

Det här kommandot används för att korrigera egenskaperna för den angivna klusterhanteraren eller uppdatera taggarna som tilldelats klusterhanteraren. Egenskaper och tagguppdateringar kan göras oberoende av varandra.

az networkcloud clustermanager update \
    --name "$CLUSTER_MANAGER_NAME" \
    --tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Argument
- --tags – TSpace-avgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.
- --name -n – Namnet på Klusterhanteraren.
- --ID:t – Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID".
- --resource-group -g – Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
- --subscription – Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Ta bort klusterhanteraren

Det här kommandot används för att ta bort den angivna klusterhanteraren.

Varning

En klusterhanterare som har en befintlig associerad nätverksresursstyrenhet eller kluster som refererar till klusterhanteraren kanske inte tas bort.

az networkcloud clustermanager delete \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Argument
- --no-wait – Vänta inte tills den långvariga åtgärden har slutförts.
- --yes -y - Fråga inte efter bekräftelse.
- --name -n – Namnet på Klusterhanteraren.
- --ID:t – Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID".
- --resource-group -g – Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
- --subscription – Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Nästa steg

När du har skapat en NFC- och klusterhanterare är nästa steg att skapa en nätverksinfrastruktur.

Dela via