Condividi tramite

Gestire i nodi della cache usando l'interfaccia della riga di comando


Questo articolo descrive come creare, configurare e distribuire nodi della cache microsoft connessa per le aziende usando l'interfaccia della riga di comando di Azure.

Prerequisiti:

  1. Installarel'interfaccia della riga di comando di Azure: come installare l'interfaccia della riga di comando di Azure
  2. Installare l'estensione Cache connessa: installare l'estensione Cache connessa tramite il comando seguente
az extension add --name mcc

Per altre informazioni sull'installazione delle estensioni, vedere Installare l'estensione Cache connessa.



1. Creare un gruppo di risorse

Il primo passaggio consiste nel creare un gruppo di risorse, se non è già disponibile. Un gruppo di risorse di Azure è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure.

Per creare un gruppo di risorse, usare az group create. Per altri dettagli, vedere questo comando dell'interfaccia della riga di comando qui. 

az group create --name myrg --location westus

Dopo aver creato il gruppo di risorse, è necessario creare una risorsa Microsoft Connected Cache for Enterprise.

2. Creare una risorsa di Azure della cache connessa

Una risorsa di Azure della cache connessa è una risorsa di Azure di primo livello in cui è possibile creare nodi della cache.

Per creare una risorsa di Azure della cache connessa, usare az mcc ent resource create

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

Importante

Nell'output cercare operationStatus. operationStatus = Succeeded indica che i servizi hanno avviato correttamente la creazione della risorsa cache connessa.


Il passaggio successivo consiste nel creare un nodo della cache in questa risorsa.

3. Creare un nodo della cache

Per creare un nodo della cache, usare 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>

Importante

Nell'output cercare operationStatus. operationStatus = Succeeded indica che i servizi hanno avviato correttamente la creazione del nodo della cache.


4. Confermare la creazione del nodo della cache

Prima di iniziare a configurare il nodo della cache, è necessario verificare che il nodo della cache sia stato creato correttamente.

Per confermare la creazione del nodo della cache, usare az mcc ent node show


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

Importante

Nell'output cercare cacheNodeState. Se cacheNodeState = Non configurato, è possibile continuare con la configurazione del nodo della cache. Se cacheNodeState = Registrazione in corso, il nodo della cache è ancora in fase di creazione. Attendere un minuto o più ed eseguire di nuovo il comando.


Dopo aver confermato la creazione del nodo della cache, è possibile procedere alla configurazione del nodo della cache.

5. Configurare il nodo della cache

Per configurare il nodo della cache, usare az mcc ent node update

L'esempio seguente configura un nodo della cache Linux con proxy abilitato:

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>

Nota

  • Per un nodo della cache che deve essere distribuito nel sistema operativo host Windows, il percorso fisico dell'unità cache deve essere /var/mcc.
  • Nell'output cercare operationStatus. operationStatus = Succeeded indica che i servizi hanno aggiornato correttamente il nodo della cache. Si noterà anche che cacheNodeState mostrerà Not Provisioned.
  • Salvare i valori per physicalPath, sizeInGb, proxyPort, proxyHostName perché questi valori saranno necessari per costruire lo script di provisioning.

6. Ottenere i dettagli di provisioning per il nodo della cache

Dopo aver configurato correttamente il nodo della cache, il passaggio successivo consiste nel distribuire il nodo della cache in un computer host. Per distribuire il nodo della cache, è necessario creare uno script di provisioning con informazioni pertinenti.

Per ottenere le informazioni rilevanti per lo script di provisioning, usare 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

Importante

  • Salvare i valori risultanti per cacheNodeId, customerKey, mccResourceId, registrationKey. Questi GUID sono necessari per creare lo script di provisioning.
  • Nell'output cercare cacheNodeState. Se cacheNodeState = Non è stato effettuato il provisioning, è possibile continuare con il provisioning dei nodi della cache.
  • Se cacheNodeState = Non configurato, il nodo della cache non è stato configurato. Configurare il nodo della cache prima del provisioning.

Passaggio successivo

Per distribuire il nodo della cache in un computer host Windows , vedere

Distribuire il nodo della cache in Windows

Per distribuire il nodo della cache in un computer host Linux , vedere

Distribuire il nodo della cache in Linux


Script di esempio per creare e configurare in blocco più nodi della cache:

Di seguito è riportato uno pseudocodice di esempio su come creare script per la creazione e la configurazione bulk di una risorsa di Azure di Cache connessa e di più nodi della cache connessa:

#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
}