Partager via

Gérer les nœuds de cache à l’aide de l’interface CLI


Cet article explique comment créer, configurer et déployer des nœuds de cache Microsoft Connected Cache pour Entreprise à l’aide d’Azure CLI.

Conditions préalables :

  1. Installer Azure CLI : Comment installer Azure CLI
  2. Installer l’extension Connected Cache : Installez l’extension Connected Cache via la commande ci-dessous
az extension add --name mcc

Pour en savoir plus sur l’installation des extensions, consultez Installer l’extension Connected Cache.



1. Créer un groupe de ressources

La première étape consiste à créer un groupe de ressources si vous n’en avez pas déjà un. Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.

Pour créer un groupe de ressources, utilisez az group create. Vous trouverez plus d’informations sur cette commande CLI ici. 

az group create --name myrg --location westus

Une fois le groupe de ressources créé, vous devez créer une ressource Microsoft Connected Cache for Enterprise.

2. Créer une ressource Azure de cache connecté

Une ressource Azure de cache connecté est une ressource Azure de niveau supérieur sous laquelle des nœuds de cache peuvent être créés.

Pour créer une ressource Azure de cache connecté, utilisez az mcc ent resource create

az mcc ent resource create --mcc-resource-name mymccresource --resource-group myrg

Important

Dans la sortie, recherchez operationStatus. operationStatus = Succeeded indique que nos services ont correctement commencé à créer votre ressource de cache connecté.


L’étape suivante consiste à créer un nœud de cache sous cette ressource.

3. Créer un nœud de cache

Pour créer un nœud de cache, utilisez az mcc ent node create

az mcc ent node create --cache-node-name mycachenode --mcc-resource-name mymccresource --resource-group myrg --host-os <linux or windows>

Important

Dans la sortie, recherchez operationStatus. operationStatus = Succeeded indique que nos services ont correctement commencé à créer un nœud de cache.


4. Confirmer la création du nœud de cache

Avant de commencer à configurer votre nœud de cache, vous devez vérifier que le nœud de cache a bien été créé.

Pour confirmer la création d’un nœud de cache, utilisez az mcc ent node show


az mcc ent node show --cache-node-name mycachenode --mcc-resource-name mymccresource --resource-group myrg

Important

Dans la sortie, recherchez cacheNodeState. Si cacheNodeState = Non configuré, vous pouvez poursuivre la configuration du nœud de cache. Si cacheNodeState = Inscription en cours, le nœud de cache est toujours en cours de création. Patientez une ou deux minutes de plus et réexécutez la commande.


Une fois la création réussie du nœud de cache confirmée, vous pouvez continuer à configurer le nœud de cache.

5. Configurer le nœud de cache

Pour configurer votre nœud de cache, utilisez az mcc ent node update

L’exemple ci-dessous configure un nœud de cache Linux avec le proxy activé :

az mcc ent node update --cache-node-name <mycachenode> --mcc-resource-name <mymccresource> --resource-group <myrg>
--cache-drive "[{physical-path:</physical/path>,size-in-gb:<size of cache drive>},{</physical/path>,size-in-gb:<size of cache drive>}...]"> --proxy <enabled> --proxy-host <"proxy host name"> --proxy-port <proxy port>  --auto-update-day <day of week> --auto-update-time <time of day> --auto-update-week <week of month> --auto-update-ring <update ring>

Remarque

  • Pour un nœud de cache qui doit être déployé sur le système d’exploitation hôte Windows, le chemin physique du lecteur de cache doit être /var/mcc.
  • Dans la sortie, recherchez operationStatus. operationStatus = Succeeded indique que nos services ont correctement mis à jour le nœud de cache. Vous verrez également que cacheNodeState affichera Non provisionné.
  • Enregistrez les valeurs pour physicalPath, sizeInGb, proxyPort et proxyHostName, car ces valeurs seront nécessaires pour construire le script d’approvisionnement.

6. Obtenir les détails d’approvisionnement du nœud de cache

Après avoir configuré le nœud de cache, l’étape suivante consiste à déployer le nœud de cache sur un ordinateur hôte. Pour déployer le nœud de cache, vous devez créer un script d’approvisionnement avec des informations pertinentes.

Pour obtenir les informations pertinentes pour le script d’approvisionnement, utilisez az mcc ent node get-provisioning-details

az mcc ent node get-provisioning-details --cache-node-name mycachenode --mcc-resource-name mymccresource --resource-group myrg

Important

  • Enregistrez les valeurs obtenues pour cacheNodeId, customerKey, mccResourceId, registrationKey. Ces GUID sont nécessaires pour créer le script d’approvisionnement.
  • Dans la sortie, recherchez cacheNodeState. Si cacheNodeState = Non provisionné, vous pouvez poursuivre l’approvisionnement des nœuds de cache.
  • Si cacheNodeState = Non configuré, le nœud de cache n’a pas été configuré. Configurez le nœud de cache avant l’approvisionnement.

Étape suivante

Pour déployer le nœud de cache sur un ordinateur hôte Windows , consultez

Déployer le nœud de cache sur Windows

Pour déployer le nœud de cache sur un ordinateur hôte Linux , consultez

Déployer un nœud de cache sur Linux


Exemple de script pour créer et configurer plusieurs nœuds de cache en bloc :

Voici un exemple de pseudocode montrant comment créer des scripts de création et de configuration en bloc d’une ressource Azure de cache connecté et de plusieurs nœuds de cache de cache connecté :

#Define variables
$mccResourceName = "myMCCResource"
$cacheNodeName = "demo-node"
$cacheNodeOperatingSystem = "Windows"
$resourceGroup = "myRG"
$resourceLocation = "westus"
$cacheNodesToCreate = 2
$proxyHost = "myProxy.com"
$proxyPort = "8080"
$waitTime = 3

# Create Microsoft Connected Cache Azure resource
az mcc ent resource create --mcc-resource-name $mccResourceName --location $resourceLocation --resource-group $resourceGroup

#Loop through $cacheNodesToCreate iterations
for ($cacheNodeNumber = 1; $cacheNodeNumber -le $cacheNodesToCreate; $cacheNodeNumber++) {
    $iteratedCacheNodeName = $cacheNodeName + "-" + $cacheNodeNumber
    
    #Create cache node
    az mcc ent node create --cache-node-name $iteratedCacheNodeName --mcc-resource-name $mccResourceName --host-os $cacheNodeOperatingSystem --resource-group $resourceGroup

    #Get cache node state
    $cacheNodeState = $(az mcc ent node show --cache-node-name $iteratedCacheNodeName --mcc-resource-name $mccResourceName --resource-group $resourceGroup --query "cacheNodeState") | ConvertFrom-Json

    $howLong = 0
    #Wait until cache node state returns "Not Configured"
    while ($cacheNodeState -ne "Not Configured") {
        Write-Output "Waiting for cache node creation to complete...$howLong seconds"
        Start-Sleep -Seconds $waitTime
        $howLong += $waitTime
    
        $cacheNodeState = $(az mcc ent node show --cache-node-name $iteratedCacheNodeName --mcc-resource-name $mccResourceName --resource-group $resourceGroup --query "cacheNodeState") | ConvertFrom-Json
    }

    #Configure cache node
    az mcc ent node update --cache-node-name $iteratedCacheNodeName --mcc-resource-name $mccResourceName --resource-group $resourceGroup --cache-drive  "[{physical-path:/var/mcc,size-in-gb:50}]" --proxy enabled --proxy-host $proxyHost --proxy-port $proxyPort
}