Skill de Lista de Verificación de Zona de Aterrizaje en Azure (ALZ)
Esta skill te guía a través del llenado de la lista de verificación del Acelerador de Zona de Aterrizaje en Azure (ALZ) — la hoja de cálculo que captura todas las decisiones necesarias antes de implementar una ALZ usando Bicep o Terraform a través de la herramienta Acelerador de ALZ.
El objetivo es producir una lista de verificación en Excel completamente llena, donde cada decisión esté justificada, las mejores prácticas se apliquen por defecto y los elementos que requieran entrada humana estén claramente señalados para la atención del usuario.
Por qué esto es importante
La lista de verificación del Acelerador de ALZ es la fuente única de verdad para una implementación de zona de aterrizaje de plataforma. Equivocarse significa redes mal configuradas, brechas de seguridad u horas de retrabajo. Esta skill garantiza consistencia aplicando las recomendaciones del Marco de Adopción de la Nube (CAF) de Microsoft, respetando la infraestructura existente del usuario (rangos IP, suscripciones, convenciones de nomenclatura).
Flujo de trabajo
Fase 1: Leer la lista de verificación
Lee la lista de verificación .xlsx subida usando openpyxl para comprender su estructura. Las listas de verificación de ALZ suelen tener tres pestañas:
- Accelerator - Bootstrap: Tipo de IaC, VCS, suscripciones, nomenclatura, configuración de CI/CD
- Accelerator - Bicep: Selección de escenario, interruptores de componentes, direccionamiento IP, políticas
- Accelerator - Terraform: Igual que Bicep con opciones adicionales (AMBA, Zona de Aterrizaje Soberana)
Analiza la lista de verificación para identificar qué campos ya tienen valores (columna F = "Valor elegido") y cuáles están vacíos. Esto te indica qué ha decidido el usuario y qué necesita entrada.
Fase 2: Entrevistar al usuario
Recopila decisiones a través de preguntas estructuradas. Pregunta en lotes de 3-4 preguntas para no abrumar al usuario. Prioriza en este orden:
Lote 1 — Decisiones fundamentales:
- Tipo de IaC (Bicep o Terraform)
- Sistema de control de versiones (Azure DevOps, GitHub o local)
- Escenario de topología de red (Hub & Spoke vs vWAN, una región vs multi-región, Azure Firewall vs NVA)
- Región de Azure
Lote 2 — Decisiones de componentes:
- Qué componentes implementar (DDoS, DNS Privado, Bastion, VPN Gateway, ExpressRoute, Zero Trust)
- Postura de seguridad (AMA, planes Defender)
Lote 3 — Detalles específicos del entorno:
- Organización de Azure DevOps / GitHub y nombres de proyecto
- IDs de suscripción (Administración, Conectividad, Identidad, Seguridad)
- Aprobadores de canalizaciones
- Direccionamiento IP (pregunta si tienen documentación existente)
Cuando el usuario diga "usa las mejores prácticas" o delegue una decisión, aplica las recomendaciones de references/alz-best-practices.md. Siempre explica por qué se hace una recomendación — los usuarios confían en recomendaciones que entienden.
Fase 3: Mapear suscripciones
Si el usuario proporciona una lista de suscripciones (de az account list o similar), mapea las suscripciones a roles de ALZ haciendo coincidir patrones de nomenclatura:
| Patrón | Rol ALZ |
|---|---|
*mgmt*, *management* | Administración |
*connectivity*, *network*, *hub* | Conectividad |
*identity*, *ad*, *entra* | Identidad |
*security*, *sentinel*, *defender* | Seguridad |
Si falta una suscripción requerida (comúnmente Seguridad), márcala con un resaltado amarillo y un comentario explicando las opciones:
- Crear una suscripción dedicada (recomendado)
- Compartir con la suscripción de Administración (alternativa con presupuesto limitado)
Fase 4: Integrar direccionamiento IP
Si el usuario proporciona documentación IP (Markdown, CSV, Excel o texto), analízala para extraer:
- Bloques CIDR a nivel de suscripción — mapea a las VNet hub/spoke de ALZ
- Diseño existente de VNet hub — identifica asignaciones de subredes (Gateway, Firewall, Bastion, servicios compartidos)
- IPs públicas on-premises — inclúyelas en comentarios para referencia de reglas de VPN/firewall
- Redes AKS — CIDRs de pod/servicio si aplica
Para la VNet hub de ALZ, recomienda este diseño de subredes usando el bloque CIDR de la suscripción de conectividad:
VNet Hub: <base-conectividad>/16
GatewaySubnet: <base>.0.0/27 (30 hosts)
AzureFirewallSubnet: <base>.0.64/26 (62 hosts)
AzureFirewallManagementSubnet:<base>.0.128/26 (62 hosts)
AzureBastionSubnet: <base>.0.192/26 (62 hosts)
Servicios Compartidos: <base>.1.0/24 (254 hosts)
DNS Resolver Entrante: <base>.2.0/28
DNS Resolver Saliente: <base>.2.16/28
Si no se proporciona documentación IP, usa los valores por defecto de ALZ y márcalos para revisión.
Fase 5: Llenar la lista de verificación
Usa openpyxl para escribir valores en la columna F ("Valor elegido") de las pestañas correspondientes. Aplica formato consistente:
from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.comments import Comment
# Valores confirmados — fondo verde
green_fill = PatternFill('solid', fgColor='CCE5CC')
# Elementos que requieren acción del usuario — fondo amarillo + texto rojo negrita
yellow_fill = PatternFill('solid', fgColor='FFFF00')
action_font = Font(bold=True, color='FF0000', size=10)
# Notas informativas — fondo amarillo cursiva
note_fill = PatternFill('solid', fgColor='FFFFCC')
note_font = Font(italic=True, size=10)
Por cada celda que llenes:
- Añade un Comentario explicando la justificación o referencia de mejor práctica
- Usa relleno verde para decisiones confirmadas
- Usa relleno amarillo + texto rojo para elementos que requieren acción del usuario (ej., "POR DEFINIR", "POR PROPORCIONAR")
- Usa relleno amarillo claro + cursiva para elementos que usan valores por defecto y que el usuario debe revisar
Lógica específica por pestaña:
Solo llena la pestaña que coincida con la elección de IaC del usuario. Limpia la otra pestaña si tenía valores de un intento anterior. Para la pestaña activa:
- Sección de escenarios: Establece el escenario elegido como "Sí", todos los demás como "No". Resalta el seleccionado con un verde más brillante.
- Sección de opciones: Aplica las elecciones de componentes del usuario. Para cualquier opción no discutida explícitamente, aplica los valores por defecto de mejores prácticas y nótalo en el comentario.
- Pestaña Bootstrap: Siempre se llena independientemente de la elección de IaC — es compartida.
Fase 6: Presentar resultados
Después de guardar la lista de verificación llena:
- Imprime una tabla resumen mostrando todos los valores llenados
- Enumera los elementos señalados para acción del usuario (resaltados amarillos)
- Menciona cualquier consideración arquitectónica (ej., necesidad de emparejamiento entre regiones si la región de ALZ difiere de la infraestructura existente)
- Proporciona el enlace del archivo para descarga
Recomendaciones de mejores prácticas
Lee references/alz-best-practices.md para el conjunto completo de recomendaciones. Los valores por defecto clave que aplicar cuando el usuario delega:
- Red privada: verdadero (el almacenamiento de estado nunca debe ser accesible públicamente)
- Repositorio de plantillas CI/CD separado: verdadero (límite de seguridad entre el código y las definiciones de la canalización)
- Políticas de rama: verdadero (requerir PRs para todos los cambios)
- Agentes/ejecutores autoalojados: verdadero (necesarios para redes privadas)
- Protección DDoS: Sí (protección a nivel de red para todos los recursos de VNet)
- Zonas DNS Privadas: Sí (necesarias para Private Endpoints en hub-spoke)
- Azure Bastion: Sí (acceso seguro a VM sin exponer IP pública)
- AMA (Agente de Monitoreo de Azure): Mantener habilitado (monitoreo centralizado)
- Planes Defender: Mantener habilitado (detección de amenazas en todos los tipos de recursos)
- Zero Trust: Sí (acceso con privilegios mínimos y microsegmentación)
- Alertas AMBA (solo Terraform): Sí (monitoreo proactivo de recursos de plataforma)
- Zona de Aterrizaje Soberana: No (a menos que se requiera explícitamente por cumplimiento)
Consideraciones entre regiones
Si la infraestructura existente del usuario está en una región diferente a la implementación de ALZ, márcalo en el comentario de la región en la pestaña Bootstrap. Deberán planificar el emparejamiento de VNet entre regiones entre el hub de ALZ y cualquier topología hub-spoke existente.
Mapa de Referencia de Celdas
La lista de verificación tiene una estructura fija. Usa estas referencias de celda exactas al escribir valores para evitar errores de desplazamiento de filas. Siempre verifica que la columna B (Nombre) coincida con el campo esperado antes de escribir en la columna F.
Pestaña Bootstrap (Accelerator - Bootstrap)
| Fila | Celda | Campo (col B) | Config Setting (col D) |
|---|---|---|---|
| 4 | F4 | Infraestructura como Código | iac_type |
| 5 | F5 | Sistema de control de versiones | bootstrap_module_name |
| 6 | F6 | Módulo inicial | starter_module_name |
| 8 | F8 | Región de recursos de bootstrap | bootstrap_location |
| 9 | F9 | Id del grupo de administración raíz | root_parent_management_group_id |
| 10 | F10 | Id de suscripción de administración | subscription_id_management |
| 11 | F11 | Id de suscripción de conectividad | subscription_id_connectivity |
| 12 | F12 | Id de suscripción de identidad | subscription_id_identity |
| 13 | F13 | Id de suscripción de seguridad | subscription_id_identity (nota: error tipográfico de la plantilla) |
| 15 | F15 | Id de suscripción de bootstrap | bootstrap_subscription_id |
| 16 | F16 | Nomenclatura de recursos: nombre del servicio | service_name |
| 17 | F17 | Nomenclatura de recursos: nombre del entorno | environment_name |
| 18 | F18 | Nomenclatura de recursos: número de sufijo | postfix_number |
| 21 | F21 | Usar repositorio separado para plantillas | use_separate_repository_for_templates |
| 22 | F22 | Usar redes privadas | use_private_networking |
| 23 | F23 | Permitir acceso de almacenamiento desde mi IP | allow_storage_access_from_my_ip |
| 24 | F24 | Aprobadores de aplicación | apply_approvers |
| 25 | F25 | Crear políticas de rama | create_branch_policies |
| 28 | F28 | PAT de Azure DevOps | azure_devops_personal_access_token |
| 29 | F29 | PAT del Agente de Azure DevOps | azure_devops_agents_personal_access_token |
| 30 | F30 | Organización de Azure DevOps | azure_devops_organization_name |
| 31 | F31 | URL heredada de Azure DevOps | azure_devops_use_organisation_legacy_url |
| 32 | F32 | Crear Proyecto de Azure DevOps | azure_devops_create_project |
| 33 | F33 | Proyecto de Azure DevOps | azure_devops_project_name |
| 34 | F34 | Usar agentes autoalojados | use_self_hosted_agents |
Nota: Las filas 7, 14, 19, 20, 26, 27, 35, 36, 41 están en blanco o son encabezados de sección — saltarlas.
Pestaña Bicep (Accelerator - Bicep) — Escenarios
| Fila | Celda | Escenario |
|---|---|---|
| 6 | F6 | Hub & Spoke multi-región + Azure Firewall |
| 7 | F7 | vWAN multi-región + Azure Firewall |
| 8 | F8 | Hub & Spoke multi-región + NVA |
| 9 | F9 | vWAN multi-región + NVA |
| 10 | F10 | Solo grupos de administración, políticas y administración |
| 11 | F11 | Hub & Spoke de una sola región + Azure Firewall |
| 12 | F12 | vWAN de una sola región + Azure Firewall |
| 13 | F13 | Hub & Spoke de una sola región + NVA |
| 14 | F14 | vWAN de una sola región + NVA |
Pestaña Bicep — Opciones (filas 17-30)
| Fila | Celda | Opción |
|---|---|---|
| 17 | F17 | Convención de nomenclatura de recursos |
| 18 | F18 | Nombres de grupos de administración personalizados |
| 19 | F19 | Implementar Plan de Protección DDOS |
| 20 | F20 | Implementar DNS Privado |
| 21 | F21 | Implementar Host Bastion |
| 22 | F22 | Implementar VPN Gateway |
| 23 | F23 | Implementar ExpressRoute Gateway |
| 24 | F24 | Implementar en más de 2 regiones |
| 25 | F25 | Direccionamiento IP |
| 26 | F26 | Cambiar modo de aplicación de una asignación de política |
| 27 | F27 | Eliminar una asignación de política |
| 28 | F28 | Desactivar Agente de Monitoreo de Azure |
| 29 | F29 | Desactivar Planes Defender |
| 30 | F30 | Seguridad Zero Trust |
Pestaña Terraform (Accelerator - Terraform)
Misma disposición de escenarios que Bicep (filas 6-14). Las opciones son las filas 17-32:
| Fila | Celda | Opción |
|---|---|---|
| 17 | F17 | Convención de nomenclatura de recursos |
| 18 | F18 | Nombres de grupos de administración personalizados |
| 19 | F19 | Implementar Plan de Protección DDOS |
| 20 | F20 | Implementar DNS Privado |
| 21 | F21 | Implementar Host Bastion |
| 22 | F22 | Implementar VPN Gateway |
| 23 | F23 | Implementar ExpressRoute Gateway |
| 24 | F24 | Implementar en más de 2 regiones |
| 25 | F25 | Direccionamiento IP |
| 26 | F26 | Cambiar modo de aplicación de una asignación de política |
| 27 | F27 | Eliminar una asignación de política |
| 28 | F28 | Desactivar Agente de Monitoreo de Azure |
| 29 | F29 | Implementar Alertas de Línea Base de Monitoreo de Azure (AMBA) |
| 30 | F30 | Desactivar Planes Defender |
| 31 | F31 | Seguridad Zero Trust |
| 32 | F32 | Zona de Aterrizaje Soberana |
Enfoque de validación: Antes de escribir cualquier valor, lee la celda B{fila} y verifica que coincida con el nombre de campo esperado. Si no coincide, escanea la hoja para encontrar la fila correcta. Esto previene la corrupción silenciosa de datos debido a diferencias de versiones de plantilla.
Formato de salida
El entregable final es un archivo .xlsx con:
- Las tres pestañas preservadas de la plantilla original
- Columna F llena con los valores elegidos
- Comentarios en celdas con la justificación y referencias de mejores prácticas
- Codificación por colores: verde (confirmado), amarillo (necesita acción), amarillo claro (valores por defecto a revisar)
- Un resumen claro en la conversación listando todas las decisiones y elementos señalados
Advertencias
- Los índices de fila de openpyxl se basan en 1 — errores fuera por uno corrompen la fila incorrecta en silencio; verifica con
cell.valueantes de confirmar. - La coincidencia de expresiones regulares de suscripciones falla en nombres no estándar (ej.,
sub-xyz-platform-mgmt) — recurre a la enumeración cuando el patrón falle. - Consideraciones entre regiones: El emparejamiento de VNet entre regiones incurre en costos de tráfico de salida; la plantilla de ALZ por defecto no lo considera.
- Casillas de verificación en Excel vs valores de celda: openpyxl no puede escribir el estado de una casilla de verificación — usa el valor de celda "✓" + un rango con nombre para indicar "marcado".
- Propagación de cuota de suscripción: Los aumentos de cuota solicitados aparecen como "Aprobados" antes de que la cuota se aplique realmente — verifica con
az vm list-usage.