Azure Bicep（バイセップ）入門｜次世代IaC言語でテンプレートを劇的に簡略化

1. Azure Bicepとは？

1. Azure Bicepとは？

Azure Bicep（バイセップ）は、Microsoftが開発したIaC（Infrastructure as Code：インフラストラクチャ・アズ・コード）のためのドメイン固有言語（DSL）です。IaC（アイエーシー）とは、サーバーやネットワークなどのクラウドインフラの構成を、手動で操作するのではなく、プログラムの「コード」として記述して自動化する手法のことを指します。

従来のAzureでは、ARM（アーム）テンプレートと呼ばれるJSON（ジェイソン）形式のファイルが使われてきました。しかし、JSONは人間にとって読み書きが難しく、少しの設定でも記述量が膨大になるという課題がありました。そこで登場したのがBicepです。Bicepという名前は、英語で「上腕二頭筋」を意味します。これは、従来のARM（アーム：腕）をより強力で使いやすく補強するという意味が込められています。

Bicepを利用することで、初心者でも短く、分かりやすいコードで、仮想マシンやストレージアカウントなどのAzureリソースを定義できるようになります。コードが簡略化されることで、ミスの削減やチーム内での共有がスムーズになるという大きな利点があります。

2. Bicepを使うメリットと特徴

2. Bicepを使うメリットと特徴

なぜ今、多くのエンジニアがBicepに注目しているのでしょうか。その主なメリットは以下の通りです。

• 構文がシンプル： JSONのような複雑なカッコの入れ子構造がなく、プログラミング言語に近い感覚で書けます。
• モジュール化が容易： 共通の設定を部品として切り出して再利用できるため、管理が楽になります。
• 自動依存関係管理： どのリソースを先に作るべきかをBicepが自動で判断してくれます。
• 強力なツール支援： VS Code（ヴィジュアルスタジオコード）の拡張機能を使うと、入力補完やエラーチェックが強力に働きます。

特に、Azureの最新機能をすぐに利用できる「Day Zero（デイゼロ）サポート」も魅力です。新しいリソースが公開されたその日からBicepで管理できるため、常に最新のクラウド技術を追いかけることが可能です。また、Bicepファイルはデプロイ時に自動でARMテンプレートへ変換されるため、既存の仕組みを壊すことなく導入できます。

3. 開発環境を整えよう

3. 開発環境を整えよう

Bicepを使い始めるには、いくつかのツールをインストールする必要があります。パソコン初心者の方でも、以下の手順で進めれば準備完了です。

まず、エディタとしてVisual Studio Code（VS Code）をインストールします。次に、VS Codeの拡張機能マーケットプレイスから「Bicep」という名前の拡張機能を追加してください。これにより、コードを書いている途中にヒントが表示されるようになります。最後に、Azure CLI（アジュール・シーエルアイ）をインストールしましょう。コマンドラインからAzureを操作するためのツールです。

インストールが完了したら、正しく設定できているかターミナル（コマンドプロンプトやPowerShell）で確認してみましょう。

az bicep version
Bicep CLI version 0.26.54 (b005ef0789)

このようにバージョン情報が表示されれば、準備はバッチリです。これであなたのパソコンでBicepを動かす準備が整いました。

4. Bicepの基本構造と書き方

4. Bicepの基本構造と書き方

Bicepファイルの拡張子は .bicep です。基本的な書き方は非常にシンプルで、resource キーワードを使って定義します。まずは、最も簡単な例として「ストレージアカウント」を作成するコードを見てみましょう。

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-01-01' = {
  name: 'mystorage20260331'
  location: 'japaneast'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}

このコードの意味を簡単に解説します。最初の resource は「今からリソースを作ります」という宣言です。storageAccount はBicep内で使うニックネーム、その後の長い文字列はリソースの種類とバージョンを示しています。name はAzure上での実際の名前、location は設置する場所（この場合は東日本）を指定しています。JSONに比べて非常にスッキリしているのが分かりますね。

5. パラメーターを使って汎用性を高める

5. パラメーターを使って汎用性を高める

先ほどのコードでは、名前や場所を直接書いていましたが、これでは別のプロジェクトで使い回すのが大変です。そこで登場するのがパラメーター（parameter）です。パラメーターを使うと、実行時に値を流し込むことができるようになります。

param storageName string
param location string = 'japaneast'

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

このように書くと、location のデフォルト値を「東日本」にしつつ、必要に応じて変更することが可能になります。初心者の方は、まず「変えられる部分はパラメーターにする」と覚えておきましょう。これにより、一つのテンプレートで開発環境、テスト環境、本番環境と、設定を切り替えてデプロイできるようになります。

6. リソース間の依存関係を理解する

6. リソース間の依存関係を理解する

実際のシステム構築では、複数のリソースを組み合わせることが一般的です。例えば、Webアプリを動かすための「App Service（アップサービス）」と、その土台となる「App Service Plan（プラン）」を作る場合です。プランが先に存在しないとアプリは作れません。Bicepでは、これを「シンボリック名」を使って自動的に解決します。

