Administración de nodos de caché mediante la CLI

En este artículo se describe cómo crear, configurar e implementar nodos de caché de Microsoft Connected Cache for Enterprise mediante la CLI de Azure.

Requisitos previos:

1. Instalación de la CLI de Azure: Instalación de la CLI de Azure
2. Instalar la extensión de caché conectada: Instale la extensión de caché conectada mediante el siguiente comando.

az extension add --name mcc

Para más información sobre la instalación de extensiones, consulte Instalación de la extensión de caché conectada.

1. Creación de un grupo de recursos

El primer paso es crear un grupo de recursos si aún no tiene uno. Un grupo de recursos de Azure es un contenedor lógico en el que se implementan y administran los recursos de Azure.

Para crear un grupo de recursos, use az group create. Puede encontrar más detalles sobre este comando de la CLI aquí.

az group create --name myrg --location westus

Una vez creado el grupo de recursos, deberá crear un recurso de Microsoft Connected Cache for Enterprise.

2. Creación de un recurso de Azure de caché conectada

Un recurso de Azure de caché conectada es un recurso de Azure de nivel superior en el que se pueden crear nodos de caché.

Para crear un recurso de Azure de caché conectada, use az mcc ent resource create

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

El siguiente paso es crear un nodo de caché en este recurso.

3. Creación de un nodo de caché

Para crear un nodo de caché, use 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. Confirmación de la creación de nodos de caché

Antes de empezar a configurar el nodo de caché, debe confirmar que el nodo de caché se creó correctamente.

Para confirmar la creación de nodos de caché, use az mcc ent node show

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

Una vez confirmada la creación correcta del nodo de caché, puede continuar con la configuración del nodo de caché.

5. Configuración del nodo de caché

Para configurar el nodo de caché, use az mcc ent node update

En el ejemplo siguiente se configura un nodo de caché de Linux con el proxy habilitado:

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>

6. Obtener detalles de aprovisionamiento para el nodo de caché

Después de configurar correctamente el nodo de caché, el siguiente paso es implementar el nodo de caché en una máquina host. Para implementar el nodo de caché, deberá crear un script de aprovisionamiento con información relevante.

Para obtener la información pertinente para el script de aprovisionamiento, use 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

Paso siguiente

Para implementar el nodo de caché en una máquina host de Windows , consulte

Para implementar el nodo de caché en una máquina host Linux , consulte

Script de ejemplo para crear y configurar varios nodos de caché de forma masiva:

A continuación se muestra un ejemplo de pseudocódigo de cómo crear y configurar de forma masiva un recurso de Azure de caché conectada y varios nodos de caché de caché conectada:

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