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

Artículo
12/01/2023

Puede usar una máquina Linux en Azure Stack Hub para hospedar el motor de AKS con el fin de implementar y administrar un clúster de Kubernetes. En este artículo, se examina la preparación de la máquina virtual cliente para administrar su clúster para instancias de Azure Stack Hub conectadas y desconectadas, se comprueba la instalación y se configura la máquina virtual cliente en ASDK.

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, se usa 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 va conectar a la máquina cliente y cómo va a interactuar la máquina con el clúster.

Instalación 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 Linux en Azure Stack Hub. Para obtener instrucciones, consulte Inicio rápido: Creación de una máquina virtual de servidor Linux mediante el portal de Azure Stack Hub.
Conéctese a la máquina virtual.
Use el administrador de paquetes para comprobar que tiene instaladas las siguientes herramientas:
- jq un procesador JSON.
- curl - una herramienta para transferir archivos mediante una variedad de protocolos de red.
- openssh un cliente SSH.
- tar una herramienta que se usa para trabajar con archivos TAR.
Instale la CLI de Azure. Los paquetes de la CLI de Azure están disponibles para la mayoría de distribuciones. Puede encontrar más instrucciones en Instalación de la CLI de Azure en Linux.
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 el Marketplace de Azure Stack Hub. Al ejecutar el comando, debe especificar la versión --version v0.xx.x. Si no lo hace, el comando instalará la versión más reciente, que podría necesitar una imagen de 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:

Para las versiones 0.73.0 y posteriores del motor de AKS:

sudo apt update
sudo apt install jq
curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine/master/scripts/get-akse.sh
chmod 700 get-akse.sh
./get-akse.sh --version v0.xx.x

Para las versiones 0.75.3 y posteriores del motor de AKS:

sudo apt update
sudo apt install jq
curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/scripts/get-akse.sh
chmod 700 get-akse.sh
./get-akse.sh --version v0.xx.x

Nota:

Si se produce un error en el método de instalación, pruebe los pasos del entorno desconectado.

Instalación 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:

Para las versiones 0.73.0 y posteriores del motor de AKS, vaya a GitHub Azure/aks-engine. Descargue un archivo (*.tar.gz) para una máquina Linux, por ejemplo, aks-engine-v0.xx.x-linux-amd64.tar.gz.

Para las versiones 0.75.3 y posteriores del motor de AKS, vaya a GitHub Azure/aks-engine-azurestack. Descargue un archivo (*.tar.gz) para una máquina Linux, por ejemplo.aks-engine-azurestack-v0.xx.x-linux-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 Linux en Azure Stack Hub. Para obtener instrucciones, consulte Inicio rápido: Creación de una máquina virtual de servidor Linux mediante 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 en el directorio /usr/local/bin.
Conéctese a la máquina virtual.

Ejecute el siguiente comando:

Para las versiones 0.73.0 y posteriores del motor de AKS:

curl -o aks-engine-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-v0.xx.x-linux-amd64.tar.gz>
tar xvzf aks-engine-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin

Para las versiones 0.75.3 y posteriores del motor de AKS:

curl -o aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz>
tar xvzf aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin

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 el punto de conexión de Azure Resource Manager utiliza un certificado autofirmado, debe agregar explícitamente el certificado raíz al almacén de certificados de confianza de la máquina. Puede encontrar el certificado raíz de la máquina virtual en este directorio: /var/lib/waagent/Certificates.pem. Copie el archivo de certificado con el siguiente comando:
```
sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt 
sudo update-ca-certificates
```

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

Deberá agregar un certificado al ejecutar la máquina virtual cliente para el motor de AKS en el ASDK.

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. Por ejemplo, en una máquina virtual Ubuntu, la encontrará en este directorio /var/lib/waagent/Certificates.pem.

Copie el archivo de certificado con el siguiente comando:

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt

sudo update-ca-certificates

Pasos siguientes

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