Azure Bicepの変数とパラメータ完全ガイド！再利用性の高いテンプレート設計のコツ

1. Azure Bicep（アジュール・バイセップ）とは？

1. Azure Bicep（アジュール・バイセップ）とは？

Azure Bicep（アジュール・バイセップ）とは、Microsoft Azure（アジュール）のリソースをコードで管理するための、ドメイン固有言語（DSL）です。従来はJSON形式のARMテンプレート（アジュール・リソース・マネージャー・テンプレート）が使われていましたが、人間にとって読み書きが難しかったため、より直感的でシンプルなBicepが登場しました。IaC（インフラストラクチャ・アズ・コード）を実現するための強力なツールであり、インフラの構築を自動化・標準化する際に欠かせない存在となっています。Bicepを学ぶことで、手動操作によるミスを減らし、同じ環境を何度でも正確に再現できるようになります。

2. パラメータ（Parameter）の基本と使い方

2. パラメータ（Parameter）の基本と使い方

パラメータ（Parameter）は、テンプレートの外部から値を渡すための仕組みです。プログラムにおける「引数」のようなもので、実行するたびに異なる値を設定したい場合に使用します。例えば、ストレージアカウントの名前や、仮想マシンのサイズ（スペック）などをパラメータ化することで、本番環境とテスト環境で設定を切り替えるといった柔軟な運用が可能になります。パラメータを定義するときは、paramというキーワードを使用します。型（文字列、数値、真偽値など）を明示する必要があり、必要に応じてデフォルト値を設定することもできます。

初心者がまず覚えるべきは、この「外から変えられるようにする」という感覚です。これにより、コードを書き換えずに、デプロイ時のコマンドだけで構成を変更できるようになります。

// パラメータの定義例：ストレージアカウント名を外部から指定
param storageAccountName string

// デフォルト値を設定する例
param location string = 'japaneast'

resource stg 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}

3. 変数（Variable）の役割とメリット

3. 変数（Variable）の役割とメリット

変数（Variable）は、テンプレートの内部だけで使用する値を保持するための仕組みです。パラメータとは異なり、デプロイ時に外部から値を変更することはできません。varというキーワードを使って定義します。変数の主な役割は、複雑な計算式や文字列の結合をあらかじめ行っておき、コードの可読性（読みやすさ）を高めることにあります。例えば、複数のパラメータを組み合わせて一意のリソース名を作成する場合や、リソースのSKU（価格ティア）を内部で固定しておきたい場合に便利です。

変数を活用することで、同じ計算式を何度も書く必要がなくなり、修正が必要な際も一箇所を直すだけで済むようになります。これをDRY（ドント・リピート・ユアセルフ）原則と呼び、効率的なテンプレート設計の基本となります。

param envName string = 'dev'
param appName string = 'myapp'

// 変数を使ってリソース名を自動生成
var uniqueStorageName = 'st${appName}${envName}${uniqueString(resourceGroup().id)}'

resource stg 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: uniqueStorageName
  location: 'japaneast'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}

4. パラメータと変数の使い分けのコツ

4. パラメータと変数の使い分けのコツ

初心者が悩むポイントが「これはパラメータにすべきか、変数にすべきか」という点です。判断基準は非常にシンプルです。「デプロイする人（ユーザー）が値を決めるべきかどうか」を考えてください。環境ごとに値を変えたい（例：開発用は安いプラン、本番用は高いプラン）場合はパラメータにします。一方で、プロジェクト内でルールが決まっているものや、計算で求められる値は変数にします。

また、パラメータには@allowedのようなデコレータ（制限ルール）を付けることができます。これにより、無効な値が入力されるのを防ぎ、エラーを未然に回避する安全なテンプレートが作れます。変数は内部処理、パラメータはインターフェース（窓口）と捉えると整理しやすいでしょう。

5. 再利用性を高めるためのデコレータ活用術

5. 再利用性を高めるためのデコレータ活用術

Bicepには、パラメータの入力内容を制御するデコレータ（Decorator）という機能があります。これを使うと、例えば「文字列の長さは3文字から24文字まで」や「選択肢はこの3つの中から選ぶこと」といった制約を追加できます。これにより、初心者でも使いやすく、かつ壊れにくいテンプレートが完成します。再利用性を高めるためには、ドキュメントを読まなくても使い方がわかるような親切な設計が重要です。@descriptionを使えば、Azureポータル上でそのパラメータの説明文を表示させることも可能です。

@description('ストレージアカウントの場所を指定します。')
@allowed([
  'japaneast'
  'japanwest'
])
param location string

@minLength(3)
@maxLength(24)
param storagePrefix string

var finalName = '${storagePrefix}${uniqueString(resourceGroup().id)}'

6. 条件分岐とループによる高度な設計

6. 条件分岐とループによる高度な設計

変数やパラメータを応用すると、条件分岐（if文）やループ処理（for文）をテンプレート内で使えるようになります。例えば、「本番環境のときだけバックアップを有効にする」といった制御や、「パラメータで渡された配列の数だけ仮想ネットワークを作成する」といった動的な処理が可能です。これにより、一つのBicepファイルで多種多様な構成に対応できるようになり、管理するファイルの数を劇的に減らすことができます。再利用性の極致とも言えるテクニックです。

param deployVnet bool = true
param subnetNames array = [
  'frontend'
  'backend'
  'database'
]

