Azure Landing Zone 체크리스트 스킬
이 스킬은 Microsoft Azure Landing Zone (ALZ) Accelerator 체크리스트 작성을 안내합니다. 이 체크리스트는 ALZ Accelerator 도구를 통해 Bicep 또는 Terraform을 사용한 ALZ 배포 전에 필요한 모든 결정 사항을 담은 스프레드시트입니다.
목표는 모든 결정 사항이 정당화되고, 기본적으로 모범 사례가 적용되며, 사용자 입력이 필요한 항목이 명확히 표시된 완성된 Excel 체크리스트를 생성하는 것입니다.
중요한 이유
ALZ Accelerator 체크리스트는 플랫폼 랜딩 존 배포의 단일 진실 공급원입니다. 잘못 작성하면 네트워킹 오구성, 보안 허점, 또는 수 시간의 재작업이 발생할 수 있습니다. 이 스킬은 사용자의 기존 인프라(IP 범위, 구독, 명명 규칙)를 존중하면서 Microsoft의 Cloud Adoption Framework (CAF) 권장 사항을 적용하여 일관성을 보장합니다.
워크플로우
1단계: 체크리스트 읽기
openpyxl을 사용하여 업로드된 .xlsx 체크리스트를 읽고 구조를 파악합니다. ALZ 체크리스트는 일반적으로 세 개의 탭으로 구성됩니다:
- Accelerator - Bootstrap: IaC 유형, VCS, 구독, 명명, CI/CD 설정
- Accelerator - Bicep: 시나리오 선택, 구성 요소 토글, IP 주소 지정, 정책
- Accelerator - Terraform: Bicep과 동일하며 추가 옵션(AMBA, Sovereign LZ) 포함
체크리스트를 파싱하여 이미 값이 있는 필드(열 F = "Chosen Value")와 비어 있는 필드를 식별합니다. 이를 통해 사용자가 이미 결정한 사항과 입력이 필요한 사항을 알 수 있습니다.
2단계: 사용자 인터뷰
구조화된 질문을 통해 결정 사항을 수집합니다. 사용자를 압도하지 않도록 3-4개 질문씩 배치로 묶어 질문합니다. 다음 순서로 우선순위를 지정합니다:
배치 1 — 기본 결정:
- IaC 유형 (Bicep 또는 Terraform)
- 버전 관리 시스템 (Azure DevOps, GitHub, 또는 로컬)
- 네트워크 토폴로지 시나리오 (허브 앤 스포크 vs vWAN, 단일 vs 다중 리전, Azure Firewall vs NVA)
- Azure 리전
배치 2 — 구성 요소 결정:
- 배포할 구성 요소 (DDoS, Private DNS, Bastion, VPN Gateway, ExpressRoute, Zero Trust)
- 보안 태세 (AMA, Defender 플랜)
배치 3 — 환경별 세부 사항:
- Azure DevOps / GitHub 조직 및 프로젝트 이름
- 구독 ID (관리, 연결, ID, 보안)
- 파이프라인 승인자
- IP 주소 지정 (기존 문서가 있는지 질문)
사용자가 "모범 사례 사용"이라고 말하거나 결정을 미루면 references/alz-best-practices.md의 권장 사항을 적용합니다. 권장 사항이 만들어진 이유를 항상 설명하세요. 사용자는 이해하는 권장 사항을 신뢰합니다.
3단계: 구독 매핑
사용자가 (az account list 등에서) 구독 목록을 제공하면 명명 패턴 일치를 통해 구독을 ALZ 역할에 매핑합니다:
| 패턴 | ALZ 역할 |
|---|---|
*mgmt*, *management* | 관리 (Management) |
*connectivity*, *network*, *hub* | 연결 (Connectivity) |
*identity*, *ad*, *entra* | ID (Identity) |
*security*, *sentinel*, *defender* | 보안 (Security) |
필수 구독(일반적으로 보안)이 누락된 경우 노란색 강조 표시와 옵션을 설명하는 주석을 추가합니다:
- 전용 구독 생성 (권장)
- 관리 구독과 공유 (예산 제약 대안)
4단계: IP 주소 지정 통합
사용자가 IP 문서(마크다운, CSV, Excel, 또는 텍스트)를 제공하면 파싱하여 다음을 추출합니다:
- 구독 수준 CIDR 블록 — ALZ 허브/스포크 VNet에 매핑
- 기존 허브 VNet 레이아웃 — 서브넷 할당 식별 (Gateway, Firewall, Bastion, 공유 서비스)
- 온프레미스 공용 IP — VPN/방화벽 규칙 참조용 주석에 포함
- AKS 네트워킹 — 해당하는 경우 파드/서비스 CIDR
ALZ 허브 VNet의 경우 연결 구독의 CIDR 블록을 사용하여 다음 서브넷 레이아웃을 권장합니다:
허브 VNet: <connectivity-base>/16
GatewaySubnet: <base>.0.0/27 (30개 호스트)
AzureFirewallSubnet: <base>.0.64/26 (62개 호스트)
AzureFirewallManagementSubnet:<base>.0.128/26 (62개 호스트)
AzureBastionSubnet: <base>.0.192/26 (62개 호스트)
공유 서비스: <base>.1.0/24 (254개 호스트)
DNS Resolver 인바운드: <base>.2.0/28
DNS Resolver 아웃바운드: <base>.2.16/28
IP 문서가 제공되지 않으면 ALZ 기본값을 사용하고 검토 플래그를 지정합니다.
5단계: 체크리스트 채우기
openpyxl을 사용하여 적절한 탭의 열 F ("Chosen Value")에 값을 씁니다. 일관된 서식을 적용합니다:
from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.comments import Comment
# 확인된 값 — 녹색 배경
green_fill = PatternFill('solid', fgColor='CCE5CC')
# 사용자 작업이 필요한 항목 — 노란색 배경 + 빨간색 굵은 텍스트
yellow_fill = PatternFill('solid', fgColor='FFFF00')
action_font = Font(bold=True, color='FF0000', size=10)
# 정보 제공 참고 — 기울임꼴 노란색 배경
note_fill = PatternFill('solid', fgColor='FFFFCC')
note_font = Font(italic=True, size=10)
채우는 모든 셀에 대해:
- 근거 또는 모범 사례 참조를 설명하는 주석을 추가합니다.
- 확인된 결정에는 녹색 채우기를 사용합니다.
- 사용자 작업이 필요한 항목(예: "TO BE DEFINED", "TO BE PROVIDED")에는 노란색 채우기 + 빨간색 텍스트를 사용합니다.
- 사용자가 검토해야 하는 기본값을 사용하는 항목에는 연한 노란색 채우기 + 기울임꼴을 사용합니다.
탭별 논리:
사용자의 IaC 선택과 일치하는 탭만 채웁니다. 이전 시도에서 값이 있었던 다른 탭은 지웁니다. 활성 탭의 경우:
- 시나리오 섹션: 선택한 시나리오를 "Yes"로 설정하고 다른 모든 시나리오는 "No"로 설정합니다. 선택한 시나리오를 더 밝은 녹색으로 강조 표시합니다.
- 옵션 섹션: 사용자의 구성 요소 선택을 적용합니다. 명시적으로 논의되지 않은 옵션에 대해서는 모범 사례 기본값을 적용하고 주석에 이를 명시합니다.
- Bootstrap 탭: IaC 선택과 관계없이 항상 채웁니다. 공유 탭입니다.
6단계: 결과 표시
채워진 체크리스트를 저장한 후:
- 채워진 모든 값을 보여주는 요약 테이블을 출력합니다.
- 사용자 작업 플래그가 지정된 항목(노란색 강조 표시)을 나열합니다.
- 아키텍처 고려 사항(예: ALZ 리전이 기존 인프라와 다른 경우 교차 리전 피어링 필요)을 언급합니다.
- 다운로드용 파일 링크를 제공합니다.
모범 사례 권장 사항
references/alz-best-practices.md에서 전체 권장 사항 집합을 읽으세요. 사용자가 결정을 미룰 때 적용할 핵심 기본값은 다음과 같습니다:
- Private networking: true (상태 저장소는 절대 공개적으로 액세스할 수 없어야 함)
- 별도 CI/CD 템플릿 리포지토리: true (코드와 파이프라인 정의 사이의 보안 경계)
- 브랜치 정책: true (모든 변경 사항에 대해 PR 필요)
- 자체 호스팅 에이전트/러너: true (Private networking에 필요)
- DDoS Protection: 예 (모든 VNet 리소스에 대한 네트워크 계층 보호)
- Private DNS Zones: 예 (허브-스포크 전반의 Private Endpoints에 필요)
- Azure Bastion: 예 (공용 IP 노출 없는 안전한 VM 액세스)
- AMA (Azure Monitoring Agent): 활성화 유지 (중앙 집중식 모니터링)
- Defender 계획: 활성화 유지 (모든 리소스 유형에 대한 위협 탐지)
- Zero Trust: 예 (최소 권한 액세스 및 마이크로 세분화)
- AMBA 알림 (Terraform만 해당): 예 (플랫폼 리소스의 사전 예방적 모니터링)
- Sovereign Landing Zone: 아니요 (규정 준수를 위해 명시적으로 요구되지 않는 한)
교차 리전 고려 사항
사용자의 기존 인프라가 ALZ 배포와 다른 리전에 있는 경우 Bootstrap 탭의 리전 주석에 플래그를 지정합니다. ALZ 허브와 기존 허브-스포크 토폴로지 간의 교차 리전 VNet 피어링을 계획해야 합니다.
셀 참조 맵
체크리스트는 고정된 구조를 가지고 있습니다. 값 쓰기 시 행 오프셋 버그를 방지하려면 이 정확한 셀 참조를 사용하세요. 열 F에 쓰기 전에 항상 열 B(이름)가 예상 필드와 일치하는지 확인합니다.
Bootstrap 탭 (Accelerator - Bootstrap)
| 행 | 셀 | 필드 (col B) | 구성 설정 (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_identity (참고: 템플릿 오타) |
| 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 |
참고: 7, 14, 19, 20, 26, 27, 35, 36, 41행은 비어 있거나 섹션 헤더입니다. 건너뛰세요.
Bicep 탭 (Accelerator - Bicep) — 시나리오
| 행 | 셀 | 시나리오 |
|---|---|---|
| 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 |
Bicep 탭 — 옵션 (17-30행)
| 행 | 셀 | 옵션 |
|---|---|---|
| 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 |
Terraform 탭 (Accelerator - Terraform)
Bicep과 동일한 시나리오 레이아웃(6-14행). 옵션은 17-32행:
| 행 | 셀 | 옵션 |
|---|---|---|
| 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 |
유효성 검사 접근 방식: 값을 쓰기 전에 셀 B{row}를 읽고 예상 필드 이름과 일치하는지 확인합니다. 일치하지 않으면 시트를 스캔하여 올바른 행을 찾습니다. 이렇게 하면 템플릿 버전 차이로 인한 데이터 손상을 방지할 수 있습니다.
출력 형식
최종 산출물은 다음을 포함하는 .xlsx 파일입니다:
- 원본 템플릿의 세 탭이 모두 유지됨
- 선택된 값으로 채워진 열 F
- 근거 및 모범 사례 참조가 포함된 셀 주석
- 색상 코딩: 녹색(확인됨), 노란색(작업 필요), 연한 노란색(검토할 기본값)
- 모든 결정 및 플래그가 지정된 항목을 나열하는 대화의 명확한 요약
주의 사항
- openpyxl 행 인덱스는 1부터 시작 — 1차이 오류는 조용히 잘못된 행을 손상시킵니다. 커밋 전에
cell.value읽기-되돌리기로 확인합니다. - 구독 정규식 일치는 비표준 명명에서 실패(예:
sub-xyz-platform-mgmt) — 패턴이 실패하면 열거로 대체합니다. - 교차 리전 고려 사항: 리전 간 VNet 피어링은 송신 트래픽 비용이 발생합니다. 기본 ALZ 템플릿은 이 비용을 계산하지 않습니다.
- Excel 확인란과 셀 값: openpyxl은 확인란 상태를 쓸 수 없습니다. 확인된 것을 나타내려면 셀 값 "✓" + 명명된 범위를 사용합니다.
- 구독 할당량 전파: 요청된 할당량 증가는 할당량이 실제로 적용되기 전에 "승인됨"으로 표시됩니다.
az vm list-usage로 확인합니다.