Gestione cluster: come gestire Cluster Manager in Operator Nexus

  • Articolo

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

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 <region> \
    --analytics-workspace-id <log analytics workspace ID>
    --fabric-controller-id <Fabric controller ID associated with this Cluster Manager>
    --managed-resource-group-configuration < name=<Managed Resource group Name> location=<Managed Resource group location> >
    --tags <key=value key=value>
    --resource-group <Resource Group Name>
    --subscription <subscription 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.

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 <Azure Resource group>

Elencare i gestori cluster nella sottoscrizione

Questo comando elenca i gestori cluster nella sottoscrizione specificata.

az networkcloud clustermanager list  --subscription <subscription 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 <Resource group Name>
    --subscription <subscription 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 < <key1=value1> <key2=value2>>
    --resource-group <Resource group Name>
    --subscription <subscription 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 <Resource Group Name>
    --subscription <subscription 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.