Compartir a través de

Inicio rápido: Creación de un grupo de clústeres de HDInsight en AKS mediante la CLI de Azure

  • Artículo

Importante

Azure HDInsight en AKS se retiró el 31 de enero de 2025. Obtenga más información con este anuncio.

Debe migrar las cargas de trabajo a microsoft Fabric o un producto equivalente de Azure para evitar la terminación repentina de las cargas de trabajo.

Importante

Esta característica está actualmente en versión preliminar. Los Términos de uso complementarios para las versiones preliminares de Microsoft Azure incluyen más términos legales que se aplican a las características de Azure que se encuentran en versión beta, en versión preliminar o, de lo contrario, aún no se han publicado en disponibilidad general. Para obtener información sobre esta versión preliminar específica, consulte información de la versión preliminar de Azure HDInsight en AKS. Para preguntas o sugerencias de características, envíe una solicitud en AskHDInsight con los detalles y síganos para obtener más actualizaciones sobre Comunidad de Azure HDInsight.

HDInsight en AKS presenta el concepto de clústeres y grupos de clústeres, lo que le permite obtener el valor completo de data lakehouse.

  • grupos de clústeres son una agrupación lógica de clústeres y mantienen un conjunto de clústeres en el mismo grupo, lo que ayuda a crear una sólida interoperabilidad entre varios tipos de clúster. Se puede crear dentro de una red virtual existente o fuera de una red virtual.

    Un grupo de clústeres de HDInsight en AKS corresponde a un clúster de la infraestructura de AKS.

  • Clústeres son cargas de trabajo de proceso individuales, como Apache Spark, Apache Flink o Trino, que se pueden crear en el mismo grupo de clústeres.

Para cada tipo de clúster, es necesario tener un grupo de clúster. Se puede crear de forma independiente o crear un nuevo grupo de clústeres durante su creación. En este inicio rápido, aprenderá a crear un grupo de clústeres mediante la CLI de Azure.

Prerrequisitos

Asegúrese de que haya completado los requisitos previos de la suscripción antes de crear un grupo de clústeres.

Inicio de Azure Cloud Shell

Azure Cloud Shell es un shell interactivo que puede usar para ejecutar los pasos de este artículo. Tiene herramientas comunes de Azure preinstaladas y configuradas para usarlas con su cuenta.

    • Usa el entorno de Bash en Azure Cloud Shell. Para más información, consulte inicio rápido de para Bash en Azure Cloud Shell.

    • Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si se ejecuta en Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor de Docker. Para más información, consulte Ejecución de la CLI de Azure en un contenedor de Docker.

      • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Para finalizar el proceso de autenticación, siga los pasos que se muestran en el terminal. Para ver otras opciones de inicio de sesión, consulte inicio de sesión con la CLI de Azure.

      • Cuando se le solicite, instale la extensión de la CLI de Azure en el primer uso. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

      • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

  • En este artículo se requiere la versión 2.56.0 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, la versión más reciente ya está instalada allí.

  • Si tiene varias suscripciones de Azure, seleccione el identificador de suscripción adecuado en el que se deben facturar los recursos mediante el comando az account set. Para más información, consulte Cómo administrar suscripciones de Azure – CLI de Azure.

  • También puede abrir Cloud Shell en una pestaña independiente del explorador; para ello, vaya a https://shell.azure.com/bash.

Definición de variables de entorno

El primer paso es definir las variables de entorno. Las variables de entorno se usan normalmente en Linux para centralizar los datos de configuración para mejorar la coherencia y el mantenimiento del sistema. Cree las siguientes variables de entorno para especificar los nombres de los recursos que cree más adelante en este tutorial:

export ResourceGroup="HDIonAKSCLI"
export Region=EastUS
export HDIonAKSClusterPoolName="contosopool"
export NodeType="Standard_E4s_v3"
export ClusterVersion="1.1"

Inicio de sesión en Azure mediante la CLI

Para ejecutar comandos en Azure mediante la CLI, primero debe iniciar sesión. Inicie sesión con el comando az login.

Creación de un grupo de recursos

Un grupo de recursos es un contenedor para los recursos relacionados. Todos los recursos deben colocarse en un grupo de recursos. El comando az group create crea un grupo de recursos con los parámetros $ResourceGroup y $Region definidos anteriormente.

az group create --name $ResourceGroup --location $Region

Salida:

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/HDIonAKSCLI",
  "location": "eastus",
  "managedBy": null,
  "name": "HDIonAKSCLI",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Crea el grupo de clústeres de HDInsight en AKS

Para crear un grupo de clústeres de HDInsight en AKS en este grupo de recursos, use el comando az hdinsight-on-aks clusterpool create:

az hdinsight-on-aks clusterpool create --cluster-pool-name
                                       --resource-group
                                       [--api-server-authorized-ip-ranges]
                                       [--cluster-pool-version]
                                       [--enable-log-analytics {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--la-workspace-id]
                                       [--location]
                                       [--managed-rg-name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--outbound-type {loadBalancer, userDefinedRouting}]
                                       [--private-server-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--subnet-id]
                                       [--tags]
                                       [--workernode-size]

Este es un ejemplo:

az hdinsight-on-aks clusterpool create --resource-group $ResourceGroup --cluster-pool-name $HDIonAKSClusterPoolName --location $Region --workernode-size $NodeType --cluster-pool-version $ClusterVersion

Se tarda unos minutos en crear el grupo de clústeres de HDInsight en AKS. En la salida de ejemplo siguiente se muestra que la operación creada se realizó correctamente.

Salida:

{
  "aksClusterProfile": {
    "aksClusterAgentPoolIdentityProfile": {
      "msiClientId": "00000000-0000-0000-0000-XXXXXXXX1",
      "msiObjectId": "00000000-0000-0000-0000-XXXXXXX11",
      "msiResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/MC_hdi-00000000000000000000XXXX_contosopool_eastus/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contosopool-agentpool"
    },
    "aksClusterResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/hdi-00000000000000000000XXXX/providers/Microsoft.ContainerService/managedClusters/contosopool",
    "aksVersion": "1.27.9"
  },
  "aksManagedResourceGroupName": "MC_hdi-00000000000000000000XXXX_contosopool_eastus",
  "clusterPoolProfile": {
    "clusterPoolVersion": "1.1"
  },
  "computeProfile": {
    "count": 3,
    "vmSize": "Standard_E4s_v3"
  },
  "deploymentId": "00000000000000000000XXXX",
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/HDIonAKSCLI/providers/Microsoft.HDInsight/clusterpools/contosopool",
  "location": "EastUS",
  "managedResourceGroupName": "hdi-00000000000000000000XXXX",
  "name": "contosopool",
  "provisioningState": "Succeeded",
  "resourceGroup": "HDIonAKSCLI",
  "status": "Running",
  "systemData": {
    "createdAt": "2024-05-31T15:02:42.2172295Z",
    "createdBy": "john@contoso.com",
    "createdByType": "User",
    "lastModifiedAt": "2024-05-31T15:02:42.2172295Z",
    "lastModifiedBy": "john@contoso.com",
    "lastModifiedByType": "User"
  },
  "type": "microsoft.hdinsight/clusterpools"
}

Nota

Para obtener más información sobre los comandos de la CLI del conjunto de clústeres, consulte los comandos en .

Limpieza de recursos

Cuando ya no sea necesario, limpie los recursos innecesarios para evitar cargos de Azure. Puede quitar el grupo de recursos, el grupo de clústeres y todos los demás recursos del grupo de recursos mediante el comando az group delete.

Nota

Para eliminar un grupo de clústeres, asegúrese de que no haya clústeres activos en el grupo de clústeres.