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

Article
06/04/2024

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

Avant de commencer

Vous devez disposer des éléments suivants :

ID d’abonnement Azure : ID d’abonnement Azure où le gestionnaire de cluster doit être créé (doit être le même ID d’abonnement que le contrôleur de structure réseau).
ID du contrôleur de structure réseau : le contrôleur de structure réseau et le gestionnaire de cluster présentent une association individuelle. Vous aurez besoin de l’ID de ressource du contrôleur de structure réseau 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 : le gestionnaire de cluster doit être créé dans la même région Azure que le contrôleur de structure réseau. Cette région Azure doit être utilisée dans le champ Location du gestionnaire de cluster et toutes les instances Operator Nexus associées.

Arguments globaux

Certains arguments sont disponibles pour chaque commande Azure CLI.

--debug : imprime davantage d’informations sur les opérations CLI, utilisées pour le 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 répertorie les commandes et sous-groupes disponibles.
--only-show-errors : affiche 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 des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère du code Json.
--query : utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services Azure.
--verbose : imprime les informations sur les ressources créées dans Azure pendant une opération ainsi que diverses autres informations utiles.

Éléments du gestionnaire de cluster

Éléments	Description
Nom, ID, emplacement, balises, type	Nom : nom convivial de l’utilisateur 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 cluster
managedResourceGroupConfiguration	Informations sur le groupe de ressources managées
fabricControllerId	Référence au contrôleur de structure réseau qui est associé individuellement à ce gestionnaire de cluster
analyticsWorkspaceId	Cet espace de travail est l’endroit où tous les journaux pertinents pour le client sont indiqué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	Succeeded (Réussi), Failed (Échoué), Canceled (Annulé), Provisioning (Approvisionnement), Accepted (Accepté), Updating (Mise à jour)
detailedStatus	États détaillés qui fournissent des informations supplémentaires sur l’état du gestionnaire de cluster.
detailedStatusMessage	Message descriptif sur le detailedStatus actuel.

Créer un gestionnaire de cluster

Créez le gestionnaire de cluster à l’aide de l’interface CLI AZ :

Utilisez la commande az networkcloud clustermanager create 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 "$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"

Arguments
- --name -n [Obligatoire] : nom du gestionnaire de cluster.
- --fabric-controller-id [Obligatoire] : ID de ressource du contrôleur de structure réseau associé au gestionnaire de cluster.
- --resource-group -g [Obligatoire] : nom du groupe de ressources. Vous pouvez configurer le groupe de ressources par défaut en utilisant az configure --defaults group=<name>.
- --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 cluster 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ées associé à la ressource.
  - Utilisation : --managed-resource-group-configuration location=XX name=XX
  - location : région du groupe de ressources managées. Si elle n’est pas spécifiée, la région de la ressource parente est choisie.
  - name : nom du groupe de ressources managées. S’il n’est pas spécifié, le nom du groupe est généré automatiquement.
- wait/-no-wait : attendre la fin de la commande ou ne pas attendre la fin de l’opération de longue durée.
- --tags : étiquettes séparées par des espaces : clé[=valeur] [clé[=valeur]...]. 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.

Créez le gestionnaire de cluster à l’aide de l’éditeur de modèle Azure Resource Manager :

Une autre façon de créer un gestionnaire de cluster est avec l’éditeur de modèle ARM.

Pour créer le cluster de cette façon, vous devez fournir un fichier de modèle (clusterManager.jsonc) et un fichier de paramètres (clusterManager.parameters.jsonc).

Vous trouverez des exemples de ces deux fichiers ici :

clusterManager.jsonc, clusterManager.parameters.jsonc

Remarque

Pour obtenir la mise en forme correcte, copiez le fichier de code brut. Les valeurs du fichier clusterManager.parameters.jsonc sont spécifiques au client et peuvent ne pas constituer une liste exhaustive. Veuillez mettre à jour les champs de valeurs en fonction de votre environnement.

Dans un navigateur web, accédez au portail Azure et connectez-vous à votre compte.
Dans la barre de recherche du portail Azure, recherchez « Déployer un modèle personnalisé », puis sélectionnez cette option parmi les services disponibles.
Cliquer sur Créer votre propre modèle dans l’éditeur.
Cliquez sur Charger le fichier. Recherchez votre fichier de modèle clusterManager.jsonc et chargez-le.
Cliquez sur Enregistrer.
Cliquez sur Modifier les paramètres.
Cliquez sur Charger le fichier. Recherchez votre fichier de paramètres clusterManager.parameters.jsonc et chargez-le.
Cliquez sur Enregistrer.
Sélectionnez l’abonnement approprié.
Recherchez le groupe de ressources s’il existe déjà ou créez-en un.
Vérifiez que tous les détails de l’instance sont corrects.
Cliquez sur Vérifier + créer.

Répertorier/afficher le ou les gestionnaires de cluster

Les commandes list et show permettent d’obtenir la 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 "$CLUSTER_MANAGER_RG"

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 "$SUB_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 "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Répertorier/afficher les arguments de commande

--name -n : nom du gestionnaire de cluster.
--IDs : un ou plusieurs ID de ressource (délimités par un 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 cluster

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 $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Arguments
- --tags : liste d’étiquettes séparées par des espaces : clé[=valeur] [clé[=valeur] ...]. Utilisez '' pour effacer des balises existantes.
- --name -n : nom du gestionnaire de cluster.
- --IDs : un ou plusieurs ID de ressource (délimités par un 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 de structure réseau 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 "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Arguments
- --no-wait : ne pas attendre que l’opération de longue durée se termine.
- --yes -y : ne pas demander de confirmation.
- --name -n : nom du gestionnaire de cluster.
- --IDs : un ou plusieurs ID de ressource (délimités par un 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.

Étapes suivantes

Une fois que vous avez créé un NFC et le gestionnaire de cluster, l’étape suivante consiste à créer une structure réseau.

Partager via