Migración del clúster para admitir varias zonas de disponibilidad (versión preliminar)

1. En el portal de Azure, vaya a la página Overview del clúster.

2. En Configuración, seleccione Escalar verticalmente.

3. En la fila del clúster, las zonas de disponibilidad aparecen en la columna Zonas de disponibilidad.

   

Antes de empezar, asegúrese de tener az.Kusto cmdlets instalados y de haber iniciado sesión. A continuación, ejecute el siguiente comando para obtener la lista de zonas de disponibilidad de la región del clúster:

1. Establezca el identificador de recurso del clúster. Puede obtener el identificador de recurso del clúster desde el portal de Azure en la página Propiedades del clúster.

   $resource_id = "<ClusterResourceID>"
   

2. Obtenga los detalles de su clúster.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Obtenga la ubicación del clúster.

   Importante

   Get-AzLocation requiere el módulo Az.Resources. Si no lo tiene instalado, ejecute Install-Module Az.Resources.

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

4. Obtenga el identificador del clúster.

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

5. Obtenga la lista de zonas de disponibilidad para la región del clúster.

   $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 las instrucciones sobre cómo implementar una plantilla.

1. Realice la llamada a la API de REST al siguiente punto de conexión donde reemplazará los parámetros por sus valores:

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

2. Especifique las zonas de disponibilidad en el cuerpo de la solicitud. Por ejemplo, para configurar el clúster para que use las zonas de disponibilidad 1, 2 y 3, establezca el cuerpo de la siguiente manera:

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

1. Si no tiene el Azure. Identity y Azure. ResourceManager.Kusto bibliotecas instaladas, use los siguientes comandos para instalarlas:

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

2. En la aplicación, agregue el siguiente código:

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

   Por ejemplo, para establecer las zonas en 1, 2 y 3, en la región Norte de Europa, use el siguiente 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. Ejecutar la aplicación.

1. En la aplicación, agregue el siguiente código:

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

   Por ejemplo, para establecer las zonas en 1, 2 y 3, en la región Norte de Europa, use el siguiente 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. Ejecutar la aplicación.

Puede usar el siguiente comando de PowerShell para configurar el clúster para usar zonas de disponibilidad. Asegúrese de que las bibliotecas de herramientas de Kusto están instaladas y reemplace los parámetros por los valores.

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

1. En la plantilla de ARM, agregue la siguiente propiedad al recurso Microsoft.Kusto/clusters:

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

   Para establecer las zonas en 1, 2 y 3 en la región Norte de Europa, use la plantilla siguiente:

   {
     "$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. Desplegar la plantilla de ARM. Para obtener más información, consulte Deploy resources with ARM templates and CLI de Azure.