Gestionnaire de cluster : comment gérer le gestionnaire de cluster dans Operator Nexus

Article
10/26/2023

Le Gestionnaire de cluster est déployé dans l’abonnement Azure de l’opérateur pour gérer le cycle de vie des clusters d’infrastructure Nexus de l’opérateur.

Avant de commencer

Vous devez disposer des éléments suivants :

ID d’abonnement Azure : ID d’abonnement Azure où cluster Manager doit être créé (doit être le même ID d’abonnement que le contrôleur Network Fabric).
ID du contrôleur Network Fabric - Network Fabric Controller et Cluster Manager ont une association 1 :1. Vous aurez besoin de l’ID de ressource du contrôleur Network Fabric associé au Gestionnaire de cluster.
ID de l’espace de travail Log Analytics : ID de ressource de l’espace de travail Log Analytics utilisé pour la collection de journaux.
Région Azure : Cluster Manager doit être créé dans la même région Azure que le contrôleur Network Fabric. Cette région Azure doit être utilisée dans le Location champ du Gestionnaire de clusters et toutes les instances Nexus d’opérateur associées.

Arguments globaux

Certains arguments disponibles pour chaque commande Azure CLI

--debug - imprime encore plus d’informations sur les opérations CLI, utilisées à des fins de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
--help -h - imprime les informations de référence cli sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles.
--only-show-errors - Afficher uniquement les erreurs, en supprimant les avertissements.
--output -o - spécifie le format de sortie. Les formats de sortie disponibles sont Json, Jsonc (JSON colorisé), tsv (Valeurs séparées par tabulation), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère Json.
--query : utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services Azure.
--verbose - imprime des informations sur les ressources créées dans Azure pendant une opération et d’autres informations utiles

Éléments du Gestionnaire de clusters

Éléments	Description
Nom, ID, emplacement, balises, type	Nom : Nom convivial ID : < ID de ressource > Emplacement : région Azure où le Gestionnaire de cluster est créé. Valeurs provenant de : `az account list -locations`. Balises : Balises de ressource Type : Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	ExtendedLocation associé au Gestionnaire de clusters
managedResourceGroupConfiguration	Informations sur le groupe de ressources managées
fabricControllerId	Référence au contrôleur Network Fabric qui est 1 :1 avec ce Gestionnaire de cluster
analyticsWorkspaceId	Cet espace de travail sera l’endroit où tous les journaux pertinents pour le client seront relayés.
clusterVersions[]	Liste des objets ClusterAvailableVersions. Versions de cluster prises en charge par le gestionnaire. Sera utilisé comme entrée dans la propriété clusterVersion.
provisioningState	Réussite, échec, annulation, approvisionnement, acceptation, mise à jour
detailedStatus	États détaillés qui fournissent des informations supplémentaires sur l’état du Gestionnaire de clusters.
detailedStatusMessage	Message descriptif sur l’état détaillé actuel.

Créer un Gestionnaire de cluster

Utilisez la az networkcloud clustermanager create commande pour créer un Gestionnaire de cluster. Cette commande crée un gestionnaire de cluster ou met à jour les propriétés du Gestionnaire de cluster s’il existe. Si vous avez plusieurs abonnements Azure, sélectionnez l’ID d’abonnement approprié à l’aide de la commande 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>

Arguments
- --name -n [Obligatoire] : nom du Gestionnaire de clusters.
- --fabric-controller-id [Obligatoire] : ID de ressource du contrôleur Network Fabric associé au Gestionnaire de cluster.
- --resource-group -g [Obligatoire] - Nom du groupe de ressources. Vous pouvez configurer le groupe de ressources par défaut à l’aide az configure --defaults group=<name>de .
- --analytics-workspace-id - ID de ressource de l’espace de travail Log Analytics utilisé pour la collection de journaux
- --location -l - Emplacement. Région Azure où le Gestionnaire de clusters est créé. Valeurs provenant de : az account list -locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.
- --managed-resource-group-configuration - Configuration du groupe de ressources managé associé à la ressource.
  - Utilisation : --managed-resource-group-configuration location=XX name=XX
  - emplacement : région du groupe de ressources managé. Si elle n’est pas spécifiée, la région de la ressource parente est choisie.
  - nom : nom du groupe de ressources managé. S’il n’est pas spécifié, un nom unique est généré automatiquement.
- wait/-no-wait : attendez la fin de la commande ou n’attendez pas la fin de l’opération de longue durée.
- --tags - Balises séparées par l’espace : key[=value] [key[=value]...]. Utiliser ' pour effacer les balises existantes
- --subscription - Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Répertorier/afficher le ou les gestionnaires de cluster

Les commandes list et show sont utilisées pour obtenir une liste des gestionnaires de cluster existants ou les propriétés d’un gestionnaire de cluster spécifique.

Répertorier les gestionnaires de cluster dans le groupe de ressources

Cette commande répertorie les gestionnaires de cluster dans le groupe de ressources spécifié.

az networkcloud clustermanager list --resource-group <Azure Resource group>

Répertorier les gestionnaires de cluster dans l’abonnement

Cette commande répertorie les gestionnaires de cluster dans l’abonnement spécifié.

az networkcloud clustermanager list  --subscription <subscription ID>

Afficher les propriétés du Gestionnaire de cluster

Cette commande répertorie les propriétés du Gestionnaire de cluster spécifié.

az networkcloud clustermanager show \
    --name <Cluster Manager name> \
    --resource-group <Resource group Name>
    --subscription <subscription ID>

Arguments de commande List/Show

--name -n - Nom du Gestionnaire de cluster.
--ID - Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ».
--resource-group -g - Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.
--subscription - Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Mettre à jour le Gestionnaire de clusters

Cette commande est utilisée pour corriger les propriétés du Gestionnaire de cluster fourni ou mettre à jour les balises affectées au Gestionnaire de cluster. Les propriétés et les mises à jour des balises peuvent être effectuées indépendamment.

az networkcloud clustermanager update \
    --name <Cluster Manager name> \
    --tags < <key1=value1> <key2=value2>>
    --resource-group <Resource group Name>
    --subscription <subscription ID>

Arguments
- --tags - Balises séparées par TSpace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
- --name -n - Nom du Gestionnaire de cluster.
- --ID - Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ».
- --resource-group -g - Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.
- --subscription - Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Supprimer le Gestionnaire de cluster

Cette commande est utilisée pour supprimer le Gestionnaire de cluster fourni.

Avertissement

Un Gestionnaire de cluster qui a un contrôleur Network Fabric associé existant ou tous les clusters qui référencent ce Gestionnaire de cluster ne peuvent pas être supprimés.

az networkcloud clustermanager delete \
    --name <Cluster Manager name> \
    --resource-group <Resource Group Name>
    --subscription <subscription ID>

Arguments
- --no-wait - N’attendez pas que l’opération de longue durée se termine.
- --oui -y - N’invitez pas à confirmer.
- --name -n - Nom du Gestionnaire de cluster.
- --ID - Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ».
- --resource-group -g - Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.
- --subscription - Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Partager via