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

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>

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

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>

N’oubliez pas que la taille minimale d’un lecteur de cache est de 50 Go. Vous pouvez spécifier plusieurs lecteurs de cache pour les nœuds de cache hébergés sous Linux en ajoutant des entrées supplémentaires au --cache-drive paramètre .

6. Obtenir les détails de déploiement 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 une commande de déploiement à l’aide des identificateurs uniques des nœuds de cache.

Pour obtenir les informations pertinentes pour la commande de déploiement, utilisez az mcc ent node get-deployment-details.

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

Étape suivante

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

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

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
}