Creación del controlador de datos de Azure Arc en modo de conexión directa mediante la CLI

En este artículo se describe cómo crear el controlador de datos de Azure Arc en modo de conectividad directa mediante la CLI, durante la versión preliminar actual de esta característica.

Realización de los requisitos previos

Antes de empezar, compruebe que ha completado los requisitos previos que se describen en Implementación del controlador de datos: modo de conexión directa (requisitos previos).

La creación del controlador de datos de Azure Arc en modo de conectividad directa involucra los pasos siguientes:

  1. Crear una extensión de servicios de datos habilitados para Azure Arc.
  2. Crear una ubicación personalizada.
  3. Cree el controlador de datos.

Nota

Actualmente, este paso solo se puede realizar desde el portal. Para obtener información detallada, consulte las notas de la versión.

Creación de una extensión de servicios de datos habilitados para Azure Arc

Use la extensión k8s de la CLI para crear una extensión de servicios de datos.

Establecimiento de variables de entorno

Establezca las siguientes variables de entorno que se usarán en el paso siguiente.

Linux

# where you want the connected cluster resource to be created in Azure 
export subscription=<Your subscription ID>
export resourceGroup=<Your resource group>
export resourceName=<name of your connected kubernetes cluster>
export location=<Azure location>

Windows PowerShell

# where you want the connected cluster resource to be created in Azure 
$ENV:subscription="<Your subscription ID>"
$ENV:resourceGroup="<Your resource group>"
$ENV:resourceName="<name of your connected kubernetes cluster>"
$ENV:location="<Azure location>"

Creación de la extensión de servicios de datos de Arc

Linux

az k8s-extension create -c ${resourceName} -g ${resourceGroup} --name ${ADSExtensionName} --cluster-type connectedClusters --extension-type microsoft.arcdataservices --auto-upgrade false --scope cluster --release-namespace arc --config Microsoft.CustomLocation.ServiceAccount=sa-bootstrapper

az k8s-extension show -g ${resourceGroup} -c ${resourceName} --name ${ADSExtensionName} --cluster-type connectedclusters

Windows PowerShell

$ENV:ADSExtensionName="ads-extension"

az k8s-extension create -c "$ENV:resourceName" -g "$ENV:resourceGroup" --name "$ENV:ADSExtensionName" --cluster-type connectedClusters --extension-type microsoft.arcdataservices --auto-upgrade false --scope cluster --release-namespace arc --config Microsoft.CustomLocation.ServiceAccount=sa-bootstrapper

az k8s-extension show -g "$ENV:resourceGroup" -c "$ENV:resourceName" --name "$ENV:ADSExtensionName" --cluster-type connectedclusters

Implementación de la extensión de servicios de datos de Azure Arc mediante credenciales y registro de contenedor privado

Use el comando siguiente si va a realizar la implementación desde el repositorio privado:

az k8s-extension create -c "<connected cluster name>" -g "<resource group>" --name "<extension name>" --cluster-type connectedClusters --extension-type microsoft.arcdataservices --scope cluster --release-namespace "<namespace>" --config Microsoft.CustomLocation.ServiceAccount=sa-bootstrapper --config imageCredentials.registry=<registry info> --config imageCredentials.username=<username> --config systemDefaultValues.image=<registry/repo/arc-bootstrapper:<imagetag>> --config-protected imageCredentials.password=$ENV:DOCKER_PASSWORD --debug

Por ejemplo

az k8s-extension create -c "my-connected-cluster" -g "my-resource-group" --name "arc-data-services" --cluster-type connectedClusters --extension-type microsoft.arcdataservices --scope cluster --release-namespace "arc" --config Microsoft.CustomLocation.ServiceAccount=sa-bootstrapper --config imageCredentials.registry=mcr.microsoft.com --config imageCredentials.username=arcuser --config systemDefaultValues.image=mcr.microsoft.com/arcdata/arc-bootstrapper:latest --config-protected imageCredentials.password=$ENV:DOCKER_PASSWORD --debug

Nota

La instalación de la extensión de servicios de datos de Arc puede tardar un par de minutos en finalizar.

Comprobación de la creación de la extensión de servicios de datos de Arc

Puede comprobar si se ha creado la extensión de servicios de datos habilitados para Arc desde el portal o mediante la conexión directa al clúster de Kubernetes habilitado para Arc.

Portal de Azure

  1. Inicie sesión en Azure Portal y vaya al grupo de recursos donde se encuentra el recurso del clúster conectado de Kubernetes.
  2. Seleccione el clúster de Kubernetes habilitado para Arc (tipo = "Kubernetes: Azure Arc") donde se implementó la extensión.
  3. En el panel de navegación de la izquierda, en Configuración, seleccione "Extensiones".
  4. Debería ver la extensión que se acaba de crear anteriormente en estado "Instalado".

