Preparación de las máquinas para AKS Edge Essentials

  • Artículo

En este artículo se describe cómo configurar una máquina de nodos de Edge Essentials de Azure Kubernetes Service (AKS).

Requisitos previos

Nota

Si va a realizar una instalación sin conexión o la máquina se ejecuta en un entorno corporativo con directivas de seguridad que pueden limitar la conexión a Internet, asegúrese de comprobar la instalación sin conexión de AKS Edge Essentials.

Descarga de AKS Edge Essentials

Puede implementar un clúster de AKS Edge Essentials en una sola máquina o en varias máquinas. En una implementación de varias máquinas, una de las máquinas es la máquina principal con un nodo de control de Kubernetes y las demás máquinas son máquinas secundarias que son nodos de control o nodos de trabajo. Debe instalar AKS Edge Essentials en las máquinas principales y secundarias como se indica a continuación. Una vez instalado AKS Edge Essentials, al crear el clúster de Kubernetes, se identifica una máquina como principal y el resto como máquinas secundarias.

  1. En el equipo, descargue el archivoAksEdge-k3s.msi o AksEdge-k8s.msi , en función de la distribución de Kubernetes que quiera usar. Además, si va a crear un nodo de trabajo de Windows, necesitará los archivos de nodo de Windows.

    Archivo Vínculo
    Instalador de K8s (1.27.6) aka.ms/aks-edge/k8s-msi
    Instalador de K3s (1.27.6) aka.ms/aks-edge/k3s-msi
    Instalador de K8s (1.26.6) aka.ms/aks-edge/k8s-msi-1.26
    Instalador de K3s (1.26.10) aka.ms/aks-edge/k3s-msi-1.26
    Archivos de nodo de Windows aka.ms/aks-edge/windows-node-zip

  2. Además de MSI, Microsoft proporciona ejemplos y herramientas que puede descargar desde el repositorio de GitHub de AKS Edge. Vaya a la pestaña Código y haga clic en el botón Descargar archivo ZIP para descargar el repositorio como un archivo .zip . Extraiga el archivo .zip de GitHub en una carpeta local.

  3. Antes de instalarlo, asegúrese de desinstalar las instalaciones de versión preliminar privada y reinicie el sistema antes de continuar.

En esta versión, se admiten K8s y K3. Hemos proporcionado dos instaladores msi independientes para cada distribución de Kubernetes. No instale k8s y K3 al mismo tiempo. Si desea instalar otra distribución de Kubernetes, desinstale primero la existente y, a continuación, reinicie.

Nota

Debe extraer los archivos de nodo de Windows del archivo ZIP en la misma carpeta que los MSIs del instalador si desea usar la funcionalidad de nodo de Windows. Antes de instalar msi, puede revisar la matriz de compatibilidad de características para comprender las distintas opciones disponibles.

Instalación de AKS Edge Essentials

  1. Abra PowerShell como administrador (powerShell con privilegios elevados) y vaya al directorio de carpetas con los archivos del instalador.

  2. Emita el siguiente comando y reemplace por kXs-x.x.xxx.x la versión o distribución de Kubernetes que descargó y ejecutó:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi

    Opcionalmente, puede especificar el directorio de instalación y el directorio vhdx (directorio donde se almacenan los archivos vhdx de las máquinas virtuales) mediante INSTALLDIR y VHDXDIR. De forma predeterminada, se encuentran en C:\Program Files\AksEdge:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx

    Como alternativa, puede hacer doble clic en el archivoAksEdge-k8s-x.x.xxx.x.msi o AksEdge-k3s-x.x.xxx.x.msi para instalar la versión más reciente.

  3. Para incluir nodos de Windows, asegúrese de que tiene el instalador MSI con la distribución de Kubernetes que prefiera y los archivos AksEdgeWindows-v1 descomprimidos en la misma carpeta. En el comando siguiente, reemplace por kXs-x.x.xxx.x la distribución o versión de Kubernetes que descargó y ejecutó:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature

    O BIEN

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx

    Ahora está listo para realizar una implementación mixta.

  4. Abra otra ventana de PowerShell con privilegios elevados y continúe con el paso siguiente.

Comprobación de los módulos de AKS Edge Essentials

Una vez completada la instalación, asegúrese de que se realizó correctamente mediante la ejecución del siguiente comando en un PowerShell con privilegios elevados:

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
Import-Module AksEdge
Get-Command -Module AKSEdge | Format-Table Name, Version

Este comando muestra una salida similar a la siguiente lista:

Captura de pantalla de los módulos de PowerShell instalados.

Consulte la referencia de cmdlets de PowerShell de AKS Edge Essentials para obtener una lista completa de los comandos admitidos.

Comprobación de la configuración del dispositivo

Puede ejecutar el Install-AksEdgeHostFeatures comando para validar la configuración de Hyper-V, SSH y Power en la máquina. Esto puede requerir un reinicio del sistema:

Install-AksEdgeHostFeatures

Este comando muestra una salida similar a la siguiente lista:

Captura de pantalla que muestra las comprobaciones realizadas.

Pasos siguientes