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

Esta guía rápida de inicio describe cómo configurar un clúster de Azure Kubernetes Service (AKS) Edge Essentials de una sola máquina K3S solo para Linux.

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 libre, 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. Use la versión 22H2 del cliente más reciente (compilación del sistema operativo 19045) o Server 2022 (compilación del sistema operativo 20348) . Puedes 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 del software de Microsoft y la AcceptEULA marca se establece en true para indicar 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 todavía está implementado:
  • Credenciales de inicio de sesión: necesarias para la autenticación interactiva en Azure mediante la CLI de Azure. La cuenta debe tener uno de estos roles Owner, Contributor, o Administrator.
  • Identificador de suscripción<subscription-id>: en Azure Portal, seleccione la suscripción que usa y busque el identificador de suscripción (GUID).
  • Su Tenant ID<tenant-id>: En el Portal de Azure, 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>dónde desea 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 admiten ambos.

Paso 1: Descargar script para una implementación sencilla

Descargue el AksEdgeQuickStart.ps1 script en una carpeta de trabajo. En función de la configuración de directiva en su equipo, es posible que tenga que desbloquear el archivo antes de ejecutarlo y usar 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 siguientes pasos:

• 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, este paso descarga la rama principal actual.
• Usa el script AksEdgeAzureSetup para pedir al usuario que inicie sesión en Azure Portal con sus credenciales de Azure y realice las tareas siguientes:
  • 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 función Start-AideWorkflow 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). Es posible que la máquina se reinicie 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 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 para servidores.
  • Conecta el clúster implementado en 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. Este script abre un clúster K3s:

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

Para instalar la versión de Kubernetes, 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.

Paso 3: Comprobación de la implementación

1. Confirme que la implementación se realizó correctamente ejecutando:

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

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

   

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

   

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

   

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

   

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

   

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
   

   

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.

Pasos siguientes

• Comprender las opciones de implementación.
• Implemente una aplicación Linux.
• Agregue un nodo de Windows.
• Información general
• Desinstalación del clúster de AKS