Compartir a través de

Creación de clústeres de Kubernetes mediante Bicep

  • Artículo

En este artículo se describe cómo crear clústeres de Kubernetes en Azure Local mediante Bicep. El flujo de trabajo es el siguiente:

  1. Creación de un par de claves SSH
  2. Cree un clúster de Kubernetes en Azure Local, versión 23H2 mediante Bicep. De forma predeterminada, el clúster está conectado a Azure Arc.
  3. Valide la implementación y conéctese al clúster.

Antes de empezar

Asegúrese de que cumple los siguientes requisitos previos antes de empezar:

  1. Obtenga los detalles siguientes del administrador de infraestructura local:

    • Identificador de suscripción de Azure: el identificador de suscripción de Azure que usa Azure Local para la implementación y el registro.
    • Nombre o identificador de ubicación personalizado: el identificador de Azure Resource Manager de la ubicación personalizada. La ubicación personalizada se configura durante la implementación del clúster local de Azure. El administrador de infraestructura debe proporcionarle el identificador de Resource Manager de la ubicación personalizada. Este parámetro es necesario para crear clústeres de Kubernetes. También puede obtener el identificador de Resource Manager mediante az customlocation show --name "<custom location name>" --resource-group <azure resource group> --query "id" -o tsv, si el administrador de infraestructura proporciona un nombre de ubicación personalizado y un nombre de grupo de recursos.
    • Nombre o identificador de red lógico: el identificador de Azure Resource Manager de la red lógica local de Azure que se creó siguiendo estos pasos. El administrador debe proporcionarle el identificador de la red lógica. Este parámetro es necesario para crear clústeres de Kubernetes. También puede obtener el identificador de Azure Resource Manager mediante az stack-hci-vm network lnet show --name "<lnet name>" --resource-group <azure resource group> --query "id" -o tsv si conoce el grupo de recursos en el que se creó la red lógica.

  2. Asegúrese de que tiene la versión más reciente de la CLI de Azure en la máquina de desarrollo. También puede actualizar la versión de la CLI de Azure mediante az upgrade.

  3. Descargue e instale kubectl en la máquina de desarrollo. La herramienta de línea de comandos de Kubernetes, kubectl, le permite ejecutar comandos en clústeres de Kubernetes. Puede usar kubectl para implementar aplicaciones, inspeccionar y administrar recursos de clúster y ver los registros.

Creación de un par de claves SSH

Para crear un par de claves SSH (igual que Azure AKS), use el procedimiento siguiente:

  1. Abrir una sesión de Cloud Shell en el explorador o abrir un terminal en el equipo local.

  2. Cree un par de claves SSH mediante az sshkey create:

    az sshkey create --name <Public_SSH_Key> --resource-group <Resource_Group_Name>

    O bien, cree un par de claves SSH local mediante ssh-keygen:

    ssh-keygen -t rsa -b 4096

Se recomienda crear un par de claves SSH en Azure, ya que puede usarlo más adelante para el acceso a nodos o la solución de problemas. Para más información sobre cómo crear claves SSH, consulte Creación y administración de claves SSH para la autenticación en Azure y Restringir el acceso SSH.

Descarga y actualización de los scripts de Bicep

Descargue estos dos archivos del repositorio AKSArc GitHub para la implementación de su Bicep: main.bicep y aksarc.bicepparam. Actualice los parámetros de aksarc.bicepparam según sea necesario y asegúrese de que todos los valores predeterminados de main.bicep son correctos.

El tipo de recurso Microsoft.HybridContainerService/provisionedClusterInstances está definido en main.bicep. Si desea personalizar más propiedades para la creación de clústeres, consulte la Referencia de la API provisionedClusterInstances.

Implementar las plantillas de Bicep

Creación de una implementación de Bicep mediante la CLI de Azure:

az deployment group create --name BicepDeployment --resource-group <Resource_Group_Name> --parameters aksarc.bicepparam

Validación de la implementación y conexión al clúster

Ahora puede conectarse al clúster de Kubernetes ejecutando az connectedk8s proxy comando desde la máquina de desarrollo. También puede usar kubectl para ver el estado del nodo y el pod. Siga los mismos pasos que se describen en Conexión al clúster de Kubernetes.

Pasos siguientes

Creación de clústeres de Kubernetes mediante la CLI de Azure