Gestione cluster: come gestire Cluster Manager in Operator Nexus

Articolo
05/31/2024

Cluster Manager viene distribuito nella sottoscrizione di Azure dell'operatore per gestire il ciclo di vita di Operator Nexus Infrastructure Clusters.

Operazioni preliminari

Saranno necessari gli elementi seguenti:

ID sottoscrizione di Azure: ID sottoscrizione di Azure in cui deve essere creato Cluster Manager (deve essere lo stesso ID sottoscrizione del controller di infrastruttura di rete).
ID controller di infrastruttura di rete: controller di infrastruttura di rete e Gestione cluster hanno un'associazione 1:1. Sarà necessario l'ID risorsa del controller di infrastruttura di rete associato a Gestione cluster.
ID area di lavoro Log Analytics: ID risorsa dell'area di lavoro Log Analytics usata per la raccolta dei log.
Area di Azure: Cluster Manager deve essere creato nella stessa area di Azure del controller di infrastruttura di rete. Questa area di Azure deve essere usata nel Location campo di Gestione cluster e di tutte le istanze di Operator Nexus associate.

Argomenti globali

Alcuni argomenti disponibili per ogni comando dell'interfaccia della riga di comando di Azure

--debug : stampa altre informazioni sulle operazioni dell'interfaccia della riga di comando, usate a scopo di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.
--help -h : stampa le informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenca i sottogruppi e i comandi disponibili.
--only-show-errors - Mostra solo gli errori, eliminando gli avvisi.
--output -o - specifica il formato di output. I formati di output disponibili sono Json, Jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'interfaccia della riga di comando restituisce Json.
--query: usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di Azure.
--verbose : stampa informazioni sulle risorse create in Azure durante un'operazione e altre informazioni utili

Elementi di Cluster Manager

Elementi	Descrizione
Nome, ID, posizione, tag, tipo	Nome: nome descrittivo dell'utente ID: < ID risorsa > Località: area di Azure in cui viene creato Cluster Manager. Usare i valori ottenuti con `az account list -locations`. Tag: tag delle risorse Tipo: Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	ExtendedLocation associato a Gestione cluster
managedResourceGroupConfiguration	Informazioni sul gruppo di risorse gestite
fabricControllerId	Riferimento al controller di infrastruttura di rete 1:1 con gestione cluster
analyticsWorkspaceId	Questa area di lavoro sarà la posizione in cui verranno inoltrati tutti i log rilevanti per il cliente.
clusterVersions[]	Elenco di oggetti ClusterAvailableVersions. Versioni del cluster supportate dal gestore. Verrà usato come input nella proprietà cluster clusterVersion.
provisioningState	Succeeded, Failed, Canceled, Provisioning, Accepted, Updating
detailedStatus	Stati dettagliati che forniscono informazioni aggiuntive sullo stato di Gestione cluster.
detailedStatusMessage	Messaggio descrittivo sull'oggetto detailedStatus corrente.

Creare un cluster manager

Creare Cluster Manager usando l'interfaccia della riga di comando az:

Usare il az networkcloud clustermanager create comando per creare un cluster manager. Questo comando crea un nuovo Cluster Manager o aggiorna le proprietà di Gestione cluster, se presente. Se sono presenti più sottoscrizioni di Azure, selezionare l'ID sottoscrizione appropriato usando il comando 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"

Argomenti
- --name -n [Obbligatorio] - Nome di Gestione cluster.
- --fabric-controller-id [Obbligatorio] - ID risorsa del controller di infrastruttura di rete associato a Gestione cluster.
- --resource-group -g [Obbligatorio] - Nome del gruppo di risorse. È possibile configurare il gruppo di risorse predefinito usando az configure --defaults group=<name>.
- --analytics-workspace-id - ID risorsa dell'area di lavoro Log Analytics usata per la raccolta dei log
- --location -l - Posizione. Area di Azure in cui viene creato Cluster Manager. Usare i valori ottenuti con az account list -locations. È possibile configurare la posizione predefinito con az configure --defaults location="$LOCATION".
- --managed-resource-group-configuration : configurazione del gruppo di risorse gestito associato alla risorsa.
  - Utilizzo: --managed-resource-group-configuration location=XX name=XX
  - location: area del gruppo di risorse gestite. Se non specificato, viene scelta l'area della risorsa padre.
  - name: nome del gruppo di risorse gestite. Se non specificato, viene generato automaticamente un nome univoco.
