¿Qué hace airunway-aks-setup?
Habilidad de agente 'airunway-aks-setup' de microsoft/azure-skills. Úsala cuando la tarea coincida con el dominio de esta habilidad.
Descripción
Esta habilidad automatiza la configuración de un clúster de Azure Kubernetes Service (AKS) para la plataforma Airunway, incluyendo la creación del clúster, grupos de nodos, redes virtuales, integración con Azure Container Registry y configuración de identidad gestionada.
Plataformas compatibles
- Azure CLI
- Bicep
- Terraform
- Azure Portal (opcional)
Requisitos previos
- Suscripción activa de Azure
- Azure CLI instalado y autenticado
- Permisos de contributor en el grupo de recursos destino
- Acceso a Azure Container Registry (si se requiere)
Uso
El agente utilizará esta habilidad cuando detecte que la tarea involucra:
- Crear un clúster de AKS
- Configurar redes avanzadas (Azure CNI, kubenet)
- Integrar ACR con AKS
- Configurar identidad gestionada (System-assigned o User-assigned)
- Escalar o modificar grupos de nodos
Parámetros de entrada
| Parámetro | Descripción | Obligatorio |
|---|---|---|
clusterName | Nombre del clúster AKS | Sí |
resourceGroup | Grupo de recursos de Azure | Sí |
location | Región de Azure (ej. eastus) | Sí |
nodeCount | Número inicial de nodos (por defecto 3) | No |
acrName | Nombre del ACR a integrar | No |
Pasos de ejecución
- Validar los parámetros de entrada.
- Verificar la existencia del grupo de recursos; si no existe, crearlo.
- Crear el clúster de AKS con la configuración especificada.
- Si se proporciona
acrName, integrar ACR con el clúster. - Configurar
kubectlpara conectarse al clúster. - Mostrar el estado final del clúster.
Ejemplo
# Crear un clúster AKS básico
az aks create --resource-group myResourceGroup --name myAKSCluster --node-count 3 --enable-managed-identity
# Obtener credenciales
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
Notas
- Asegúrate de que el nombre del clúster sea único dentro de la región.
- La integración con ACR requiere permisos
AcrPullasignados al clúster. - Para entornos productivos, considera usar Azure CNI para redes avanzadas.