Compartir a través de


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 de 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 en la nube para Azure Stack Hub y desea ofrecer el motor de AKS, siga las instrucciones de Incorporación del motor de AKS a 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 puede ser necesaria la participación del operador de Azure Stack Hub es descargar elementos de Marketplace y la creación de una identidad de entidad de servicio. Puede encontrar detalles en la tabla siguiente.

El operador de nube deberá tener implementados los siguientes elementos.

Prerrequisito Descripción Obligatorio Instrucciones
Azure Stack Hub 1910 o superior El motor de AKS requiere Azure Stack Hub 1910 o superior. Obligatorio 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 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 nube.
Imágenes base de AKS Imagen base de Windows y Ubuntu de AKS
Para más información sobre la dependencia de versión, consulte Coincidencia del motor con la versión de la imagen base.
Obligatorio Si no tiene este elemento en la suscripción, póngase en contacto con el operador de nube.
Si es el operador en la 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 el identificador de Microsoft Entra. 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 los recursos.
(SPN) rol de colaborador asignado 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 Asignación de un rol.

Puede establecer los siguientes elementos.

Prerrequisito Descripción Obligatorio Instrucciones
Suscripción de Azure Stack Hub Puede acceder a las ofertas de Azure Stack Hub a través de suscripciones. La oferta contiene los servicios que están disponibles para usted. Obligatorio Para poder implementar cualquier carga de trabajo de inquilino en Azure Stack Hub, primero debe obtener una suscripción de Azure Stack Hub.
Grupo de recursos 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á una 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 la máquina de desarrollo a la máquina virtual del servidor en la instancia de Azure Stack Hub que hospeda la aplicación web, debe crear un par de claves pública y privada de Secure Shell (SSH). Obligatorio Para obtener instrucciones sobre cómo generar una clave, consulte 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.

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

El motor de AKS implementa un sistema operativo Ubuntu Server personalizado en cada imagen de nodo de clúster, la distribución de imagen de Windows y Ubuntu base de AKS. Cualquier versión del motor de AKS depende de una versión de imagen específica que esté disponible en Azure Stack Hub por su operador de Azure Stack Hub. Puede encontrar una tabla en la que se enumeran las versiones del motor de AKS y las versiones de Kubernetes admitidas 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 imágenes de Windows y Ubuntu base de AKS. 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 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
Version: v0.55.0
GitCommit: 44a35c00c
GitTreeState: clean

Pasos siguientes