여러 가용성 영역을 지원하도록 클러스터 마이그레이션(미리 보기)

1. Azure Portal에서 클러스터의 개요 페이지로 이동합니다.

2. 설정에서 강화를 선택합니다.

3. 클러스터의 행에서 가용성 영역은 가용성 영역 열에 나열됩니다.

   

시작하기 전에 az.Kusto cmdlet이 설치되었고 로그인되어 있는지 확인하고, 다음 명령을 실행하여 클러스터 지역에 대한 가용성 영역 목록을 가져옵니다.

1. 클러스터의 리소스 ID를 설정합니다. 클러스터의 속성 페이지에서 Azure Portal에서 클러스터의 리소스 ID를 가져올 수 있습니다.

   $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. 클러스터의 ID를 가져옵니다.

   $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를 사용하여 리소스 배포를 참조하세요.