ARM テンプレート → Bicep 移行ガイド｜decompile・手動調整・段階的移行・What-If 検証

Microsoft Azure の伝統的な IaC である ARM テンプレートから後継の Bicep への移行は、新規プロジェクトでは既にデファクトスタンダードとなっています。 本記事では、既存 ARM 資産を Bicep へ段階的に移行する実践的なガイドを、az bicep decompile の活用・手動調整・段階的移行ロードマップ・What-If 検証の観点から整理します。

なぜ Bicep に移行するのか

Microsoft 公式の Azure 推奨 IaC ツールとして位置付けられ、新規プロジェクトは Bicep 一択。既存 ARM 資産も段階的な移行が推奨される (一括移行は不要)。

az bicep decompile の使い方

既存 ARM JSON を Bicep に自動変換するコマンド:

az bicep decompile --file template.json

出力は template.bicep ファイルとして保存されます。

変換後の確認手順

1. 警告メッセージ確認: BCP の警告 (複雑な式やカスタム関数の手動調整が必要)
2. 再トランスパイル比較: az bicep build で再度 ARM JSON に変換、元 ARM JSON と diff 比較 (一致すべき)
3. What-If 検証: az deployment group what-if で適用結果を確認、想定外の変更がないか検証

シンプルなテンプレートでも 80-90% は自動変換可能、残り 10-20% を手動調整するパターンが現実的です。

手動調整が必要なケース

Bicep decompile で完全自動化できない代表的なケース:

1. ARM の variables を Bicep の var に置き換え (式が複雑な場合は手動最適化)
2. Copy ループを Bicep の for にリファクタリング (より読みやすく)
3. Nested Template を Bicep Module に分解 (再利用性向上)
4. User-defined Function を Bicep の userDefinedFunction に置換 (Bicep 2024 で追加)
5. Symbolic Names の調整: ARM の resourceId 関数を Bicep の resource シンボル参照に置換
6. Conditional Resource を Bicep の if 構文に最適化
7. Output の型注釈追加

例: ARM の Copy ループ → Bicep の for

ARM (Before)

{
  "type": "Microsoft.Storage/storageAccounts",
  "apiVersion": "2023-01-01",
  "name": "[concat('stg', copyIndex())]",
  "copy": {
    "name": "storageLoop",
    "count": 3
  },
  ...
}

Bicep (After)

resource storage 'Microsoft.Storage/storageAccounts@2023-01-01' = [for i in range(0, 3): {
  name: 'stg${i}'
  ...
}]

段階的移行の推奨ステップ

Big Bang 移行 (一括変換) は推奨されない。段階的アプローチが標準。

Microsoft 自身も既存 ARM の継続利用を許容しており、無理な全面移行は不要。組織のスキル習熟・チームキャパシティに応じたペース設定が現実的。

Module 化のリファクタリング

ARM の Nested Template や Linked Template を Bicep Module にリファクタリング。

推奨ディレクトリ構造

infra/
├── main.bicep              # エントリポイント
├── main.parameters.json    # 環境別パラメータ
├── modules/
│   ├── network.bicep       # VNet / NSG / Subnet
│   ├── storage.bicep       # Storage Account
│   ├── compute.bicep       # VM / App Service / AKS
│   └── identity.bicep      # Managed Identity / Key Vault
└── README.md

主要技術

• Azure Verified Modules (AVM) ベースのカスタマイズ (Microsoft 公式 verified Module)
• 社内 Bicep Registry (Azure Container Registry) で Module 公開・バージョン管理
• Bicep 2024 の User-defined Types で型安全性向上
• Bicep Visualizer (VS Code 拡張機能) で依存関係可視化

What-If デプロイ検証

本番デプロイ前の What-If は必須レベル。Bicep 移行プロジェクトでは『元 ARM のデプロイ結果と新 Bicep のデプロイ結果が一致』を What-If で検証するのが最重要ステップ。

az deployment group what-if \
  --resource-group myRG \
  --template-file main.bicep \
  --parameters main.parameters.json

出力カテゴリ

• + Create: 新規作成
• - Delete: 削除
• ~ Modify: 変更 (差分表示)
• = NoChange: 変更なし
• * Deploy: デプロイのみ (Idempotent)

CI/CD パイプラインに What-If を組み込み、Pull Request レビューフェーズで自動実行する設計が現代的なベストプラクティス。

Bicep Linter

az bicep lint で Bicep コードの静的解析。

主要ルール

• no-hardcoded-location: location をハードコードせず Parameter 化
• no-unused-parameters / no-unused-variables: 未使用要素検出
• no-loc-expr-outside-params: location 式の Parameter 配置
• prefer-interpolation: string concat より string interpolation
• explicit-values-for-loc-params: Parameter デフォルト値明示
• protect-commandtoexecute-secrets: Secret の Command Line 露出防止

bicepconfig.json でプロジェクト固有ルールカスタマイズ可能。CI/CD パイプラインで Lint を実行、コード品質維持。 VS Code Bicep 拡張機能でリアルタイム Lint 表示、開発時に即座にフィードバック取得が可能です。

CI/CD パイプラインへの統合

Bicep 移行後の CI/CD パイプライン標準パターン:

1. Lint: az bicep lint
2. Build: az bicep build (ARM JSON 生成、Validation)
3. What-If: az deployment group what-if
4. Manual Approval (Production 環境)
5. Deploy: az deployment group create

詳細は Bicep チュートリアル の CI/CD 統合パターン参照。

移行ベストプラクティス

1. 段階的移行: 一括変換は避け、優先順位付け
2. 新規開発は Bicep 一択、既存 ARM は段階的
3. az bicep decompile で自動変換 → 手動調整
4. Symbolic Names・for ループ・Module 化でBicep らしい記述に最適化
5. What-If で変換結果を必ず検証
6. CI/CD パイプラインで Lint・Build・What-If 自動化
7. Azure Verified Modules (AVM) 活用
8. 社内 Bicep Registry で Module 集中管理
9. VS Code Bicep 拡張機能でリアルタイム開発支援
10. 定期的なチーム勉強会で Bicep スキル展開

関連認定試験

• AZ-400 (DevOps Engineer Expert): ドメイン 3 で CI/CD パイプライン内 Bicep 統合が深く問われる本領域の本命認定
• AZ-104 (Administrator): ドメイン 1 で Bicep / ARM 基礎
• AZ-204 (Developer Associate): 開発者視点での IaC
• AZ-305 (Solutions Architect Expert): アーキテクト視点での IaC 戦略選定

よくある質問

本記事の技術情報は Azure Bicep Documentation に基づいています。 本記事は Microsoft Corporation の公式商品ではなく、いかなる提携・後援関係もありません。 Microsoft、Azure は Microsoft group of companies の商標です。 情報は 2026 年 5 月 24 日時点の公式公開資料に基づきます。最新情報は必ず公式ページをご確認ください。