Поделиться через

Управление узлами кэша с помощью интерфейса командной строки


В этой статье описывается создание, настройка и развертывание узлов кэша Microsoft Connected Cache for Enterprise с помощью Azure CLI.

Необходимые условия

  1. Установка Azure CLI: установка Azure CLI
  2. Установка расширения подключенного кэша: установка расширения подключенного кэша с помощью приведенной ниже команды
az extension add --name mcc

Дополнительные сведения об установке расширений см. в статье Установка расширения подключенного кэша.



1. Создание группы ресурсов

Первым шагом является создание группы ресурсов, если у вас ее еще нет. Группа ресурсов Azure — это логический контейнер, в котором развертываются и управляются ресурсы Azure.

Чтобы создать группу ресурсов, используйте .az group create Дополнительные сведения об этой команде CLI можно найти здесь. 

az group create --name myrg --location westus

После создания группы ресурсов необходимо создать ресурс Microsoft Connected Cache for Enterprise.

2. Создание ресурса Azure Connected Cache

Ресурс Azure Connected Cache — это ресурс Azure верхнего уровня, в котором можно создавать узлы кэша.

Чтобы создать ресурс Azure Connected Cache, используйте az mcc ent resource create

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

Важно.

В выходных данных найдите operationStatus. operationStatus = Succeeded указывает, что наши службы успешно приступили к созданию ресурса подключенного кэша.


Следующим шагом является создание узла кэша в этом ресурсе.

3. Создание узла кэша

Чтобы создать узел кэша, используйте 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>

Важно.

В выходных данных найдите operationStatus. operationStatus = Succeeded указывает, что наши службы успешно приступили к созданию узла кэша.


4. Подтверждение создания узла кэша

Прежде чем приступить к настройке узла кэша, необходимо убедиться, что узел кэша успешно создан.

Чтобы подтвердить создание узла кэша, используйте az mcc ent node show


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

Важно.

В выходных данных найдите cacheNodeState. Если cacheNodeState = Не настроено, можно продолжить настройку узла кэша. Если cacheNodeState = Регистрация выполняется, узел кэша по-прежнему создается. Подождите еще минуту или две и выполните команду еще раз.


После подтверждения успешного создания узла кэша можно перейти к настройке узла кэша.

5. Настройка узла кэша

Чтобы настроить узел кэша, используйте az mcc ent node update

В следующем примере настраивается узел кэша Linux с включенным прокси-сервером:

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>

Примечание.

  • Для развертывания узла кэша в ОС узла Windows физический путь к диску кэша должен быть /var/mcc.
  • В выходных данных найдите operationStatus. operationStatus = Succeeded указывает, что наши службы успешно обновили узел кэша. Вы также увидите, что cacheNodeState отобразит значение Не подготовлено.
  • Сохраните значения для physicalPath, sizeInGb, proxyPort, proxyHostName, так как эти значения потребуются для создания скрипта подготовки.

6. Получение сведений о подготовке узла кэша

После успешной настройки узла кэша следующим шагом является развертывание узла кэша на хост-компьютере. Чтобы развернуть узел кэша, необходимо создать скрипт подготовки с соответствующими сведениями.

Чтобы получить необходимые сведения для скрипта подготовки, используйте 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

Важно.

  • Сохраните полученные значения для cacheNodeId, customerKey, mccResourceId, registrationKey. Эти идентификаторы GUID необходимы для создания скрипта подготовки.
  • В выходных данных найдите cacheNodeState. Если cacheNodeState = Не подготовлено, можно продолжить подготовку узла кэша.
  • Если cacheNodeState = Не настроено, узел кэша не настроен. Настройте узел кэша перед подготовкой.

Дальнейшие действия

Сведения о развертывании узла кэша на хост-компьютере Windows см. в разделе

Развертывание узла кэша в Windows

Сведения о развертывании узла кэша на хост-компьютере Linux см. в разделе

Развертывание узла кэша в Linux


Пример скрипта для массового создания и настройки нескольких узлов кэша:

Ниже приведен пример псевдокода, как создать скрипт для массового создания и настройки ресурса Azure Connected 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
}