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

Puede usar una máquina Linux en Azure Stack Hub para hospedar el motor de AKS para 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 el clúster para las instancias de Azure Stack Hub conectadas y desconectadas, comprobar la instalación y configurar la máquina virtual cliente en el 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:

1. Si la máquina cliente debe recuperarse en un desastre.
2. Cómo se conectará al equipo cliente y cómo 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.

1. 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.

2. Conéctese a la máquina virtual.

3. 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.

4. Instale la CLI de Azure. Los paquetes de la CLI de Azure están disponibles para la mayoría de las distribuciones. Puede encontrar instrucciones en Instalación de la CLI de Azure en Linux.

5. 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 instalará la versión más reciente, que puede necesitar una imagen de disco duro virtual 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.

6. 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 de AKS Engine:

   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.

1. 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.

2. 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.

3. 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.

4. 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.

5. Conéctese a la máquina virtual.

6. 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 de AKS Engine:

   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.

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

aks-engine version

3. Si el punto de conexión de Azure Resource Manager usa 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 en la máquina virtual en este directorio: /var/lib/waagent/Certificates.pem. Copie el archivo de certificado con el comando siguiente:

   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.

Cuando usa un ASDK, el punto de conexión de Azure Resource Manager usa un certificado autofirmado, debe agregar explícitamente este certificado al almacén de certificados de confianza de la máquina. Puede encontrar el certificado raíz de 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 comando siguiente:

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

sudo update-ca-certificates

Pasos siguientes