Compartilhar via

Gerir nós de cache com a CLI


Este artigo descreve como criar, configurar e implementar nós da Cache Ligada da Microsoft para Empresas com a CLI do Azure.

Pré-requisitos:

  1. Instalar a CLI do Azure: Como instalar a CLI do Azure
  2. Instalar a extensão da Cache Ligada: instale a extensão da Cache Ligada através do comando abaixo
az extension add --name mcc

Para saber mais sobre como instalar extensões, veja Instalar a extensão cache ligada.



1. Criar um Grupo de recursos

O primeiro passo é criar um grupo de recursos se ainda não tiver um. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos.

Para criar um grupo de recursos, utilize az group create. Pode encontrar mais detalhes sobre este comando da CLI aqui. 

az group create --name myrg --location westus

Assim que o grupo de recursos for criado, terá de criar uma Cache Ligada da Microsoft para o recurso Enterprise.

2. Criar um recurso do Azure de Cache Ligada

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

Para criar um recurso do Azure de Cache Ligada, utilize az mcc ent resource create

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

Importante

No resultado, procure operationStatus. operationStatus = Succeeded indica que os nossos serviços começaram a criar com êxito o recurso da Cache Ligada.


O próximo passo é criar um nó de cache neste recurso.

3. Criar um nó de cache

Para criar um nó de cache, utilize 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

No resultado, procure operationStatus. operationStatus = Succeeded indica que os nossos serviços começaram a criar o nó de cache com êxito.


4. Confirmar a criação do nó de cache

Antes de poder começar a configurar o nó de cache, tem de confirmar que o nó de cache foi criado com êxito.

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


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

Importante

No resultado, procure cacheNodeState. Se cacheNodeState = Não Configurado, pode continuar com a configuração do nó de cache. Se cacheNodeState = Registo em Curso, o nó de cache ainda está em processo de criação. Aguarde um minuto ou mais e execute o comando novamente.


Assim que a criação com êxito do nó de cache for confirmada, pode continuar a configurar o nó de cache.

5. Configurar o nó de cache

Para configurar o nó de cache, utilize az mcc ent node update

O exemplo abaixo configura um nó de cache do Linux com o proxy ativado:

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>

Observação

  • Para um nó de cache que esteja a ser implementado no SO anfitrião do Windows, o caminho físico da unidade de cache tem de ser /var/mcc.
  • No resultado, procure operationStatus. operationStatus = Succeeded indica que os nossos serviços atualizaram com êxito o nó de cache. Também verá que cacheNodeState mostrará Não Aprovisionado.
  • Guarde valores para physicalPath, sizeInGb, proxyPort, proxyHostName , uma vez que estes valores serão necessários para construir o script de aprovisionamento.

6. Obter detalhes de aprovisionamento para o nó de cache

Depois de configurar com êxito o nó de cache, o próximo passo é implementar o nó de cache num computador anfitrião. Para implementar o nó de cache, terá de criar um script de aprovisionamento com informações relevantes.

Para obter as informações relevantes para o script de aprovisionamento, utilize 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

  • Guarde os valores resultantes para cacheNodeId, customerKey, mccResourceId, registrationKey. Estes GUIDs são necessários para criar o script de aprovisionamento.
  • No resultado, procure cacheNodeState. Se cacheNodeState = Não Aprovisionado, pode continuar com o aprovisionamento do nó de cache.
  • Se cacheNodeState = Não Configurado, o nó de cache não foi configurado. Configure o nó de cache antes do aprovisionamento.

Próximas etapas

Para implementar o nó de cache num computador anfitrião Windows , consulte

Implementar o nó de cache no Windows

Para implementar o nó de cache num computador anfitrião Linux , veja

Implementar o nó de cache no Linux


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

Segue-se um exemplo pseudocódigo de como criar scripts em massa e configurar um recurso do Azure de Cache Ligada e vários nós de cache da Cache Ligada:

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