Creación y administración de ubicaciones personalizadas en Kubernetes habilitado para Azure Arc

Como extensión de ubicación de Azure, Ubicaciones personalizadas proporciona un modo para que los administradores de inquilinos usen sus clústeres de Kubernetes habilitado para Azure Arc como ubicaciones de destino para implementar instancias de servicios de Azure. Entre los ejemplos de recursos de Azure se incluyen SQL Managed Instance habilitado para Azure Arc e Hiperescala de PostgreSQL habilitada para Azure Arc.

De forma similar a las ubicaciones de Azure, los usuarios finales dentro del inquilino con acceso a Ubicaciones personalizadas pueden implementar recursos allí mediante el proceso privado de su empresa.

En este artículo aprenderá a:

  • Habilitar ubicaciones personalizadas en el clúster de Kubernetes habilitado para Azure Arc.
  • Implemente la extensión de clúster de servicio de Azure de la instancia de servicio de Azure en el clúster.
  • Cree una ubicación personalizada en el clúster de Kubernetes habilitado para Azure Arc.

Puede encontrar una información general conceptual sobre esta característica en el artículo sobre ubicaciones de clúster: Kubernetes habilitado para Azure Arc.

Importante

Las características en versión preliminar de Kubernetes habilitadas para Azure Arc están disponibles en autoservicio y de manera opcional. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y la garantía limitada. Las versiones preliminares de Kubernetes habilitadas para Azure Arc reciben cobertura parcial del soporte al cliente en la medida de lo posible.

Requisitos previos

  • Instale o actualice la CLI de Azure a la versión 2.16.0 o posteriores.

  • Instale las extensiones de la CLI de Azure siguientes:

    • connectedk8s (versión 1.1.0 o posterior)
    • k8s-extension (versión 0.2.0 o posterior)
    • customlocation (versión 0.1.0 o posterior)
    az extension add --name connectedk8s
    az extension add --name k8s-extension
    az extension add --name customlocation
    

    Si ya instaló previamente las extensiones connectedk8s, k8s-extension y customlocation, actualícelas a la versión más reciente con el siguiente comando:

    az extension update --name connectedk8s
    az extension update --name k8s-extension
    az extension update --name customlocation
    
  • Compruebe que se completó el registro de proveedor de Microsoft.ExtendedLocation.

    1. Escriba los siguientes comandos:
    az provider register --namespace Microsoft.ExtendedLocation
    
    1. Supervise el proceso de registro. El registro puede tardar un máximo de 10 minutos.
    az provider show -n Microsoft.ExtendedLocation -o table
    
  • Compruebe que tiene un clúster conectado a Kubernetes habilitado para Azure Arc existente.

Nota

Regiones admitidas para ubicaciones personalizadas:

  • Este de EE. UU.
  • Oeste de Europa

Habilitación de ubicaciones personalizadas en el clúster

Si ha iniciado sesión en la CLI de Azure como un usuario de Azure AD, para habilitar esta característica en el clúster, ejecute el siguiente comando:

az connectedk8s enable-features -n <clusterName> -g <resourceGroupName> --features cluster-connect custom-locations

Si ha iniciado sesión en la CLI de Azure con una entidad de servicio, para habilitar esta característica en el clúster, siga estos pasos:

  1. Capture el identificador de objeto de la aplicación de Azure AD que utiliza el servicio Azure Arc:

    az ad sp show --id 'bc313c14-388c-4e7d-a58e-70017303ee3b' --query objectId -o tsv
    
  2. Use el valor <objectId> del paso anterior para habilitar la característica de ubicaciones personalizadas en el clúster:

    az connectedk8s enable-features -n <cluster-name> -g <resource-group-name> --custom-locations-oid <objectId> --features cluster-connect custom-locations
    

Nota

  1. La característica Ubicaciones personalizadas depende de la característica Conexión de clúster. Por lo tanto, es necesario habilitar ambas características para que funcionen las ubicaciones personalizadas.
  2. az connectedk8s enable-features debe ejecutarse en una máquina en el que el archivo kubeconfig apunte al clúster en el que se van a habilitar las características.

Creación de una ubicación personalizada

  1. Implemente la extensión de clúster de servicio de Azure de la instancia de servicio de Azure que finalmente quiera en el clúster:

  2. Obtenga el identificador de Azure Resource Manager del clúster de Kubernetes habilitado para Azure Arc, al que se hace referencia en pasos posteriores como connectedClusterId:

    az connectedk8s show -n <clusterName> -g <resourceGroupName>  --query id -o tsv
    
  3. Obtenga el identificador de Azure Resource Manager de la extensión de clúster implementada a partir del clúster de Kubernetes habilitado para Azure Arc, al que se hace referencia en pasos posteriores como extensionId:

    az k8s-extension show --name <extensionInstanceName> --cluster-type connectedClusters -c <clusterName> -g <resourceGroupName>  --query id -o tsv
    
  4. Cree una ubicación personalizada haciendo referencia al clúster de Kubernetes habilitado para Azure Arc y la extensión:

    az customlocation create -n <customLocationName> -g <resourceGroupName> --namespace arc --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionId>
    

Pasos siguientes