Gerenciar nós de cache usando a CLI

Este artigo descreve como criar, configurar e implantar nós de cache do Microsoft Cache Conectado para Empresas usando a CLI do Azure.

Pré-requisitos

1. Instalar a CLI do Azure: Como instalar a CLI do Azure
2. Instalar extensão de cache conectado: instale a extensão de cache conectado por meio do comando abaixo

az extension add --name mcc

Para saber mais sobre como instalar extensões, consulte Instalar a extensão Cache Conectado.

1. Criar um grupo de recursos

A primeira etapa é criar um grupo de recursos, caso ainda não tenha um. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.

Para criar um grupo de recursos, use az group create. Você pode encontrar mais detalhes sobre este comando da CLI aqui.

az group create --name myrg --location westus

Depois que o grupo de recursos for criado, você precisará criar um recurso do Microsoft Cache Conectado para Enterprise do Azure.

2. Criar um recurso de cache conectado do Azure

Um recurso de Cache Conectado do Azure é um recurso de nível superior do Azure no qual os nós de cache podem ser criados.

Para criar um recurso de Cache Conectado do Azure, useaz mcc ent resource create

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

A próxima etapa é criar um nó de cache nesse recurso.

3. Criar um nó de cache

Para criar um nó de cache, 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. Confirmar a criação do nó de cache

Antes de começar a configurar o nó de cache, você precisa confirmar se o nó de cache foi criado com êxito.

Para confirmar a criação do nó de cache, use az mcc ent node show

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

Depois que a criação bem-sucedida do nó de cache for confirmada, você poderá continuar a configurar o nó de cache.

5. Configurar nó de cache

Para configurar seu nó de cache, use az mcc ent node update

O exemplo abaixo configura um nó de cache do Linux com 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>

Lembre-se de que o tamanho mínimo de uma unidade de cache é de 50 GB. Você pode especificar várias unidades de cache para nós de cache hospedados no Linux adicionando entradas adicionais ao --cache-drive parâmetro.

6. Obter detalhes de implantação para o nó de cache

Depois de configurar com êxito o nó de cache, a próxima etapa é implantar o nó de cache em um computador host. Para implantar o nó de cache, você precisa criar um comando de implantação usando os identificadores exclusivos dos nós de cache.

Para obter as informações relevantes para o comando de implantação, use 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

Próximas etapas

Para implantar o nó de cache em um computador host Windows , consulte

Para implantar o nó de cache em um computador host do Linux, consulte

Script de exemplo para criar e configurar vários nós de cache em massa

Abaixo está um exemplo de pseudocódigo de como criar scripts para criação e configuração em massa de um recurso do Azure de Cache Conectado e vários nós de cache de Cache Conectado:

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