resource appServicePlan 'Microsoft.Web/serverfarms@2022-09-01' = {
  name: 'myAppPlan'
  location: 'japaneast'
  sku: {
    name: 'F1'
  }
}

resource webApp 'Microsoft.Web/sites@2022-09-01' = {
  name: 'myUniqueWebApp2026'
  location: 'japaneast'
  properties: {
    serverFarmId: appServicePlan.id
  }
}

上記のコードで注目すべきは serverFarmId: appServicePlan.id の部分です。これにより、Bicepは「webAppを作る前にappServicePlanを作る必要がある」と自動で認識します。手動で順番を気にする必要がないのは、IaC（アイエーシー）の非常に便利なポイントです。

7. Bicepファイルをデプロイしてみよう

7. Bicepファイルをデプロイしてみよう

コードが書けたら、実際にAzureへ反映（デプロイ）してみましょう。Azure CLIを使って、作成したファイルをAzureのリソースグループに流し込みます。コマンドは以下のようになります。

az deployment group create --resource-group MyResourceGroup --template-file main.bicep
{
  "properties": {
    "provisioningState": "Succeeded",
    "timestamp": "2026-03-31T12:00:00Z"
  }
}

コマンドを実行して Succeeded（サクシード：成功）と表示されれば、Azureポータル上にリソースが自動的に作成されます。ポータル画面でボタンを何度もクリックする手間が、このコマンド一行で解決するのは感動的ですよ！もしエラーが出た場合は、VS Codeが教えてくれる赤い波線をチェックして修正しましょう。

8. 便利なモジュール機能を活用する

8. 便利なモジュール機能を活用する

最後に、中級者への第一歩として「モジュール」を紹介します。大規模なシステムになると、一つのBicepファイルが何百行にもなってしまいます。そこで、ネットワーク設定用、データベース用といった具合にファイルを分割し、部品として読み込むのがモジュール化です。

module networkModule './network.bicep' = {
  name: 'netDeploy'
  params: {
    vnetName: 'myVNet'
  }
}

output vnetId string = networkModule.outputs.vnetId

このように module キーワードを使うことで、他のファイルを呼び出せます。チーム開発では、得意な人が共通の部品（モジュール）を作り、他のメンバーがそれを組み合わせて使うという効率的な進め方が可能になります。初心者の方も、最初は一つのファイルで練習し、慣れてきたらモジュール化に挑戦してみてください。

まとめ

まとめ

今回の記事では、Microsoft Azureの次世代IaC（アイエーシー）言語であるAzure Bicep（バイセップ）について、その基本概念から具体的な導入方法、実践的な書き方まで詳しく解説してきました。クラウドインフラの構築を自動化する手法は、現代のシステム開発において欠かせないスキルとなっています。特に、従来のJSON形式で記述するARM（アーム）テンプレートに挫折してしまった方にとって、Bicepは救世主のような存在です。直感的な文法で、まるでプログラミングをするようにインフラを定義できる点は、開発者にとって非常に大きな魅力といえるでしょう。

Bicepを学ぶ上で最も重要なポイントは、その簡潔さと安全性です。VS Code（ヴィジュアルスタジオコード）の拡張機能を活用することで、入力補完やリアルタイムのエラーチェックが働き、初心者でもタイポや設定ミスを劇的に減らすことができます。また、パラメーター（parameter）を活用して汎用性の高いテンプレートを作成したり、リソース間の依存関係をBicepに自動で任せたりすることで、複雑なネットワーク構成やサーバー群のデプロイも、一行のコマンドで完結させることが可能になります。

さらに、Bicepの強力な機能であるモジュール（module）化についても触れました。大規模なプロジェクトになればなるほど、コードの再利用性と保守性が問われます。共通のインフラ設定を部品化して管理する手法を身につけることで、チーム全体の生産性を向上させることができます。Azureの最新機能をすぐに利用できる「Day Zero（デイゼロ）サポート」があるため、クラウドの進化に合わせて常に最適な構成を維持できるのも、他のツールにはない強みです。

Bicepで管理するリソース名の命名規則

実際にBicepで運用を始める際、リソース名の重複を避けるために一意の文字列を生成する関数を使うことがよくあります。例えば、ストレージアカウント名はグローバルでユニークである必要があるため、以下のような書き方が推奨されます。

param storagePrefix string = 'stg'
var uniqueStorageName = '${storagePrefix}${uniqueString(resourceGroup().id)}'

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

このように、uniqueString 関数と resourceGroup().id を組み合わせることで、リソースグループごとに異なる名前を自動生成できます。こうしたテクニックを一つずつ覚えることで、より実戦的なIaC（アイエーシー）エンジニアへとステップアップできるでしょう。まずは小さなストレージや仮想ネットワークの作成から始めて、少しずつAzure Bicepの便利さを体感してみてください。自動化された世界では、手動操作によるミスから解放され、より本質的な開発作業に集中できるようになります。