Azure ランディングゾーン(ALZ)チェックリストスキル
このスキルは、Microsoft Azure ランディングゾーン(ALZ)アクセラレータのチェックリスト、つまり Bicep または Terraform を使用した ALZ デプロイメントに先立って必要なすべての決定事項を記録するスプレッドシートの記入をガイドします。
目標は、すべての決定に正当な理由が付けられ、ベストプラクティスがデフォルトで適用され、人間の入力が必要な項目が明確にフラグ付けされた、完成した Excel チェックリストを生成することです。
なぜこれが重要なのか
ALZ アクセラレータのチェックリストは、プラットフォームランディングゾーンのデプロイメントにおける唯一の信頼できる情報源です。これを間違えると、ネットワークの設定ミス、セキュリティのギャップ、または何時間もの手戻りが発生します。このスキルは、Microsoft の Cloud Adoption Framework(CAF)の推奨事項を適用しつつ、ユーザーの既存インフラストラクチャ(IP 範囲、サブスクリプション、命名規則)を尊重することで、一貫性を確保します。
ワークフロー
フェーズ 1: チェックリストを読み取る
アップロードされた .xlsx チェックリストを openpyxl を使用して読み取り、その構造を理解します。ALZ チェックリストには通常、次の 3 つのタブがあります。
- 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* | 管理 |
*connectivity*, *network*, *hub* | 接続 |
*identity*, *ad*, *entra* | ID |
*security*, *sentinel*, *defender* | セキュリティ |
必要なサブスクリプションが欠けている場合(一般的にはセキュリティ)、黄色のハイライトと選択肢を説明するコメントでフラグを付けます。
- 専用サブスクリプションを作成する(推奨)
- 管理サブスクリプションと共有する(予算が限られている場合の代替案)
フェーズ 4: IP アドレス指定を統合する
ユーザーが IP ドキュメント(Markdown、CSV、Excel、またはテキスト)を提供した場合は、それを解析して以下を抽出します。
- サブスクリプションレベルの CIDR ブロック — ALZ ハブ/スポーク VNet にマッピング
- 既存のハブ VNet レイアウト — サブネット割り当て(Gateway、Firewall、Bastion、共有サービス)を特定
- オンプレミスのパブリック IP — VPN/ファイアウォールルールの参照用にコメントに含める
- AKS ネットワーキング — 該当する場合はポッド/サービス CIDR
ALZ ハブ VNet については、接続サブスクリプションの CIDR ブロックを使用して、次のサブネットレイアウトを推奨します。
ハブ VNet: <接続ベース>/16
GatewaySubnet: <ベース>.0.0/27 (30 ホスト)
AzureFirewallSubnet: <ベース>.0.64/26 (62 ホスト)
AzureFirewallManagementSubnet:<ベース>.0.128/26 (62 ホスト)
AzureBastionSubnet: <ベース>.0.192/26 (62 ホスト)
共有サービス: <ベース>.1.0/24 (254 ホスト)
DNS リゾルバー受信: <ベース>.2.0/28
DNS リゾルバー送信: <ベース>.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)
記入するすべてのセルについて:
- 根拠またはベストプラクティスの参照を説明するコメントを追加します
- 確定した決定には緑の塗りつぶしを使用します
- ユーザーのアクションが必要な項目には黄色の塗りつぶし + 赤いテキストを使用します(例:「未定義」、「要提供」)
- ユーザーが確認すべきデフォルトを使用する項目には、薄い黄色の塗りつぶし + 斜体を使用します
タブ固有のロジック:
ユーザーの IaC 選択に一致するタブのみを記入します。以前の試行で値があった場合は、もう一方のタブをクリアします。アクティブなタブについては、次のようにします。
- シナリオセクション: 選択したシナリオを「Yes」に設定し、他のすべてを「No」に設定します。選択したものをより明るい緑で強調表示します。
- オプションセクション: ユーザーのコンポーネント選択を適用します。明示的に議論されていないオプションについては、ベストプラクティスのデフォルトを適用し、その旨をコメントに記載します。
- Bootstrap タブ: IaC の選択に関係なく常に記入します。これは共有タブです。
フェーズ 6: 結果を提示する
記入済みのチェックリストを保存した後、次のようにします。
- 記入されたすべての値を示すサマリーテーブルを表示します
- ユーザーのアクションがフラグ付けされた項目(黄色のハイライト)を一覧表示します
- アーキテクチャ上の考慮事項があれば指摘します(例:ALZ リージョンが既存のインフラストラクチャと異なる場合、クロスリージョンピアリングが必要)
- ダウンロード用のファイルリンクを提供します
ベストプラクティスの推奨事項
完全な推奨事項セットについては、references/alz-best-practices.md を参照してください。ユーザーが先送りした場合に適用する主要なデフォルトは次のとおりです。
- プライベートネットワーキング: true(ストレージは決して公開アクセス可能にしてはなりません)
- 個別の CI/CD テンプレートリポジトリ: true(コードとパイプライン定義間のセキュリティ境界)
- ブランチポリシー: true(すべての変更に PR を要求)
- セルフホステッドエージェント/ランナー: true(プライベートネットワーキングに必要)
- DDoS 保護: Yes(すべての VNet リソースのネットワーク層保護)
- プライベート DNS ゾーン: Yes(ハブ&スポーク全体でプライベートエンドポイントに必要)
- Azure Bastion: Yes(パブリック IP 公開なしで安全な VM アクセス)
- AMA(Azure Monitoring Agent): 有効のまま(集中監視)
- Defender プラン: 有効のまま(すべてのリソースタイプに対する脅威検出)
- ゼロトラスト: Yes(最小特権アクセスとマイクロセグメンテーション)
- AMBA アラート(Terraform のみ): Yes(プラットフォームリソースのプロアクティブな監視)
- Sovereign ランディングゾーン: No(コンプライアンスのために明示的に要求された場合を除く)
クロスリージョンに関する考慮事項
ユーザーの既存インフラストラクチャが ALZ デプロイメントとは異なるリージョンにある場合、Bootstrap タブのリージョンコメントにその旨をフラグ付けします。ALZ ハブと既存のハブ&スポークトポロジ間のクロスリージョン VNet ピアリングを計画する必要があります。
セル参照マップ
チェックリストは固定構造を持っています。行オフセットのバグを避けるために、値を書き込む際にはこれらの正確なセル参照を使用してください。列 F に書き込む前に、列 B(名前)が期待されるフィールドと一致することを必ず確認してください。
Bootstrap タブ(Accelerator - Bootstrap)
| 行 | セル | フィールド(列 B) | 設定(列 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 ファイルであり、次の内容を含みます。
- 元のテンプレートからすべての 3 つのタブが保存されている
- 列 F に選択された値が入力されている
- 根拠とベストプラクティスの参照を含むセルコメント
- 色分け: 緑(確定)、黄(アクションが必要)、薄黄(確認すべきデフォルト)
- すべての決定事項とフラグ付けされた項目を記載した明確なサマリーが会話内に表示される
注意点
- openpyxl の行インデックスは 1 から始まる — 1 つずれると、間違った行が静かに破損します。コミットする前に
cell.valueの読み戻しで確認してください。 - サブスクリプションの正規表現マッチングは標準的でない命名では失敗する(例:
sub-xyz-platform-mgmt)— パターンが失敗した場合は列挙にフォールバックします。 - クロスリージョンの考慮事項: リージョン間の VNet ピアリングはエグレス料金がかかります。デフォルトの ALZ テンプレートはこれを価格に含んでいません。
- Excel のチェックボックスとセル値: openpyxl はチェックボックスの状態を書き込めません — チェックを示すにはセル値「✓」+ 名前付き範囲を使用します。
- サブスクリプションクォータの伝播: 要求されたクォータの増加は、実際にクォータが適用される前に「承認済み」と表示されます —
az vm list-usageで確認してください。