Azure Bicep チュートリアル｜ARM 後継 IaC の基本構文・モジュール化・What-If・CI/CD 統合

Bicep は Azure Resource Manager (ARM) テンプレートの後継として Microsoft が開発した宣言的 IaC DSL です。 2021 年 GA で、Microsoft Azure 公式の推奨 IaC ツールとして急速に普及。 本記事では、Bicep の基本構文・モジュール化・What-If デプロイ・CI/CD 統合・ARM からの移行手順を網羅的に整理します。

なぜ Bicep か

Bicep の主な利点:

• ARM JSON より大幅に簡潔・可読性が高い構文
• IntelliSense・型チェック (VS Code 拡張機能)
• モジュール化対応 (大規模 IaC に最適)
• 最新 Azure 機能を即時サポート (Preview 機能含む)
• State 管理不要 (ARM が自動管理)
• 無料
• ARM JSON への自動トランスパイル (Bicep → ARM JSON 自動変換)

2026 年現在の Azure 新規プロジェクトでは Bicep がデファクトスタンダードで、ARM JSON は新規利用なし・既存保守用途のみです。

基本構文

Bicep は宣言的構文で、主要要素は以下の通り。

• param: パラメータ宣言・型・デフォルト値・許容値
• var: 変数・計算式
• resource: Azure リソース定義・apiVersion 指定
• module: 子テンプレートの呼び出し・再利用
• output: 出力値・他テンプレートへの引き渡し
• targetScope: subscription / managementGroup / tenant の階層指定

シンプルな Storage Account の例

param storageAccountName string
param location string = resourceGroup().location

resource storage 'Microsoft.Storage/storageAccounts@2023-01-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: false
    minimumTlsVersion: 'TLS1_2'
  }
}

output storageId string = storage.id
output storageEndpoint string = storage.properties.primaryEndpoints.blob

型システム

Bicep は型システムを持ち、明示的に指定します。

• string: 文字列
• int: 整数
• bool: 真偽値
• array: 配列
• object: オブジェクト
• カスタム型 (2024 新): type myType = { name: string, age: int }

モジュール化

大規模 IaC は必ずモジュール化します。

推奨ディレクトリ構造

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

モジュール呼び出しの例

module network 'modules/network.bicep' = {
  name: 'networkDeploy'
  params: {
    vnetName: vnetName
    addressPrefix: '10.0.0.0/16'
    location: location
  }
}

module compute 'modules/compute.bicep' = {
  name: 'computeDeploy'
  params: {
    vmName: vmName
    subnetId: network.outputs.appSubnetId
  }
  dependsOn: [
    network
  ]
}

条件付きデプロイとループ

Conditional Deployment

param environment string

resource backup 'Microsoft.RecoveryServices/vaults@2023-01-01' = if (environment == 'prod') {
  name: 'rsv-prod'
  location: location
  sku: { name: 'Standard' }
}

Loops (for 反復)

param storageAccountNames array = [
  'stgapp001'
  'stgapp002'
  'stgapp003'
]

resource storageAccounts 'Microsoft.Storage/storageAccounts@2023-01-01' = [for name in storageAccountNames: {
  name: name
  location: location
  sku: { name: 'Standard_LRS' }
  kind: 'StorageV2'
}]

What-If デプロイ

What-If デプロイは、Bicep / ARM テンプレートを実際にデプロイする前に『何が変更されるか』を予測表示する機能。本番デプロイ前の必須ステップです。

コマンド

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 vs Terraform

CI/CD 統合

GitHub Actions パターン

name: Deploy Bicep
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: azure/login@v2
        with:
          client-id: ${{ secrets.AZURE_CLIENT_ID }}
          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
      - name: What-If
        uses: azure/CLI@v2
        with:
          inlineScript: |
            az deployment group what-if \
              --resource-group myRG \
              --template-file infra/main.bicep
      - name: Deploy
        uses: azure/arm-deploy@v2
        with:
          resourceGroupName: myRG
          template: infra/main.bicep
          parameters: infra/main.parameters.json

標準パターンの段階構成: Lint → Build → What-If → Manual Approval (Production) → Deploy。詳細は Azure Pipelines YAML 完全ガイド を参照。

ARM テンプレートからの移行

既存 ARM JSON → Bicep への自動変換ツール:

az bicep decompile --file template.json

これで ARM JSON が Bicep ファイルに自動変換されます。ただし完全変換ではなく、手動調整が必要なケース:

• 複雑な式・関数の Bicep 構文への変換
• Conditional / Loop の構文最適化
• Module 化されていないテンプレートのモジュール分割
• Public Registry または社内 Registry への公開

現実的な移行戦略: 新規 = Bicep、既存 = 必要に応じて Bicep 化、というハイブリッドアプローチが推奨。 Microsoft 自身も既存 ARM テンプレートの利用継続を許容しており、無理な一括移行は不要です。

ベストプラクティス

1. 必ずモジュール化 (機能別に modules/ ディレクトリ)
2. 環境別 parameters (dev.parameters.json・prod.parameters.json)
3. What-If を本番デプロイ前に必ず実行
4. az bicep lint で静的解析
5. Workload Identity Federation で CI/CD 認証 (Secret 不要)
6. Resource 名は命名規則に従う (CAF: Cloud Adoption Framework 推奨パターン)
7. Tag 付与 (Environment・Owner・CostCenter・Project)
8. 機密パラメータは Key Vault 参照 (@secure() デコレーター)
9. AVM (Azure Verified Modules) を活用 (Microsoft 公式 verified モジュール)
10. Bicep Visualizer で依存関係可視化 (VS Code 拡張機能)

関連認定試験

• AZ-104 (Administrator): Bicep / ARM 基礎。
• AZ-204 (Developer Associate): 開発者視点での IaC 活用。
• AZ-400 (DevOps Engineer Expert): ドメイン 3 で CI/CD パイプライン内 Bicep 統合 (配点最大)。
• AZ-305 (Solutions Architect Expert): アーキテクト視点での IaC 戦略。
• AZ-120 (SAP on Azure): ACSS の Bicep 自動デプロイ。

よくある質問

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