bicep-what-if-analysis

name	bicep-what-if-analysis
description	azd up/azd provisionの影響分析、Bicep what-if実行とノイズフィルタリング。インフラ変更・デプロイ前の影響確認時に使用。

Bicep What-If 分析

インフラ変更前の影響範囲確認とノイズフィルタリングを支援します。

⚠️ このスキルを使うべき状況

以下のいずれかに該当する場合、必ずこのスキルを呼び出してください：

ユーザーの質問・依頼	理由
「azd up の影響は？」「azd provision で何が変わる？」	実際のAzure環境との差分が必要
「このBicep変更の影響を教えて」	静的分析では不十分、what-ifが必要
「デプロイしても大丈夫？」「破壊的変更はある？」	リスク評価にwhat-if結果が必須
「インフラの変更点を確認したい」	現在の状態との比較が必要

静的コード分析（Bicepファイルを読むだけ）では不十分です。 What-if は Azure Resource Manager API を呼び出し、現在デプロイ済みの状態との実際の差分を取得します。

クイックスタート

# フィルタ済みwhat-if分析（推奨）
./.github/skills/bicep-what-if-analysis/scripts/whatif-analyze.sh

# 生出力が必要な場合
./.github/skills/bicep-what-if-analysis/scripts/whatif-analyze.sh --raw

# 破壊的変更のみ抽出
./.github/skills/bicep-what-if-analysis/scripts/whatif-analyze.sh | jq 'select(.changeType == "Delete")'

前提条件

• azd envが初期化済み（AZURE_LOCATION等が設定済み）
• Azure CLIでログイン済み

ノイズ判定基準

無視して良い変更

リソース	プロパティ	理由
全リソース	provisioningState	読み取り専用
全リソース	etag	常に変化
全リソース	resourceGuid, uniqueId	動的生成
AKS	currentOrchestratorVersion	読み取り専用
AKS	nodeImageVersion	読み取り専用
AKS	fqdn, azurePortalFQDN	動的生成
AKS	powerState.code	読み取り専用
AKS	identityProfile.*	動的生成
Managed Identity	principalId, clientId, tenantId	読み取り専用

要注意の変更（破壊的変更の可能性）

以下が Modify で表示された場合はリソース再作成の可能性があります：

リソース	プロパティ	影響
AKS	networkProfile.networkPlugin	クラスター再作成
AKS	networkProfile.networkPluginMode	クラスター再作成
AKS	apiServerAccessProfile.subnetId	クラスター再作成
AKS	agentPoolProfiles[*].vnetSubnetID	ノードプール再作成
Redis	sku.name, sku.capacity	データロスの可能性
VNet	addressSpace.addressPrefixes	依存リソースへ影響

分析フロー

1. what-if実行
   ↓
2. 変更タイプで分類
   - NoChange / NoEffect / Ignore → 無視
   - Create / Delete / Modify → 詳細確認
   ↓
3. Modifyの詳細確認
   - ノイズリストに該当 → 無視
   - 破壊的変更リストに該当 → 要注意
   - それ以外 → 意図した変更か確認

変更タイプの意味

タイプ	説明	対応
Create	新規作成	設定内容を確認
Delete	削除	意図した削除か確認
Modify	変更あり	破壊的変更か確認
NoChange	変更なし	無視
NoEffect	影響なし（読み取り専用等）	無視
Ignore	評価対象外	通常は無視

トラブルシューティング

"AZURE_LOCATION is not set" エラー

# azd環境を初期化
azd env refresh

what-ifが大量の変更を報告する

• APIバージョン更新後は多くの「変更」が報告されることがあります
• --rawオプションで生出力を確認し、実際の差分を確認してください

特定リソースの詳細を確認したい

# リソースIDでフィルタ
./.github/skills/bicep-what-if-analysis/scripts/whatif-analyze.sh | \
  jq 'select(.resourceId | contains("managedClusters"))'

このスキルを使わない場合

以下の場合は静的分析で十分です：

• 「Bicepファイルの構文を確認して」（リンター実行）
• 「このモジュールは何を作成する？」（コードリーディング）
• 「パラメータのデフォルト値は？」（ファイル参照）