Migrace clusteru pro podporu více zón dostupnosti (Preview)

1. Na webu Azure Portal přejděte na stránku Přehled vašeho clusteru.

2. V části Nastavení vyberte Vertikálně navýšit kapacitu.

3. Na řádku clusteru jsou zóny dostupnosti uvedené ve sloupci Zóny dostupnosti.

   

Než začnete, ujistěte se, že máte az. Rutiny Kusto nainstalované a přihlášené a pak spuštěním následujícího příkazu získejte seznam zón dostupnosti pro oblast clusteru:

1. Nastavte ID prostředku vašeho clusteru. ID prostředku clusteru můžete získat z webu Azure Portal ze stránky Vlastnosti vašeho clusteru.

   $resource_id = "<ClusterResourceID>"
   

2. Získejte podrobnosti o clusteru.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Získejte umístění clusteru.

   Důležité

   Get-AzLocationAz.Resources vyžaduje modul. Pokud ho nemáte nainstalovaný, spusťte Install-Module Az.Resourcespříkaz .

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

4. Získejte ID clusteru.

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

5. Získejte seznam zón dostupnosti pro oblast clusteru.

   $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
   

Postupujte podle pokynů k nasazení šablony.

1. Proveďte volání rozhraní REST API na následující koncový bod, kde nahradíte parametry hodnotami:

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

2. Zadejte zóny dostupnosti v textu požadavku. Pokud chcete například nakonfigurovat cluster tak, aby používal zóny dostupnosti 1, 2 a 3, nastavte text takto:

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

1. Pokud nemáte nainstalované knihovny Azure.Identity a Azure.ResourceManager.Kusto , nainstalujte je pomocí následujících příkazů:

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

2. Do aplikace přidejte následující kód:

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

   Pokud chcete například nastavit zóny na 1, 2 a 3, použijte v oblasti Severní Evropa následující kód:

   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. Spusťte aplikaci.

1. Do aplikace přidejte následující kód:

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

   Pokud chcete například nastavit zóny na 1, 2 a 3, použijte v oblasti Severní Evropa následující kód:

   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. Spusťte aplikaci.

Pomocí následujícího příkazu PowerShellu můžete cluster nakonfigurovat tak, aby používal zóny dostupnosti. Ujistěte se, že jsou nainstalované knihovny nástrojů Kusto, a nahraďte parametry hodnotami.

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

1. Do šablony ARM přidejte do Microsoft.Kusto/clusters prostředku následující vlastnost:

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

   Pokud například chcete v oblasti Severní Evropa nastavit zóny na 1, 2 a 3, použijte následující šablonu:

   {
     "$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. Nasazení šablony ARM Další informace najdete v tématu Nasazení prostředků pomocí šablon ARM a Azure CLI.