Panel Extensiones

CLI de kubectl

  1. Conéctese al clúster de Kubernetes mediante una ventana de terminal.
  2. Ejecute el comando siguiente y asegúrese de que (1) se ha creado el espacio de nombres mencionado anteriormente y (2) el pod bootstrapper está en estado "En ejecución" antes de continuar con el paso siguiente.
kubectl get pods -n <name of namespace used in the json template file above>

Por ejemplo, los comandos siguientes obtienen los pods del espacio de nombres arc.

#Example:
kubectl get pods -n arc

Creación de una ubicación personalizada mediante la extensión de la CLI de ubicación personalizada

Una ubicación personalizada es un recurso de Azure equivalente a un espacio de nombres en un clúster de Kubernetes. Las ubicaciones personalizadas se usan como destino para implementar recursos en o desde Azure. Obtenga más información sobre las ubicaciones personalizadas en Ubicaciones personalizadas basadas en Kubernetes habilitado para Azure Arc.

Establecimiento de variables de entorno

Linux

export clName=mycustomlocation
export clNamespace=arc
export hostClusterId=$(az connectedk8s show -g ${resourceGroup} -n ${resourceName} --query id -o tsv)
export extensionId=$(az k8s-extension show -g ${resourceGroup} -c ${resourceName} --cluster-type connectedClusters --name ${ADSExtensionName} --query id -o tsv)

az customlocation create -g ${resourceGroup} -n ${clName} --namespace ${clNamespace} \
  --host-resource-id ${hostClusterId} \
  --cluster-extension-ids ${extensionId} --location eastus

Windows PowerShell

$ENV:clName="mycustomlocation"
$ENV:clNamespace="arc"
$ENV:hostClusterId = az connectedk8s show -g "$ENV:resourceGroup" -n "$ENV:resourceName" --query id -o tsv
$ENV:extensionId = az k8s-extension show -g "$ENV:resourceGroup" -c "$ENV:resourceName" --cluster-type connectedClusters --name "$ENV:ADSExtensionName" --query id -o tsv

az customlocation create -g "$ENV:resourceGroup" -n "$ENV:clName" --namespace "$ENV:clNamespace" --host-resource-id "$ENV:hostClusterId" --cluster-extension-ids "$ENV:extensionId"

Validación de la creación de la ubicación personalizada

Desde el terminal, ejecute el siguiente comando para enumerar las ubicaciones personalizadas y compruebe que el estado de aprovisionamiento se muestra como realizado correctamente:

az customlocation list -o table

Creación del controlador de datos de Azure Arc

Después de crear la extensión y la ubicación personalizada, continúe con Azure Portal para implementar el controlador de datos de Azure Arc.

  1. Inicie sesión en Azure Portal.
  2. Busque "controlador de datos de Azure Arc" en Azure Marketplace e inicie el flujo de creación.
  3. En la sección Requisitos previos, asegúrese de que el clúster de Kubernetes habilitado para Azure Arc (modo directo) esté seleccionado, y continúe con el paso siguiente.
  4. En la sección Detalles del controlador de datos, elija una suscripción y un grupo de recursos.
  5. Escriba un nombre para el controlador de datos.
  6. Elija un perfil de configuración en función del proveedor de la distribución de Kubernetes en la que va a implementar.
  7. Elija la ubicación personalizada que ha creado en el paso anterior.
  8. Proporcione los detalles del nombre de inicio de sesión y la contraseña del administrador del controlador de datos.
  9. Proporcione los detalles de ClientId, TenantId y secreto de cliente de la entidad de servicio que se usará para crear los objetos de Azure. Consulte Carga de datos de uso, métricas y registros en Azure Monitor para obtener instrucciones detalladas sobre cómo crear una cuenta de entidad de servicio y los roles que se deben conceder para la cuenta.
  10. Haga clic en Siguiente, revise todos los detalles de la página de resumen y haga clic en Crear.

Supervisión de la creación

Cuando el estado de implementación de Azure Portal muestra que la implementación se ha realizado correctamente, puede comprobar el estado de la implementación del controlador de datos de Arc en el clúster de la siguiente manera:

kubectl get datacontrollers -n arc

Pasos siguientes

Creación de un grupo de servidores de Hiperescala de PostgreSQL habilitada para Azure Arc

Creación de una Instancia administrada de Azure SQL en Azure Arc