Skill de Lista de Verificação do Azure Landing Zone
Esta skill guia você pelo preenchimento da lista de verificação do Microsoft Azure Landing Zone (ALZ) Accelerator — a planilha que captura todas as decisões necessárias antes de implantar um ALZ usando Bicep ou Terraform por meio da ferramenta ALZ Accelerator.
O objetivo é produzir uma lista de verificação Excel preenchida, onde cada decisão é justificada, as melhores práticas são aplicadas por padrão e os itens que exigem entrada humana são claramente sinalizados para atenção do usuário.
Por que isso é importante
A lista de verificação do ALZ Accelerator é a fonte única da verdade para uma implantação de landing zone de plataforma. Errar significa rede mal configurada, lacunas de segurança ou horas de retrabalho. Esta skill garante consistência aplicando as recomendações do Microsoft Cloud Adoption Framework (CAF) enquanto respeita a infraestrutura existente do usuário (faixas IP, assinaturas, convenções de nomenclatura).
Fluxo de Trabalho
Fase 1: Ler a lista de verificação
Leia a lista de verificação .xlsx enviada usando openpyxl para entender sua estrutura. As listas de verificação do ALZ normalmente têm três abas:
- Accelerator - Bootstrap: Tipo de IaC, VCS, assinaturas, nomenclatura, configurações de CI/CD
- Accelerator - Bicep: Seleção de cenário, alternância de componentes, endereçamento IP, políticas
- Accelerator - Terraform: Igual ao Bicep com opções adicionais (AMBA, Sovereign LZ)
Analise a lista de verificação para identificar quais campos já possuem valores (coluna F = "Valor Escolhido") e quais estão vazios. Isso informa o que o usuário já decidiu versus o que precisa de entrada.
Fase 2: Entrevistar o usuário
Reúna decisões por meio de perguntas estruturadas. Faça perguntas em lotes de 3-4 para não sobrecarregar o usuário. Priorize nesta ordem:
Lote 1 — Decisões fundamentais:
- Tipo de IaC (Bicep ou Terraform)
- Sistema de controle de versão (Azure DevOps, GitHub ou local)
- Cenário de topologia de rede (Hub & Spoke vs vWAN, região única vs múltiplas regiões, Azure Firewall vs NVA)
- Região do Azure
Lote 2 — Decisões de componentes:
- Quais componentes implantar (DDoS, DNS Privado, Bastion, VPN Gateway, ExpressRoute, Zero Trust)
- Postura de segurança (AMA, planos Defender)
Lote 3 — Detalhes específicos do ambiente:
- Nomes da organização e do projeto no Azure DevOps / GitHub
- IDs de assinatura (Gerenciamento, Conectividade, Identidade, Segurança)
- Aprovadores de pipeline
- Endereçamento IP (pergunte se eles têm documentação existente)
Quando o usuário disser "use as melhores práticas" ou adiar uma decisão, aplique as recomendações de references/alz-best-practices.md. Sempre explique por que uma recomendação é feita — usuários confiam em recomendações que entendem.
Fase 3: Mapear assinaturas
Se o usuário fornecer uma lista de assinaturas (de az account list ou similar), mapeie as assinaturas para funções ALZ combinando padrões de nomenclatura:
| Padrão | Função ALZ |
|---|---|
*mgmt*, *management* | Gerenciamento |
*connectivity*, *network*, *hub* | Conectividade |
*identity*, *ad*, *entra* | Identidade |
*security*, *sentinel*, *defender* | Segurança |
Se uma assinatura necessária estiver faltando (comumente Segurança), sinalize-a com um destaque amarelo e um comentário explicando as opções:
- Criar uma assinatura dedicada (recomendado)
- Compartilhar com a assinatura de Gerenciamento (alternativa com orçamento limitado)
Fase 4: Integrar endereçamento IP
Se o usuário fornecer documentação IP (Markdown, CSV, Excel ou texto), analise-a para extrair:
- Blocos CIDR no nível da assinatura — mapeie para VNets hub/spoke do ALZ
- Layout existente da VNet hub — identifique alocações de sub-rede (Gateway, Firewall, Bastion, serviços compartilhados)
- IPs públicos locais — inclua em comentários para referência de regras de VPN/firewall
- Rede AKS — CIDRs de pod/serviço, se aplicável
Para a VNet hub do ALZ, recomende este layout de sub-rede usando o bloco CIDR da assinatura de conectividade:
VNet Hub: <base-conectividade>/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)
Serviços Compartilhados: <base>.1.0/24 (254 hosts)
DNS Resolver de Entrada: <base>.2.0/28
DNS Resolver de Saída: <base>.2.16/28
Se nenhuma documentação IP for fornecida, use os padrões do ALZ e sinalize para revisão.
Fase 5: Preencher a lista de verificação
Use openpyxl para escrever valores na coluna F ("Valor Escolhido") das abas apropriadas. Aplique formatação consistente:
from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.comments import Comment
# Valores confirmados — fundo verde
preenchimento_verde = PatternFill('solid', fgColor='CCE5CC')
# Itens que precisam de ação do usuário — fundo amarelo + texto vermelho negrito
preenchimento_amarelo = PatternFill('solid', fgColor='FFFF00')
fonte_acao = Font(bold=True, color='FF0000', size=10)
# Notas informativas — itálico fundo amarelo
preenchimento_nota = PatternFill('solid', fgColor='FFFFCC')
fonte_nota = Font(italic=True, size=10)
Para cada célula que você preencher:
- Adicione um Comentário explicando a lógica ou referência de melhor prática
- Use preenchimento verde para decisões confirmadas
- Use preenchimento amarelo + texto vermelho para itens que exigem ação do usuário (ex.: "A DEFINIR", "A FORNECER")
- Use preenchimento amarelo claro + itálico para itens usando padrões que o usuário deve revisar
Lógica específica da aba:
Preencha apenas a aba que corresponde à escolha de IaC do usuário. Limpe a outra aba se ela tiver valores de uma tentativa anterior. Para a aba ativa:
- Seção Cenários: Defina o cenário escolhido como "Sim", todos os outros como "Não". Destaque o selecionado com um verde mais brilhante.
- Seção Opções: Aplique as escolhas de componente do usuário. Para qualquer opção não discutida explicitamente, aplique os padrões de melhores práticas e anote isso no comentário.
- Aba Bootstrap: Sempre preencha independentemente da escolha de IaC — ela é compartilhada.
Fase 6: Apresentar resultados
Depois de salvar a lista de verificação preenchida:
- Imprima uma tabela de resumo mostrando todos os valores preenchidos
- Liste os itens sinalizados para ação do usuário (destaques amarelos)
- Destaque quaisquer considerações arquitetônicas (por exemplo, peering entre regiões necessário se a região do ALZ for diferente da infraestrutura existente)
- Forneça o link do arquivo para download
Recomendações de melhores práticas
Leia references/alz-best-practices.md para o conjunto completo de recomendações. Os padrões principais a serem aplicados quando o usuário adiar:
- Rede privada: verdadeiro (o armazenamento de estado nunca deve ser acessível publicamente)
- Repositório de modelos de CI/CD separado: verdadeiro (limite de segurança entre código e definições de pipeline)
- Políticas de branch: verdadeiro (exigir PRs para todas as alterações)
- Agentes/runners auto-hospedados: verdadeiro (necessário para rede privada)
- Proteção DDoS: Sim (proteção em nível de rede para todos os recursos da VNet)
- Zonas DNS Privado: Sim (necessário para Private Endpoints em hub-spoke)
- Azure Bastion: Sim (acesso seguro a VM sem exposição de IP público)
- AMA (Azure Monitoring Agent): Manter ativado (monitoramento centralizado)
- Planos Defender: Manter ativados (detecção de ameaças em todos os tipos de recurso)
- Zero Trust: Sim (acesso com privilégio mínimo e microssegmentação)
- Alertas AMBA (somente Terraform): Sim (monitoramento proativo de recursos da plataforma)
- Sovereign Landing Zone: Não (a menos que explicitamente necessário para conformidade)
Considerações entre regiões
Se a infraestrutura existente do usuário estiver em uma região diferente da implantação do ALZ, sinalize isso no comentário da região na aba Bootstrap. Eles precisarão planejar o peering de VNet entre regiões entre o hub do ALZ e qualquer topologia hub-spoke existente.
Mapa de Referência de Células
A lista de verificação possui uma estrutura fixa. Use estas referências de célula exatas ao escrever valores para evitar bugs de deslocamento de linha. Sempre verifique se a coluna B (Nome) corresponde ao campo esperado antes de escrever na coluna F.
Aba Bootstrap (Accelerator - Bootstrap)
| Linha | Célula | Campo (col B) | Configuração (col D) |
|---|---|---|---|
| 4 | F4 | Infrastructure as Code | iac_type |
| 5 | F5 | Version control system | bootstrap_module_name |
| 6 | F6 | Starter module | starter_module_name |
| 8 | F8 | Bootstrap resource region | bootstrap_location |
| 9 | F9 | Parent management group id | root_parent_management_group_id |
| 10 | F10 | Management subscription id | subscription_id_management |
| 11 | F11 | Connectivity subscription id | subscription_id_connectivity |
| 12 | F12 | Identity subscription id | subscription_id_identity |
| 13 | F13 | Security subscription id | subscription_id_security |
| 15 | F15 | Bootstrap subscription id | bootstrap_subscription_id |
| 16 | F16 | Resource naming: service name | service_name |
| 17 | F17 | Resource naming: environment name | environment_name |
| 18 | F18 | Resource naming: postfix number | postfix_number |
| 21 | F21 | Use separate repository for templates | use_separate_repository_for_templates |
| 22 | F22 | Use private networking | use_private_networking |
| 23 | F23 | Allow storage access from my IP | allow_storage_access_from_my_ip |
| 24 | F24 | Apply approvers | apply_approvers |
| 25 | F25 | Create branch policies | create_branch_policies |
| 28 | F28 | Azure DevOps PAT | azure_devops_personal_access_token |
| 29 | F29 | Azure DevOps Agent PAT | azure_devops_agents_personal_access_token |
| 30 | F30 | Azure DevOps Organization | azure_devops_organization_name |
| 31 | F31 | Azure DevOps legacy url | azure_devops_use_organisation_legacy_url |
| 32 | F32 | Create Azure DevOps Project | azure_devops_create_project |
| 33 | F33 | Azure DevOps Project | azure_devops_project_name |
| 34 | F34 | Use self hosted agents | use_self_hosted_agents |
Nota: As linhas 7, 14, 19, 20, 26, 27, 35, 36, 41 estão em branco ou são cabeçalhos de seção — pule-as.
Aba Bicep (Accelerator - Bicep) — Cenários
| Linha | Célula | Cenário |
|---|---|---|
| 6 | F6 | Multi-Region Hub & Spoke + Azure Firewall |
| 7 | F7 | Multi-Region vWAN + Azure Firewall |
| 8 | F8 | Multi-Region Hub & Spoke + NVA |
| 9 | F9 | Multi-Region vWAN + NVA |
| 10 | F10 | Management Groups, Policy and Management Only |
| 11 | F11 | Single-Region Hub & Spoke + Azure Firewall |
| 12 | F12 | Single-Region vWAN + Azure Firewall |
| 13 | F13 | Single-Region Hub & Spoke + NVA |
| 14 | F14 | Single-Region vWAN + NVA |
Aba Bicep — Opções (linhas 17-30)
| Linha | Célula | Opção |
|---|---|---|
| 17 | F17 | Resource naming convention |
| 18 | F18 | Custom management group names |
| 19 | F19 | Deploy DDOS Protection Plan |
| 20 | F20 | Deploy Private DNS |
| 21 | F21 | Deploy Bastion Host |
| 22 | F22 | Deploy VPN Gateway |
| 23 | F23 | Deploy ExpressRoute Gateway |
| 24 | F24 | Deploy to more than 2 regions |
| 25 | F25 | IP Addressing |
| 26 | F26 | Change a policy assignment enforcement mode |
| 27 | F27 | Remove a policy assignment |
| 28 | F28 | Turn off Azure Monitoring Agent |
| 29 | F29 | Turn off Defender Plans |
| 30 | F30 | Zero Trust Security |
Aba Terraform (Accelerator - Terraform)
Mesmo layout de cenário do Bicep (linhas 6-14). As opções são linhas 17-32:
| Linha | Célula | Opção |
|---|---|---|
| 17 | F17 | Resource naming convention |
| 18 | F18 | Custom management group names |
| 19 | F19 | Deploy DDOS Protection Plan |
| 20 | F20 | Deploy Private DNS |
| 21 | F21 | Deploy Bastion Host |
| 22 | F22 | Deploy VPN Gateway |
| 23 | F23 | Deploy ExpressRoute Gateway |
| 24 | F24 | Deploy to more than 2 regions |
| 25 | F25 | IP Addressing |
| 26 | F26 | Change a policy assignment enforcement mode |
| 27 | F27 | Remove a policy assignment |
| 28 | F28 | Turn off Azure Monitoring Agent |
| 29 | F29 | Deploy Azure Monitoring Baseline Alerts (AMBA) |
| 30 | F30 | Turn off Defender Plans |
| 31 | F31 | Zero Trust Security |
| 32 | F32 | Sovereign Landing Zone |
Abordagem de validação: Antes de escrever qualquer valor, leia a célula B{linha} e verifique se corresponde ao nome do campo esperado. Se não corresponder, verifique a planilha para encontrar a linha correta. Isso evita corrupção silenciosa de dados devido a diferenças de versão do modelo.
Formato de saída
O resultado final é um arquivo .xlsx com:
- Todas as três abas preservadas do modelo original
- Coluna F preenchida com os valores escolhidos
- Comentários de célula com a lógica e referências de melhores práticas
- Codificação por cores: verde (confirmado), amarelo (precisa de ação), amarelo claro (padrões para revisar)
- Um resumo claro na conversa listando todas as decisões e itens sinalizados
Pegadinhas
- Os índices de linha do openpyxl são baseados em 1 — erros off-by-one corrompem a linha errada silenciosamente; verifique com a leitura de
cell.valueantes de confirmar. - A correspondência de regex de assinatura falha em nomenclatura não padrão (ex.:
sub-xyz-platform-mgmt) — recorra à enumeração quando o padrão falhar. - Considerações entre regiões: O peering de VNet entre regiões custa tráfego de saída; o modelo padrão do ALZ não precifica isso.
- Caixas de seleção do Excel vs. valores de célula: openpyxl não pode escrever estado de caixa de seleção — use valor de célula "✓" + intervalo nomeado para indicar marcado.
- Propagação de cota de assinatura: aumentos de cota solicitados aparecem como "Aprovado" antes de a cota ser realmente aplicada — verifique com
az vm list-usage.