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

В этой статье описывается создание, настройка и развертывание узлов кэша 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 Azure.

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

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

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>

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

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

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

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

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

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>

Помните, что минимальный размер диска кэша составляет 50 ГБ. Вы можете указать несколько дисков кэша для узлов кэша, размещенных в Linux, добавив дополнительные записи в --cache-drive параметр .

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

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

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

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

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

Сведения о развертывании узла кэша на хост-компьютере 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
}