Configuración de los requisitos previos para el motor de AKS en Azure Stack Hub

Puede instalar el motor de AKS en máquinas virtuales (VM) en su entorno o en cualquier máquina cliente con acceso al punto de conexión Resource Manager de Azure Stack Hub. Tenga en vigor lo siguiente antes de ejecutar el motor: un servidor base de AKS Ubuntu y una extensión de script personalizado de Linux disponibles en la suscripción, una identidad de entidad de servicio que se ha asignado a un rol de colaborador y un par de claves privadas o públicas para el acceso SSH al servidor Ubuntu. Además, si usa el Kit de desarrollo de Azure Stack, debe hacer que la máquina confíe en los certificados adecuados.

Si tiene los requisitos previos, puede empezar a definir el clúster.

Si es el operador de nube para Azure Stack Hub y desea ofrecer el motor de AKS, siga las instrucciones de Incorporación del motor de AKS al marketplace de Azure Stack Hub.

Requisitos previos para el motor de AKS

Para usar el motor de AKS, debe tener disponibles los siguientes recursos. Tenga en cuenta que los inquilinos de Azure Stack Hub usan el motor de AKS para implementar clústeres de Kubernetes en su suscripción de inquilino. La única parte en la que se puede requerir la implicación del operador de Azure Stack Hub es en la descarga de los elementos de Marketplace y la creación de una identidad de entidad de servicio. Puede encontrar los detalles en la tabla siguiente.

El operador de la nube deberá tener en vigor los siguientes elementos.

Requisito previo Descripción Obligatorio Instructions
Azure Stack Hub 1910 o posterior El motor de AKS requiere Azure Stack Hub 1910 o superior. Requerido Si no está seguro de la versión de Azure Stack Hub, póngase en contacto con el operador de nube.
Extensión de script personalizado de Linux Extensión de script personalizado de Linux 2.0
Oferta: Script personalizado para Linux 2.0
Versión: 2.0.6 (o la versión más reciente)
Publicador: Microsoft Corp
Obligatorio Si no tiene este elemento en la suscripción, póngase en contacto con el operador de la nube.
Imágenes base de AKS Imágenes base de AKS para Ubuntu y Windows
Para más información sobre la dependencia de versión, consulte Correspondencia de la versión del motor con la imagen base.
Obligatorio Si no tiene este elemento en la suscripción, póngase en contacto con el operador de la nube.
Si es el operador de nube para Azure Stack Hub y desea ofrecer el motor de AKS, siga las instrucciones que se indican en Incorporación del motor de AKS al marketplace de Azure Stack Hub.
Identidad de la entidad de servicio (SPN) Una aplicación que necesita implementar o configurar recursos a través de Azure Resource Manager, debe estar representada por una entidad de servicio. Obligatorio Es posible que tenga que ponerse en contacto con el operador de nube de Azure Stack Hub para obtener un SPN y un secreto actual.
Si se usa una identidad de entidad de servicio de Microsoft Entra, se requiere acceso a Internet desde las máquinas virtuales del clúster de Kubernetes para que la entidad de servicio pueda autenticarse con Microsoft Entra id. También necesita un secreto activo. Cuando expire el secreto, el clúster no será funcional. Si el entorno no tiene acceso a Internet, el clúster de Kubernetes no será funcional.
Para obtener instrucciones, consulte Uso de una identidad de aplicación para acceder a recursos.
Rol de colaborador asignado (SPN) Para permitir que una aplicación acceda a los recursos de su suscripción con su entidad de servicio, debe asignar la entidad de servicio un rol para un determinado recurso. Obligatorio Para obtener instrucciones, consulte la sección Asignar un rol.

Puede establecer los siguientes elementos.

Requisito previo Descripción Obligatorio Instructions
Suscripción a Azure Stack Hub A las ofertas de Azure Stack Hub se acceder mediante suscripciones. La oferta contiene los servicios que tiene a su disposición. Obligatorio Para poder implementar cargas de trabajo de inquilinos en Azure Stack Hub, primero es preciso obtener una suscripción a Azure Stack Hub.
Resource group Un grupo de recursos es un contenedor que almacena los recursos relacionados con una solución de Azure. Si no especifica un grupo de recursos existente, la herramienta creará uno automáticamente. Opcional Administración de grupos de recursos de Azure Resource Manager mediante Azure Portal
Clave pública privada Para usar una conexión SSH abierta desde una máquina de desarrollo a la máquina virtual del servidor en una instancia de Azure Stack Hub que hospede una aplicación web, es preciso crear un par de claves, pública y privada, de Secure Shell (SSH). Obligatorio Para obtener instrucciones sobre cómo generar una clave, consulte SSH Key Generation (Generación de claves SSH).

Nota:

También puede crear los requisitos previos para el motor de AKS con la CLI de Azure para Azure Stack Hub o PowerShell de Azure Stack Hub.

Correspondencia de la versión del motor con la imagen base

El motor de AKS implementa un sistema operativo Ubuntu Server personalizado en cada imagen de nodo de clúster, la distribución de imágenes base de AKS y Ubuntu de Windows. Cualquier versión del motor de AKS depende de una versión de imagen específica que el operador de Azure Stack Hub haya incorporado a Azure Stack Hub para que esté disponible. Puede encontrar una tabla que muestre las versiones del motor de AKS y las versiones de Kubernetes compatibles correspondientes en Versiones admitidas de Kubernetes. Por ejemplo, la versión v0.55.0 del motor de AKS depende de la versión 2020.08.24 de la distribución de la imagen base de AKS para Ubuntu y Windows. Pida al operador de Azure Stack Hub que descargue la versión de imagen específica de Azure Marketplace en Marketplace de Azure Stack Hub.

Desencadenará un error si la imagen no está disponible en Marketplace de Azure Stack Hub. Por ejemplo, si actualmente usa la versión v0.55.0 del motor de AKS y AKS Base Ubuntu, y la versión 2020.08.24 de distribución de imágenes de Windows no está disponible, verá el siguiente error al ejecutar el motor de AKS:

The platform image 'microsoft-aks:aks:aks-ubuntu-1604-202003:2020.08.24' is not available. 
Verify that all fields in the storage profile are correct.

Para comprobar la versión actual del motor de AKS, ejecute el comando siguiente:

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
Version: v0.55.0
GitCommit: 44a35c00c
GitTreeState: clean

Pasos siguientes