// 条件付きデプロイ
resource vnet 'Microsoft.Network/virtualNetworks@2023-05-01' = if (deployVnet) {
  name: 'myVnet'
  location: resourceGroup().location
  properties: {
    addressSpace: {
      addressPrefixes: ['10.0.0.0/16']
    }
    // ループによるサブネット作成
    subnets: [for name in subnetNames: {
      name: name
      properties: {
        addressPrefix: '10.0.${indexOf(subnetNames, name)}.0/24'
      }
    }]
  }
}

7. 安全なデプロイのためのベストプラクティス

7. 安全なデプロイのためのベストプラクティス

最後に、Bicepで変数とパラメータを扱う際の注意点について触れておきます。最も重要なのは、パスワードや接続文字列などの機密情報を直接コードに書かないことです。こうした情報は@secure()デコレータを付けたパラメータとして定義し、デプロイ時にAzure Key Vault（アジュール・キー・ボルト）から渡すようにします。また、変数名やパラメータ名は、誰が見ても意味がわかるように命名しましょう。temp1のような名前ではなく、webAppSkuNameのように具体的な役割がわかる名前を付けることが、長期的なメンテナンス性を保つ秘訣です。BicepのLinter（静的解析ツール）を活用すれば、推奨されない記述をリアルタイムで指摘してくれるため、積極的に利用していきましょう。

まとめ

まとめ

今回の記事では、Azure Bicep（アジュール・バイセップ）における変数とパラメータの活用方法について詳しく解説してきました。クラウドインフラをコードで管理するIaC（インフラストラクチャ・アズ・コード）において、設定値をハードコーディング（直接記述）せずに柔軟に管理することは、運用の効率化に直結します。パラメータは外部からの入力を受け取る窓口として、変数は内部での複雑な計算や文字列結合の結果を保持する役割として、それぞれ明確な使い分けが必要です。

パラメータと変数の使い分けの重要性

プログラムの世界と同様に、インフラの定義においても再利用性は非常に重要です。開発環境、検証環境、本番環境といった異なるフェーズで、全く同じ構成のテンプレートを使い回すためには、環境ごとに異なる値（リソース名、リージョン、スペックなど）をパラメータとして切り出す必要があります。一方で、プロジェクト独自の命名規則や、複数の値を組み合わせた一意の文字列などは、変数として内部に隠蔽することで、テンプレートを利用するユーザーの負担を減らすことができます。

安全性とメンテナンス性を高める工夫

また、Bicepの強力な機能であるデコレータ（Decorator）を活用することで、入力値のバリデーション（検証）が可能になります。@allowedや@minLengthといった制約を加えることで、デプロイ時に予期せぬエラーが発生するリスクを最小限に抑えることができます。さらに、パスワードなどの機密情報を扱う際には@secureデコレータを忘れずに使用し、セキュリティを確保することがプロフェッショナルな設計への第一歩です。

さらなるステップアップに向けて

Bicepは非常に進化の早いツールであり、条件分岐やループ処理を組み合わせることで、より高度で動的なインフラ構築が可能になります。一つのテンプレートで数千台のサーバーを管理したり、特定の条件を満たすときだけセキュリティ設定を強化したりといった柔軟な制御が、変数とパラメータの応用によって実現します。これからクラウドエンジニアを目指す初心者の皆さんは、まずは「外から変えるものはパラメータ」「中で計算するものは変数」という基本を徹底して意識してみてください。

Azure Bicepをマスターすることは、単にインフラを構築できるようになるだけでなく、システム全体の構成をコードとして俯瞰（ふかん）し、論理的に整理する力を養うことにも繋がります。今回学んだ基礎を土台にして、実際のプロジェクトで再利用性の高いテンプレート設計に挑戦してみましょう。

using System;

class BicepConcept
{
    static void Main()
    {
        // これがBicepの「param」に相当するもの（外部からの入力と仮定）
        string inputEnv = "dev";
        int storageCount = 3;

        // これがBicepの「var」に相当するもの（内部での計算）
        string resourceName = "st" + inputEnv + "data";
        bool isProduction = (inputEnv == "prod");

        Console.WriteLine("リソース名: " + resourceName);
        Console.WriteLine("ストレージ数: " + storageCount);
        Console.WriteLine("本番環境フラグ: " + isProduction);

        if (isProduction)
        {
            Console.WriteLine("高セキュリティ設定を適用します。");
        }
        else
        {
            Console.WriteLine("標準設定を適用します。");
        }
    }
}

リソース名: stdevdata
ストレージ数: 3
本番環境フラグ: False
標準設定を適用します。

id | name         | age | email
---+------------+-----+-------------------
1  | 山田太郎     | 25  | taro@example.com
2  | 佐藤花子     | 19  | hanako@example.com
3  | 鈴木一郎     | 30  | ichiro@example.com
4  | 田中次郎     | 42  | jiro@example.com
5  | 伊藤美咲     | 28  | misaki@example.com

-- @target_id がパラメータに相当します
DECLARE @target_id INT = 2;

-- 内部で計算（変数的な処理）を含めて抽出
SELECT 
    id, 
    name, 
    age,
    CASE 
        WHEN age >= 20 THEN 'Adult' 
        ELSE 'Minor' 
    END AS age_group
FROM users
WHERE id = @target_id;

id | name         | age | age_group
---+------------+-----+----------
2  | 佐藤花子     | 19  | Minor

# 環境変数を設定（これがパラメータや変数の代わり）
export PROJECT_NAME="bicep-demo"
echo "Project: ${PROJECT_NAME}"
Project: bicep-demo