Freigeben über

Verwalten von Cacheknoten mithilfe der CLI


In diesem Artikel wird beschrieben, wie Sie Microsoft Connected Cache for Enterprise-Cacheknoten mithilfe der Azure CLI erstellen, konfigurieren und bereitstellen.

Voraussetzungen:

  1. Installieren der Azure CLI: Installieren der Azure CLI
  2. Installieren der Connected Cache-Erweiterung: Installieren der Connected Cache-Erweiterung über den folgenden Befehl
az extension add --name mcc

Weitere Informationen zum Installieren von Erweiterungen finden Sie unter Installieren der Connected Cache-Erweiterung.



1. Erstellen einer Ressourcengruppe

Der erste Schritt besteht darin, eine Ressourcengruppe zu erstellen, sofern sie noch nicht vorhanden ist. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen bereitgestellt und verwaltet werden.

Verwenden Sie az group create, um eine Ressourcengruppe zu erstellen. Weitere Informationen zu diesem CLI-Befehl finden Sie hier. 

az group create --name myrg --location westus

Nachdem die Ressourcengruppe erstellt wurde, müssen Sie eine Microsoft Connected Cache for Enterprise-Ressource erstellen.

2. Erstellen einer Azure-Ressource mit verbundenem Cache

Eine Azure-Ressource mit verbundenem Cache ist eine Azure-Ressource auf oberster Ebene, unter der Cacheknoten erstellt werden können.

Verwenden Sie zum Erstellen einer Azure-Ressource im verbundenen Cache az mcc ent resource create

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

Wichtig

Suchen Sie in der Ausgabe nach operationStatus. operationStatus = Succeeded gibt an, dass unsere Dienste erfolgreich mit dem Erstellen Ihrer verbundenen Cacheressource begonnen haben.


Der nächste Schritt besteht darin, einen Cacheknoten unter dieser Ressource zu erstellen.

3. Erstellen eines Cacheknotens

Verwenden Sie zum Erstellen eines Cacheknotens 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>

Wichtig

Suchen Sie in der Ausgabe nach operationStatus. operationStatus = Succeeded gibt an, dass unsere Dienste erfolgreich mit dem Erstellen eines Cacheknotens begonnen haben.


4. Bestätigen der Cacheknotenerstellung

Bevor Sie mit der Konfiguration Ihres Cacheknotens beginnen können, müssen Sie bestätigen, dass der Cacheknoten erfolgreich erstellt wurde.

Um die Erstellung des Cacheknotens zu bestätigen, verwenden Sie az mcc ent node show


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

Wichtig

Suchen Sie in der Ausgabe nach cacheNodeState. Wenn cacheNodeState = Nicht konfiguriert ist, können Sie mit der Cacheknotenkonfiguration fortfahren. Wenn cacheNodeState = Registrierung in Bearbeitung ist, wird der Cacheknoten noch erstellt. Warten Sie ein oder zwei Minuten, und führen Sie den Befehl erneut aus.


Sobald die erfolgreiche Erstellung des Cacheknotens bestätigt wurde, können Sie mit der Konfiguration des Cacheknotens fortfahren.

5. Konfigurieren des Cacheknotens

Verwenden Sie zum Konfigurieren Ihres Cacheknotens az mcc ent node update

Im folgenden Beispiel wird ein Linux-Cacheknoten mit aktiviertem Proxy konfiguriert:

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>

Hinweis

  • Für einen Cacheknoten, der unter dem Windows-Hostbetriebssystem bereitgestellt werden soll, muss der physische Pfad des Cachelaufwerks /var/mcc lauten.
  • Suchen Sie in der Ausgabe nach operationStatus. operationStatus = Succeeded gibt an, dass unsere Dienste den Cacheknoten erfolgreich aktualisiert haben. Außerdem sehen Sie, dass cacheNodeState nicht bereitgestellt angezeigt wird.
  • Speichern Sie werte für physicalPath, sizeInGb, proxyPort und proxyHostName , da diese Werte zum Erstellen des Bereitstellungsskripts erforderlich sind.

6. Abrufen von Bereitstellungsdetails für den Cacheknoten

Nach der erfolgreichen Konfiguration des Cacheknotens besteht der nächste Schritt darin, den Cacheknoten auf einem Hostcomputer bereitzustellen. Zum Bereitstellen des Cacheknotens müssen Sie ein Bereitstellungsskript mit relevanten Informationen erstellen.

Um die relevanten Informationen für die Bereitstellung des Skripts abzurufen, verwenden Sie 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

Wichtig

  • Speichern Sie die resultierenden Werte für cacheNodeId, customerKey, mccResourceId, registrationKey. Diese GUIDs werden zum Erstellen des Bereitstellungsskripts benötigt.
  • Suchen Sie in der Ausgabe nach cacheNodeState. Wenn cacheNodeState = Nicht bereitgestellt ist, können Sie mit der Cacheknotenbereitstellung fortfahren.
  • Wenn cacheNodeState = Nicht konfiguriert ist, wurde der Cacheknoten nicht konfiguriert. Konfigurieren Sie den Cacheknoten vor der Bereitstellung.

Nächster Schritt

Informationen zum Bereitstellen des Cacheknotens auf einem Windows-Hostcomputer finden Sie unter

Bereitstellen eines Cacheknotens in Windows

Informationen zum Bereitstellen des Cacheknotens auf einem Linux-Hostcomputer finden Sie unter

Bereitstellen eines Cacheknotens für Linux


Beispielskript für die Massenerstellung und Konfiguration mehrerer Cacheknoten:

Im Folgenden finden Sie ein Pseudocodebeispiel für die Erstellung und Konfiguration einer Azure-Ressource mit verbundenem Cache und mehreren Cacheknoten für den verbundenen Cache:

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