Migrar seu cluster para dar suporte a várias zonas de disponibilidade (versão prévia)

1. No portal do Azure, acesse a página Overview do cluster.

2. Em Configurações, selecione Escalar verticalmente.

3. Na linha de seu cluster, as zonas de disponibilidade estão listadas na coluna Zonas de disponibilidade.

   

Antes de começar, verifique se você tem os cmdlets az.Kusto instalados e conectadose, em seguida, execute o seguinte comando para obter a lista de zonas de disponibilidade para a região do seu cluster:

1. Defina a ID do recurso de seu cluster. Você pode obter a ID de recurso do cluster no portal do Azure na página Properties do cluster.

   $resource_id = "<ClusterResourceID>"
   

2. Obtenha as informações do seu cluster.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Obtenha a localização do cluster.

   Importante

   Get-AzLocation requer o módulo Az.Resources. Se você não o tiver instalado, execute Install-Module Az.Resources.

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

4. Obtenha a ID do seu cluster.

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

5. Obter a lista de zonas de disponibilidade para a região do seu cluster.

   $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
   

Siga as instruções sobre como implantar um módulo.

1. Faça a chamada à API REST para o seguinte ponto de extremidade, no qual você substituirá os parâmetros pelos seus valores:

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

2. Especifique suas zonas de disponibilidade no corpo da solicitação. Por exemplo, para configurar o cluster para usar as zonas de disponibilidade 1, 2 e 3, defina o corpo da seguinte forma:

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

1. Se você não tiver o Azure.Identity e Azure.ResourceManager.Kusto instalados, use os seguintes comandos para instalá-los:

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

2. Em seu aplicativo, adicione o seguinte código:

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

   Por exemplo, para definir suas zonas como 1, 2 e 3, na região Norte da Europa, use o seguinte código:

   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. Executar seu aplicativo.

1. Em seu aplicativo, adicione o seguinte código:

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

   Por exemplo, para definir suas zonas como 1, 2 e 3, na região Norte da Europa, use o seguinte código:

   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. Executar seu aplicativo.

Você pode usar o seguinte comando do PowerShell para configurar seu cluster para usar zonas de disponibilidade. Certifique-se de que as bibliotecas de ferramentas do Kusto estejam instaladas e substitua os parâmetros por seus valores.

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

1. No modelo do ARM, adicione a seguinte propriedade ao recurso Microsoft.Kusto/clusters:

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

   Por exemplo, para definir suas zonas como 1, 2 e 3, na região Norte da Europa, use o seguinte modelo:

   {
     "$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. Implantar o modelo do ARM. Para obter mais informações, consulte Implantar recursos com Modelos ARM e CLI do Azure.