- wait/--no-wait : attendere il completamento del comando o non attendere il completamento dell'operazione a esecuzione prolungata.
- --tags - Tag separati da spazi: key[=value] [key[=value]...]. Usare '' per cancellare i tag esistenti
- --subscription : nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Creare Cluster Manager usando l'editor di modelli di Azure Resource Manager:

Un modo alternativo per creare un Cluster Manager consiste nell'editor di modelli di Resource Manager.

Per creare il cluster in questo modo, è necessario fornire un file di modello (clusterManager.jsonc) e un file di parametri (clusterManager.parameters.jsonc).

Ecco alcuni esempi di questi due file:

clusterManager.jsonc , clusterManager.parameters.jsonc

Nota

Per ottenere la formattazione corretta, copiare il file di codice non elaborato. I valori all'interno del file clusterManager.parameters.jsonc sono specifici del cliente e potrebbero non essere un elenco completo. Aggiornare i campi valore per l'ambiente specifico.

In un Web browser passare al portale di Azure ed eseguire l'accesso.
Nella barra di ricerca portale di Azure cercare "Distribuisci un modello personalizzato" e quindi selezionarlo dai servizi disponibili.
Fare clic su Compila un modello personalizzato nell'editor.
Fare clic su Carica file. Individuare il file del modello clusterManager.jsonc e caricarlo.
Fare clic su Salva.
Fare clic su Modifica parametri.
Fare clic su Carica file. Individuare il file di parametri clusterManager.parameters.jsonc e caricarlo.
Fare clic su Salva.
Selezionare la sottoscrizione corretta.
Cercare il gruppo di risorse se esiste già o crearne uno nuovo.
Assicurarsi che tutti i dettagli dell'istanza siano corretti.
Fare clic su Rivedi e crea.

Elencare/visualizzare Cluster Manager

Elencare e visualizzare i comandi vengono usati per ottenere un elenco di gestioni cluster esistenti o le proprietà di un cluster manager specifico.

Elencare i gestori cluster nel gruppo di risorse

Questo comando elenca i gestori cluster nel gruppo di risorse specificato.

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

Elencare i gestori cluster nella sottoscrizione

Questo comando elenca i gestori cluster nella sottoscrizione specificata.

az networkcloud clustermanager list  --subscription "$SUB_ID"

Visualizzare le proprietà di Cluster Manager

Questo comando elenca le proprietà di Gestione cluster specificato.

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

Argomenti di comando elenco/visualizzazione

--name -n - Nome di Gestione cluster.
--ID - Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa".
--resource-group -g - Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
--subscription : nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Aggiornare Gestione cluster

Questo comando viene usato per applicare patch alle proprietà di Gestione cluster fornito o aggiornare i tag assegnati a Gestione cluster. Le proprietà e gli aggiornamenti dei tag possono essere eseguiti in modo indipendente.

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"

Argomenti
- --tags - Tag separati da TSpace: key[=value] [key[=value] ...]. Usare '' per cancellare i tag esistenti.
- --name -n - Nome di Gestione cluster.
- --ID - Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa".
- --resource-group -g - Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
- --subscription : nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Eliminare Gestione cluster

Questo comando viene usato per eliminare Gestione cluster fornito.

Avviso

Un cluster Manager con un controller di infrastruttura di rete associato esistente o qualsiasi cluster che fa riferimento a Gestione cluster potrebbe non essere eliminato.

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

Argomenti
- --no-wait - Non attendere il completamento dell'operazione a esecuzione prolungata.
- --sì -y - Non richiedere conferma.
- --name -n - Nome di Gestione cluster.
- --ID - Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa".
- --resource-group -g - Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
- --subscription : nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Passaggi successivi

Dopo aver creato correttamente nfc e Gestione cluster, il passaggio successivo consiste nel creare un'infrastruttura di rete.

Condividi tramite