Guía de inicio rápido de AKS Edge Essentials

  • Artículo

En esta guía de inicio rápido se describe cómo configurar un clúster de K3S linux de Azure Kubernetes Service (AKS) Edge Essentials de una sola máquina.

Requisitos previos

  • Consulte los requisitos del sistema. Para este inicio rápido, asegúrese de que tiene un mínimo de 4,5 GB de RAM libres, 4 vCPU y 20 GB de espacio libre en disco.
  • Requisitos del sistema operativo: instale Windows 10/11 IoT Enterprise/Enterprise/Pro en la máquina y active Windows. Se recomienda usar la versión más reciente del cliente 22H2 (compilación del sistema operativo 19045) o Server 2022 (compilación del sistema operativo 20348) . Puede descargar una versión de Windows 10 aquí o Windows 11 aquí.
  • Consulte los Términos de licencia del software de Microsoft a medida que se aplican al uso del software. Mediante el AksEdgeQuickStart script, acepta los Términos de licencia de software de Microsoft y la AcceptEULA marca se establece en true que indica la aceptación de los términos de licencia.
  • Obtenga los parámetros de suscripción de Azure: para conectar el clúster a Azure Arc, debe proporcionar estos parámetros. Si omite estos parámetros, se omite la conexión de Arc, pero el clúster se sigue implementando.
    • Credenciales de inicio de sesión: se requiere para el inicio de sesión interactivo en Azure mediante la CLI de Azure. Su cuenta debe tener uno de estos roles Owner o ContributorAdministrator.
    • <subscription-id>Identificador de suscripción: en el Azure Portal, seleccione la suscripción que usa y busque el identificador de suscripción (GUID).
    • Identificador de inquilino<tenant-id>: en el Azure Portal, busque Microsoft Entra ID, que le llevará a la página Directorio predeterminado. Busque el identificador de inquilino (GUID).
    • Ubicación (región de Azure):<location> donde quiere que se creen los recursos. Consulte Azure Arc by Region para conocer las ubicaciones compatibles con Azure Arc enabled servers los servicios y Azure Arc enabled Kubernetes . Elija una región en la que se admita ambos.

Paso 1: Descargar script para facilitar la implementación

Descargue el AksEdgeQuickStart.ps1 script en una carpeta de trabajo. En función de la configuración de directiva en la máquina, es posible que tenga que desbloquear el archivo antes de ejecutarse y ejecutarse Set-ExecutionPolicy para permitir la ejecución del script.

Abra una ventana de PowerShell con privilegios elevados y cambie el directorio a una carpeta de trabajo:

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

Este script automatiza los pasos siguientes:

  • En la carpeta de trabajo, el script descarga el archivo de GitHub de Azure/AKS-Edge y descomprime en una carpeta AKS-Edge-main (o AKS-Edge-tag<>). De forma predeterminada, descarga la rama principal actual.
  • Usa el script AksEdgeAzureSetup para pedir al usuario que inicie sesión en el Azure Portal con sus credenciales de Azure y realice las siguientes tareas:
    • Instala la CLI de Azure.
    • Crea un grupo de recursos aksedge-rp.
    • Crea una entidad de servicio aksedge-sp con el rol Colaborador restringido al ámbito del grupo de recursos aksedge-rp . Si la entidad de servicio ya existe, restablece su contraseña. Esta entidad de servicio se usa para conectarse a Azure Arc.
    • Registra los proveedores de recursos Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration y Microsoft.ExtendedLocation.
  • Invoca la Start-AideWorkflow función que realiza las siguientes tareas:
    • Descarga e instala el MSI de AKS Edge Essentials.
    • Instala las características necesarias del sistema operativo host (Install-AksEdgeHostFeatures). La máquina puede reiniciarse cuando Hyper-V está habilitado y debe reiniciar el script de nuevo.
    • Implementa un único clúster de máquina con conmutador interno (solo nodo de Linux).
  • Invoca la Connect-AideArc función si se proporcionan los parámetros de Azure. Esta función realiza las siguientes tareas:
    • Instala el agente de Azure Connected Machine y conecta la máquina host a Arc for Servers.
    • Conecta el clúster implementado a Arc para Kubernetes conectado.

Paso 2: Implementación de AKS Edge Essentials

En un símbolo del sistema de PowerShell con privilegios elevados, ejecute el AksEdgeQuickStart.ps1 script. Esto abre un clúster de K3s:

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

Para instalar la versión K8s, especifique la -UseK8s marca :

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

El script instala AKS Edge Essentials y conecta el clúster a Azure mediante Azure Arc.

Sugerencia

Si Hyper-V no estaba habilitado en la máquina, el script de inicio rápido habilita Hyper-V y reinicia la máquina. Vuelva a ejecutar el AksEdgeQuickStart script después del reinicio.

Paso 3: Comprobar la implementación

  1. Confirme que la implementación se realizó correctamente mediante la ejecución de:

    kubectl get nodes -o wide
kubectl get pods -A -o wide

    En la imagen siguiente se muestran los pods en un clúster K3S:

    Captura de pantalla que muestra todos los pods en ejecución.

  2. Puede ver el clúster en el Azure Portal si navega al grupo de recursos:

    Captura de pantalla que muestra el clúster en Azure Portal

  3. En el panel izquierdo, seleccione los espacios de nombres en recursos de Kubernetes (versión preliminar):

    Captura de pantalla de los recursos de Kubernetes.

  4. Para ver los recursos de Kubernetes, necesita un token de portador:

    Captura de pantalla que muestra la página necesaria del token de portador.

  5. Puede ejecutar Get-AksEdgeManagedServiceToken para recuperar el token de servicio:

    Captura de pantalla que muestra dónde pegar el token en el portal.

  6. Ahora puede ver los recursos en el clúster. Las cargas de trabajo muestran los pods que se ejecutan en el clúster.

    kubectl get pods --all-namespaces

    Captura de pantalla que muestra todos los pods en Arc.

Ahora tiene un clúster K3S de AKS Edge Essentials K3S conectado a Arc con un nodo de Linux. Puede explorar la implementación de una aplicación Linux de ejemplo en este clúster.

Sugerencia

Si no proporcionó los detalles de la suscripción de Azure al ejecutar el AksEdgeQuickStart.ps1 script, todavía puede conectarse a Azure Arc siguiendo los pasos descritos en este artículo.

Pasos siguientes