Перенос кластера для поддержки нескольких зон доступности (предварительная версия)

1. На портале Azure перейдите на страницу Overview кластера.

2. В разделе Параметры выберите Увеличить масштаб.

3. В строке, соответствующей вашему кластеру, зоны доступности отображаются в столбце Зоны доступности.

   

Прежде чем начать, убедитесь, что у вас установлены командлеты az.Kusto и вы выполнили вход. Затем выполните следующую команду, чтобы получить список зон доступности для региона кластера:

1. Задайте идентификатор ресурса кластера. Идентификатор ресурса кластера можно получить на портале Azure на странице свойств кластера.

   $resource_id = "<ClusterResourceID>"
   

2. Получение сведений о кластере.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Получите расположение кластера.

   Внимание

   Get-AzLocation требует модуль Az.Resources. Если он не установлен, выполните команду Install-Module Az.Resources.

   $location = (Get-AzLocation | where DisplayName -EQ $mycluster.Location).location
   

4. Получите идентификатор кластера.

   $mycluster.Id  -match "/subscriptions/(.*?)/" | Out-Null; $subscription = $Matches[1]
   

5. Получите список зон доступности для региона кластера.

   $bearer = (Get-AzAccessToken).Token
   $rest_result = (Invoke-RestMethod -Uri https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Kusto/locations/${location}/skus?api-version=2022-11-11 -Headers @{Authorization="Bearer $bearer"})
   $zones = $rest_result | select -ExpandProperty Value | where name -eq $mycluster.SkuName | select -ExpandProperty locationInfo | select zones
   $zones
   

Следуйте инструкциям по развертыванию шаблона.

1. Сделайте вызов REST API к следующей конечной точке, заменив параметры на ваши значения.

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version={apiVersion}
   

2. Укажите зоны доступности в тексте запроса. Например, чтобы настроить кластер для использования зон доступности 1, 2 и 3, задайте текст следующим образом:

   { "zones": [ "{zone1}", "{zone2}", "{zone3}" ] }
   

1. Если у вас не установлены библиотеки Azure.Identity и Azure.ResourceManager.Kusto, используйте следующие команды для их установки:

   dotnet add package Azure.Identity
   dotnet add package Azure.ResourceManager.Kusto
   

2. В приложении добавьте следующий код:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   Например, чтобы задать для зон значение 1, 2 и 3 в регионе Северной Европы, используйте следующий код:

   using Azure.Core;
   using Azure.ResourceManager.Kusto;
   using Azure.ResourceManager.Kusto.Models;
   using ArmClient = Azure.ResourceManager.ArmClient;
   using ClientSecretCredential = Azure.Identity.ClientSecretCredential;
   using WaitUntil = Azure.WaitUntil;
   
   var tenantId = "{tenantId}";
   var clientId = "{clientId}";
   var clientSecret = "{clientSecret}";
   var subscriptionId = "{subscriptionId}";
   var resourceGroupName = "{resourceGroupName}";
   var clusterName = "{clusterName}";
   
   var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
   var resourceManagementClient = new ArmClient(credentials, subscriptionId);
   var resourceIdentifier = new ResourceIdentifier($"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/Clusters/{clusterName}");
   var cluster = resourceManagementClient.GetKustoClusterResource(resourceIdentifier);
   
   var kustoClusterPatch = new KustoClusterPatch(AzureLocation.NorthEurope);
   kustoClusterPatch.Zones.Clear();
   kustoClusterPatch.Zones.Add("1");
   kustoClusterPatch.Zones.Add("2");
   kustoClusterPatch.Zones.Add("3");
   
   var armOperation = await cluster.UpdateAsync(WaitUntil.Started, kustoClusterPatch).ConfigureAwait(false);
   
   var response = armOperation.UpdateStatus();
   Console.WriteLine($"ClientRequestId: {response.ClientRequestId}");
   
   while (true)
   {
     Console.WriteLine($"{DateTime.UtcNow:o} {response.Status, -5} {response.ReasonPhrase}");
     if (armOperation.HasCompleted)
       break;
   
     await Task.Delay(60000).ConfigureAwait(false);
     response = await armOperation.UpdateStatusAsync().ConfigureAwait(false);
   }
   

3. Запустите приложение.

1. В приложении добавьте следующий код:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   Например, чтобы задать для зон значение 1, 2 и 3 в регионе Северной Европы, используйте следующий код:

   from azure.identity import DefaultAzureCredential
   from azure.mgmt.kusto import KustoManagementClient
   from azure.mgmt.kusto import models
   import time
   from azure.core.exceptions import HttpResponseError 
   
   subscription_id = "{subscriptionId}"
   resource_group_name = "{resourceGroupName}"
   cluster_name = "{clusterName}"
   
   client = KustoManagementClient(DefaultAzureCredential(), subscription_id)
   lro_poller = client.clusters.begin_update(resource_group_name, cluster_name, models.ClusterUpdate.from_dict({"zones": ["1", "2", "3"]}))
   
   while (not(lro_poller.done())):
       time.sleep(60)
   
   print (f"status: {lro_poller.status()}")
   
   try:
       lro_poller.result()
   except HttpResponseError as e:
       print (f"Exception: {e}")
   

2. Запустите приложение.

Следующая команда PowerShell позволяет настроить кластер для использования зон доступности. Убедитесь, что библиотеки инструментов Kusto установлены, и замените параметры вашими значениями.

Update-AzKustoCluster -SubscriptionId {subscriptionId} -ResourceGroupName {resourceGroupName} -Name {clusterName} -Zone "{zone1}", "{zone2}", "{zone3}"

1. В шаблоне ARM добавьте следующее свойство в ресурс Microsoft.Kusto/clusters:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   Чтобы задать зоны 1, 2 и 3 в регионе Северной Европы, используйте следующий шаблон:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
         "clusters_clusterName_name": {
             "defaultValue": "clusterName",
             "type": "string"
         }
     },
     "variables": {},
     "resources": [
         {
             "type": "Microsoft.Kusto/clusters",
             "apiVersion": "2023-05-02",
             "name": "[parameters('clusters_clusterName_name')]",
             "location": "North Europe",
             "sku": {
                 "name": "{skuName}",
                 "tier": "Basic",
                 "capacity": 1
             },
             "zones": ["1","2","3"],
             "identity": {
                 "type": "SystemAssigned"
             },
             "properties": {
                 "trustedExternalTenants": [],
                 "enableDiskEncryption": false,
                 "enableStreamingIngest": false,
                 "languageExtensions": {
                     "value": []
                 },
                 "enablePurge": false,
                 "enableDoubleEncryption": false,
                 "engineType": "V3",
                 "acceptedAudiences": [],
                 "restrictOutboundNetworkAccess": "Disabled",
                 "allowedFqdnList": [],
                 "publicNetworkAccess": "Enabled",
                 "allowedIpRangeList": [],
                 "enableAutoStop": true,
                 "publicIPType": "IPv4"
             }
         }
     ]
   }
   

2. Разверните шаблон ARM. Дополнительные сведения см. в разделе Развертывание ресурсов с использованием шаблонов ARM и Azure CLI.