Instalación del motor de AKS en Windows en Azure Stack Hub

Artículo
12/01/2023

Las descargas binarias para la versión más reciente del motor de AKS están disponibles en Github. Descargue el paquete del sistema operativo y extraiga el archivo aks-engine para las versiones 0.73.0 y posteriores del motor de AKS. Para las versiones 0.75.3 y posteriores del motor de AKS, extraiga el archivo aks-engine-azurestack (y, opcionalmente, agréguelo a $PATH la variable de entorno para un uso más cómodo de la CLI).

Preparación de la máquina virtual cliente

El motor de AKS es una herramienta de línea de comandos que se usa para implementar y administrar el clúster de Kubernetes. El motor se puede ejecutar en una máquina de Azure Stack Hub. Desde esta máquina, ejecute el motor de AKS para implementar los recursos de IaaS y el software necesarios para ejecutar el clúster. Después, puede usar la máquina que ejecuta el motor para realizar tareas de administración en el clúster.

Al elegir la máquina cliente, tenga en cuenta lo siguiente:

Si la máquina cliente debe recuperarse en un desastre.
¿Cómo se conectará a la máquina cliente y cómo interactuará la máquina con el clúster?

Instalación del motor de AKS en un entorno conectado

Puede instalar la máquina virtual cliente para administrar el clúster de Kubernetes en una instancia de Azure Stack Hub conectada a Internet.

Cree una máquina virtual Windows en Azure Stack Hub. Para obtener instrucciones, consulte Inicio rápido: Creación de una máquina virtual Windows Server con el portal de Azure Stack Hub.
Conéctese a la máquina virtual.
Instale Chocolatey con las instrucciones de PowerShell.

Según el sitio web de Chocolatey: Chocolatey es un administrador de paquetes para Windows, como apt-get o yum pero para Windows. Se ha diseñado para ser una plataforma descentralizada para instalar rápidamente las aplicaciones y las herramientas necesarias. Se basa en la infraestructura de NuGet que usa actualmente PowerShell y su objetivo es entregar los paquetes de las distribuciones a su equipo.
Instale la CLI de Azure. Seleccione el vínculo de descarga y elija "Ejecutar". Elija los pasos de configuración según sea necesario.
Busque la versión del motor de AKS en la tabla de asignación de versiones del motor de AKS y de Azure Stack. La imagen base de AKS debe estar disponible en Marketplace de Azure Stack Hub. Al ejecutar el comando, debe especificar la versión --version v0.xx.x. Si no especifica la versión, el comando instala la versión más reciente, que puede necesitar una imagen VHD que no esté disponible en Marketplace.

Nota:

Puede encontrar la asignación de Azure Stack Hub al número de versión del motor de AKS en las notas de la versión del motor de AKS.
Ejecute el siguiente comando desde un símbolo del sistema con privilegios elevados e incluya el número de versión:

Nota:

Para AKSe versión 0.75.3 y posteriores, el comando para instalar el motor de AKS es choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```
Nota:

Si se produce un error en este método para la instalación, puede probar los pasos de un entorno desconectado a continuación.

Instalación del motor de AKS en un entorno desconectado

Puede instalar la máquina virtual cliente para administrar el clúster de Kubernetes en una instancia de Azure Stack Hub desconectada de Internet.

Desde una máquina con acceso a Internet, vaya a GitHub Azure/aks-engine. Descargue un archivo (*.tar.gz) para una máquina Windows, por ejemplo, aks-engine-v0.xx.x-windows-amd64.tar.gz. Busque la versión del motor de AKS en la tabla Versiones admitidas de Kubernetes.
Cree una cuenta de almacenamiento en la instancia de Azure Stack Hub para cargar el archivo de almacenamiento (*.tar.gz) con el archivo binario del motor de AKS. Para obtener instrucciones sobre el uso del Explorador de Azure Storage, consulte Explorador de Azure Storage con Azure Stack Hub.
Cree una máquina virtual Windows en Azure Stack Hub. Para obtener instrucciones, consulte Inicio rápido: Creación de una máquina virtual Windows Server con el portal de Azure Stack Hub
Descargue el archivo en la máquina virtual de administración de la dirección URL del blob de la cuenta de Azure Stack Hub Storage donde cargó el archivo de almacenamiento (*.tar.gz). Extraiga el archivo a un directorio al que tenga acceso desde el símbolo del sistema.
Conéctese a la máquina virtual.
Instale Chocolatey con las instrucciones de PowerShell.
Ejecute el siguiente comando en un símbolo del sistema con privilegios elevados. Incluya el número de versión correcto:

Nota:

Para AKSe versión 0.75.3 y posteriores, el comando para instalar el motor de AKS es choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```

Comprobación de la instalación

Una vez configurada la máquina virtual cliente, compruebe que ha instalado el motor de AKS.

Conéctese a su máquina virtual cliente.
Ejecute el siguiente comando:

Nota:

Para AKSe versión 0.75.3 y posteriores, el comando para comprobar la versión actual del motor de AKS es aks-engine-azurestack version.
```
aks-engine version
```

Si no puede comprobar que ha instalado el motor de AKS en la máquina virtual cliente, consulte Solución de problemas de instalación del motor de AKS.

Instalación de ASDK

Debe agregar un certificado al ejecutar la máquina virtual cliente para el motor de AKS en el ASDK en un equipo fuera del ASDK. Si utiliza una máquina virtual Windows en el propio entorno del ASDK, la máquina ya confía en el certificado del ASDK. Si la máquina cliente está fuera del ASDK, debe extraer el certificado del ASDK y agregarlo a la máquina Windows.

Si usa un ASDK, el punto de conexión de Azure Resource Manager utiliza un certificado autofirmado y debe agregar explícitamente este certificado al almacén de certificados de confianza de la máquina. Puede encontrar el certificado raíz del ASDK en cualquier máquina virtual que implemente en el ASDK.

Exporte el certificado raíz de la entidad de certificación. Para ver las instrucciones necesarias, consulte Exportación del certificado raíz de la entidad de certificación de Azure Stack Hub.
Confianza en el certificado raíz de la entidad de certificación de Azure Stack Hub. Para ver las instrucciones necesarias, consulte Confianza en el certificado raíz de la entidad de certificación de Azure Stack Hub.

Pasos siguientes

Implementación de un clúster de Kubernetes con el motor de AKS en Azure Stack Hub