Azure Kubernetes Service
GUÍA AUTORITATIVA — CUMPLIMIENTO OBLIGATORIO
Este skill produce una configuración de clúster AKS recomendada basada en los requisitos del usuario, distinguiendo las decisiones Day-0 (red, servidor API — difíciles de cambiar después) de las características Day-1 (se pueden habilitar después de la creación). Consulte la referencia CLI para comandos.
Referencia Rápida
| Propiedad | Valor |
|---|---|
| Mejor para | Planificación de clústeres AKS y decisiones Day-0 |
| Herramientas MCP | mcp_azure_mcp_aks |
| CLI | az aks create, az aks show, kubectl get, kubectl describe |
| Skills relacionados | azure-diagnostics (solución de problemas de AKS), azure-validate (comprobaciones de preparación) |
Cuándo Usar Este Skill
Active este skill cuando el usuario quiera:
- Crear un nuevo clúster AKS
- Planificar la configuración de un clúster AKS para cargas de trabajo de producción
- Diseñar la red de AKS (acceso al servidor API, modelo de IP de pods, salida)
- Configurar la identidad y gestión de secretos en AKS
- Configurar la gobernanza de AKS (Azure Policy, Salvaguardas de Implementación)
- Habilitar la observabilidad de AKS (Container Insights, Managed Prometheus, Grafana)
- Definir la estrategia de actualización y parches para AKS
- Habilitar la visibilidad y análisis de costos de AKS
- Comprender las diferencias entre AKS Automatic y Standard SKU
- Obtener una lista de verificación Day-0 para la configuración y creación de clústeres AKS
Reglas
- Comience con los requisitos del usuario para aprovisionar cómputo, red, seguridad y otras configuraciones.
- Use el servidor MCP
azurey seleccionemcp_azure_mcp_aksprimero para descubrir las herramientas MCP específicas de AKS expuestas por el cliente. Elija la herramienta AKS más pequeña que se ajuste a la tarea y recurra a la CLI de Azure (az aks) solo cuando la funcionalidad necesaria no esté expuesta a través de la superficie MCP de AKS. - Determine si el SKU AKS Automatic o Standard es más apropiado según la necesidad del usuario de control versus conveniencia. Por defecto, use AKS Automatic a menos que se requieran personalizaciones específicas.
- Documente las decisiones y la justificación de las opciones de configuración del clúster, especialmente para decisiones Day-0 que son difíciles de cambiar después (red, acceso al servidor API).
Entradas Requeridas (Pregunte solo lo necesario)
Si el usuario no está seguro, use valores predeterminados seguros.
- Tipo de entorno AKS: dev/test o producción
- Región(es), zonas de disponibilidad, tamaños de VM de nodo preferidos
- Escala esperada (número de nodos/clúster, tamaño de la carga de trabajo)
- Requisitos de red (acceso al servidor API, modelo de IP de pods, control de entrada/salida)
- Requisitos de seguridad e identidad, incluido el registro de imágenes
- Preferencias de actualización y observabilidad
- Restricciones de costo
Flujo de Trabajo
1. Tipo de Clúster
- AKS Automatic (predeterminado): Mejor para la mayoría de las cargas de trabajo de producción, proporciona una experiencia curada con las mejores prácticas preconfiguradas para seguridad, confiabilidad y rendimiento. Úselo a menos que tenga requisitos personalizados específicos para redes, autoescalado o configuraciones de grupos de nodos no compatibles con Node Auto-Provisioning (NAP).
- AKS Standard: Úselo si necesita control total sobre la configuración del entorno, lo que requiere una carga adicional para configurar y gestionar.
2. Red (IP de Pods, Salida, Entrada, Plano de Datos)
Modelo de IP de Pods (decisión Day-0 clave):
- Azure CNI Overlay (recomendado): las IPs de los pods provienen de un rango de overlay privado, no son enrutables en la VNet, escalan a grandes entornos y son adecuadas para la mayoría de las cargas de trabajo.
- Azure CNI (enrutable en VNet): las IPs de los pods provienen directamente de la VNet (subred de pods o subred de nodos), úselo cuando los pods deban ser directamente direccionables desde la VNet o desde instalaciones locales.
Plano de Datos y Política de Red:
- Azure CNI con Cilium (recomendado): basado en eBPF para procesamiento de paquetes de alto rendimiento, políticas de red y observabilidad.
Salida:
- Static Egress Gateway para IPs de salida estables y predecibles.
- Para salida restringida: UDR + Azure Firewall o NVA.
Entrada:
- Complemento App Routing con Gateway API — recomendado por defecto para cargas de trabajo HTTP/HTTPS.
- Istio service mesh con Gateway API — para gestión avanzada de tráfico, mTLS, lanzamientos canary.
- Application Gateway for Containers — para balanceo de carga L7 con integración WAF.
DNS:
- Habilite LocalDNS en todos los grupos de nodos para una resolución DNS confiable y de alto rendimiento.
3. Seguridad
- Use Microsoft Entra ID en todas partes (plano de control, Workload Identity para pods, acceso a nodos). Evite credenciales estáticas.
- Azure Key Vault a través de Secrets Store CSI Driver para secretos.
- Habilite Azure Policy + Salvaguardas de Implementación.
- Habilite Cifrado en reposo para etcd/servidor API; en tránsito para nodo a nodo.
- Permita solo imágenes firmadas y aprobadas por políticas (Azure Policy + Ratify), prefiera Azure Container Registry.
- Aislamiento: Use espacios de nombres, políticas de red, registro con ámbito.
4. Observabilidad
- Use Managed Prometheus y Container Insights con Grafana para la observabilidad de AKS (registros + métricas).
- Habilite la Configuración de Diagnóstico para recopilar registros del plano de control y registros de auditoría en un área de trabajo de Log Analytics para monitoreo de seguridad y solución de problemas.
- Para otras herramientas de monitoreo y solución de problemas, use funciones como Agentic CLI for AKS, Application Insights, Resource Health Center, detectores AppLens y Azure Advisors.
5. Actualizaciones y Parches
- Configure Ventanas de Mantenimiento para un tiempo controlado de actualización.
- Habilite actualizaciones automáticas para el plano de control y el sistema operativo del nodo para mantenerse actualizado con parches de seguridad y versiones de Kubernetes.
- Considere versiones LTS para estabilidad empresarial (soporte de 2 años) actualizando su entorno AKS al nivel Premium.
- Actualizaciones de flota: Use AKS Fleet Manager para implementaciones por etapas en entornos de prueba a producción.
6. Rendimiento
- Use Discos de SO efímeros (
--node-osdisk-type Ephemeral) para un inicio de nodo más rápido. - Seleccione Azure Linux como sistema operativo del nodo (huella más pequeña, arranque más rápido).
- Habilite KEDA para autoescalado basado en eventos más allá de HPA.
7. Grupos de Nodos y Cómputo
- Grupo de nodos de sistema dedicado: Al menos 2 nodos, contaminados solo para cargas de trabajo del sistema (
CriticalAddonsOnly). - Habilite Node Auto Provisioning (NAP) en todos los grupos para ahorro de costos y escalado receptivo.
- Use SKUs de última generación (v5/v6) para optimizaciones a nivel de host.
- Evite VMs de la serie B: los SKUs ráfaga causan problemas de rendimiento/confiabilidad.
- Use SKUs con al menos 4 vCPUs para cargas de trabajo de producción.
- Establezca restricciones de distribución de topología para distribuir pods entre hosts/zonas según el SLO.
8. Confiabilidad
- Implemente en 3 Zonas de Disponibilidad (
--zones 1 2 3). - Use nivel Estándar para un plano de control redundante por zona + SLA del 99.95% para la disponibilidad del servidor API.
- Habilite Microsoft Defender for Containers para protección en tiempo de ejecución.
- Configure PodDisruptionBudgets para todas las cargas de trabajo de producción.
- Use restricciones de distribución de topología para garantizar la distribución de pods entre dominios de falla.
9. Controles de Costos
- Use grupos de nodos spot para cargas de trabajo por lotes/interrumpibles (hasta un 90% de ahorro).
- Detener/Iniciar clústeres dev/test:
az aks stop/start. - Considere Instancias Reservadas o Savings Plans para cargas de trabajo de estado estable.
Barreras de Seguridad / Seguridad
- No solicite ni genere secretos (tokens, claves).
- Si los requisitos son ambiguos para decisiones críticas Day-0, haga preguntas aclaratorias al usuario. Para características habilitadas Day-1, proponga 2–3 opciones seguras con compensaciones y elija un valor predeterminado conservador.
- No prometa cero tiempo de inactividad; aconseje salvaguardas de carga de trabajo (PDB, sondas, réplicas) y actualizaciones por etapas junto con las mejores prácticas de confiabilidad y rendimiento.
Herramientas MCP
| Herramienta | Propósito | Parámetros Clave |
|---|---|---|
mcp_azure_mcp_aks | Punto de entrada MCP de AKS utilizado para descubrir las herramientas específicas de AKS expuestas por el cliente | Descubra primero la herramienta AKS invocable, luego use los parámetros de esa herramienta |
Manejo de Errores
| Error / Síntoma | Causa Probable | Solución |
|---|---|---|
| La llamada a la herramienta MCP falla o supera el tiempo de espera | Credenciales, suscripción o contexto AKS no válidos | Verifique az login, confirme el contexto de suscripción activo con az account show y verifique el grupo de recursos objetivo sin repetar los identificadores de suscripción al usuario |
| Cuota excedida | Límites regionales de vCPU o recursos | Solicite un aumento de cuota o seleccione una región/SKU de VM diferente |
| Conflicto de red (agotamiento de IP) | Subred de pods demasiado pequeña para overlay/CNI | Replanifique los rangos de IP; puede requerir la recreación del clúster (Day-0) |
| Workload Identity no funciona | Falta el emisor OIDC o la credencial federada | Habilite --enable-oidc-issuer --enable-workload-identity, configure la identidad federada |