{"canonical_url":"https://engineer.company/ja/glossary/bicep/","content_markdown":"# Bicep\n\n## どのようなものか\n\nBicepは、Azureインフラをテキストとして記述するための、Microsoftの言語です。どのリソースが存在し、何という名前で、どう設定され、互いにどう接続するかを記述します。Bicepファイルには、手順を並べません。最終的な状態を示すと、Azureの管理要求が通る層、Azure Resource Managerが、そこへ至るために何を作成し、変更し、そのまま残すかを判断します。「Bicepとは」と尋ねる人が知りたいのは、多くの場合、Azureポータルでのクリック操作に代わるかどうかです。代わりになり、そのことに価値の大半があります。\n\nその仕組みは、Azureがすでに理解できるものを、より書きやすくしたものです。Resource Managerは、以前からJSONで書いたデプロイテンプレートを受け付けています。必要なことをすべて表現できますが、読みにくく、レビューはさらに困難です。デプロイ時には、Bicepのコマンドラインツールが`.bicep`ファイルをそのJSONテンプレートへ変換し、Resource Managerが、手書きのJSONとまったく同じようにデプロイします。Microsoftは、リソースプロバイダーが導入した時点から、プレビューを含むすべてのリソースタイプとAPIバージョンにBicepが対応すると述べています。そのため、プラグインの更新を待たずに、新しいサービスを使えます。既存のJSONテンプレートをBicepへ逆コンパイルすることもでき、古い環境の移行は、書き直しではなく機械的な作業になります。\n\n小さなファイルを見ると、その形が分かります。まずパラメーターを置き、次に各リソースを記述します。それぞれに、ファイルの他の部分から参照できるシンボル名を付けます。\n\n```text\nparam env string\nparam location string = resourceGroup().location\n\nresource store 'Microsoft.Storage/storageAccounts@2023-05-01' = {\n  name: 'st${env}${uniqueString(resourceGroup().id)}'\n  location: location\n  sku: {\n    name: 'Standard_LRS'\n  }\n  kind: 'StorageV2'\n}\n```\n\n別のリソースが`store.id`を参照すると、Bicepは、そのリソースがストレージアカウントの作成を待つ必要があると推論します。そのため、人が順序を指定する必要はなく、他に依存しないものはResource Managerが並列にデプロイします。一つのファイルから別のファイルをモジュールとして呼び出せるため、「ネットワークルールを備えたデータベース」を一度記述して、必要な場所すべてで再利用できます。環境ごとに異なる値は、別の`.bicepparam`ファイルに置きます。Microsoftは、Bicepが無償のオープンソースであり、汎用プログラミング言語を目指していないことも明記しています。ループ、条件、関数はありますが、いずれもリソースを記述するためのものです。\n\n他の選択肢とは、どう違うのでしょうか。ARM JSONとは同じエンジンを使い、ソースがはるかに短くなります。Terraformとの主な違いは、対応範囲と状態の管理です。Terraformは多くのクラウドに対応し、独自の状態ファイルを保持します。一方、BicepのAzure Resource Managerを使う方式では、Azureがデプロイ状態を保存するため、独自の状態ファイルを保持しません。Bicepの[拡張機能](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension)は、KubernetesやMicrosoft Graphなど、Resource Managerの外のリソースにも対応します。TypeScriptやGoなどの汎用言語でインフラを記述するPulumiに対しては、柔軟性と引き換えに、レビューで短時間に読める小さな言語を選ぶことになります。\n\n## なぜ重要なのか\n\n手作業で構築したインフラには履歴がありません。ポータルで設定を変えても理由は残らず、変更前のレビューもなく、障害後の環境の再構築は、すべてのクリックを誰かが覚えていることに頼ります。インフラをリポジトリ内のファイルにすれば、アプリケーションコードと同じように、プルリクエスト、レビュアー、変更履歴、元へ戻す方法を持てます。\n\n二つ目の利点は、環境を同じ形に保てることです。同じファイルから異なるパラメーターで構築した開発・ステージング・本番環境は、パラメーターで指定した部分だけが異なります。Bicepのデプロイは冪等であり、Microsoftの言葉では、同じファイルを何度デプロイしても「同じ種類のリソースが同じ状態」になります。そのため安全に繰り返せます。新しい環境も、同じコマンドの対象を新しいリソースグループへ変えるだけです。\n\n三つ目は、変更前に内容を確認できることです。what-if操作は、ファイルと稼働中の状態を比較し、何かに手を加える前に、作成・変更・削除する予定のリソースを一つずつ列挙します。プルリクエストと組み合わせれば、「ファイアウォールのルールだけを変えると思う」という見込みを、レビュアーが検証できるものに変えられます。\n\n制約も明示すべきです。対応するリソースはデプロイの方式と拡張機能によるため、他社のDNSや第二のクラウドのリソースには、引き続き別のツールが必要な場合があります。Resource Managerを使う方式では、BicepはAzureリソースを記述します。仮想マシン内のパッケージやファイルは、Ansibleなどの構成管理が担います。また、望ましい状態を宣言するツールなら、ファイルから消したものも削除すると期待していると、Resource Managerの削除・再デプロイに関する既定の動作に驚くことになります。この点は第四節で説明します。\n\n## 実際の活用例\n\nこのサイトで紹介する複数のAzureプロジェクトはBicepを基盤としています。そのうち三つが、時間の経過とともにチームへ何をもたらすかを示しています。\n\nあるプラットフォームでは、Azure環境全体をBicepで記述しています。[全環境を同じテンプレートから生成](/ja/portfolio/provisioned-azure-infrastructure-as-code/)します。Azure Container Appsのapiとwww、PostgreSQL Flexible Server、キャッシュ用Redis、前段のWAFポリシー付きFront Door、その下のVNet・NSG・プライベートDNS、診断のLog Analyticsを含み、イメージはプロジェクトのAzure Container Registryから取得します。すべてパラメーター化し、新しい環境の構築も、既存環境の変更も、プルリクエストで行います。そのページは、再現・レビューが可能になり、コードが正本のため、ずれが謎ではなくなったと報告します。\n\n同じテンプレートが、リリース経路も支えます。[リリースは、開発からステージング、本番へと進みます](/ja/portfolio/owned-end-to-end-platform-deployments-to-azure/)。Bicepが各環境の対象インフラを同じ形に保つため、ビルドの昇格先が微妙に異なる環境になることはありません。環境固有の設定をシークレットと分け、一つのビルド成果物を、再ビルドせず全段階へ通せます。\n\n復旧計画の一部も、Bicepに記述しています。[守るデータベースの隣のBicepで、バックアップ保持を設定](/ja/portfolio/implemented-backups-and-disaster-recovery-as-code/)し、特定時点への復元を、誰かが一度クリックした設定でなく、テンプレートの性質にします。周囲の環境もコードです。記憶から再構築する環境へデータを戻すだけでは、復旧と言いにくいためです。未解決の点も示します。地理冗長性は無効で、復旧時間目標は実測でなく提案です。テンプレートは設定を示し、復元の時間を示すのは訓練だけです。\n\n## 問題が起きるところ\n\nBicepの問題の多くは、リソースグループ内のすべてを管理するツールだと期待することから生じます。既定では、ファイルに記述したものだけを、その記述に従う形で管理します。\n\n**ポータルの変更が、次のデプロイで消えます。** リソースの再デプロイは全プロパティを再適用し、省略したものを既定値へ戻します。インシデント中の手動修正が、次の通常のリリースで取り消されます。ファイルを各リソースの最終状態全体として扱い、既定値と異なる値をすべて書き、緊急変更もプルリクエストで行います。デプロイスタックの拒否設定で、外部からの編集自体も防げます。\n\n**テンプレートから消したものが、稼働・課金し続けます。** 標準は増分モードで、ファイルにないリソースは残します。データベースをコードから消しても、Azureには残ります。Microsoftの答えはデプロイスタックです。対象を記録し、外れたものを切り離すか削除するかを、`actionOnUnmanage`で決めます。完全モードも、ファイルに記述のないリソースを削除しますが、Microsoftは勧めず、段階的に廃止しています。\n\n**what-ifに、誰もしていない変更が並びます。** ファイルでは省略してもAzureが既定値を補うプロパティを、削除と報告する場合があり、Microsoftは雑音と呼びます。`reference`関数から値を設定するプロパティは毎回変更扱いで、`utcNow()`やセキュアなパラメーターはデプロイ中だけ存在するため、what-ifでは評価できないまま表示します。毎回のプルリクエストで実行し、暫定的な結果として読み、ノイズを生むプロパティの値を明示して、本当の変更が目立つようにします。\n\n```sh\naz deployment group what-if \\\n  --resource-group rg-staging \\\n  --template-file main.bicep \\\n  --parameters staging.bicepparam\n```\n\n**パスワードがデプロイ履歴に現れます。** 普通の文字列パラメーターは記録され、履歴を読める人には見えます。シークレットのパラメーターには`@secure()`デコレーターを付けて値をデプロイ履歴やログから除き、シークレット自体は、リポジトリ内のパラメーターファイルではなくKey Vaultに置きます。\n\n## 参考資料\n\n- [Bicepとは](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview)：言語、利点、目指していないものの公式説明です。\n- [Bicepモジュール](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/modules)：互いを呼ぶファイルへの分割です。\n- [Bicepのパラメーター](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/parameters)：型、デコレーター、既定値、`@secure()`が履歴から除くものです。\n- [デプロイモード](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes)：増分と完全、それぞれの省略リソースの扱いです。\n- [Bicepのwhat-if操作](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deploy-what-if)：事前確認、変更の種類、既知の雑音です。\n- [デプロイスタック](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deployment-stacks)：削除と拒否を含む、まとめて行うリソース管理です。\n\n\u003chttps://engineer.company/ja/glossary/bicep/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Bicepの仕組み、ARM JSON・Terraformとの違い、Azure環境を共通のファイルで揃える方法、特に起きやすい四つの問題を説明します","formats":{"gemtext":"https://engineer.company/ja/glossary/bicep/index.gmi","gopher":"https://engineer.company/ja/glossary/bicep/gophermap","html":"https://engineer.company/ja/glossary/bicep/","json":"https://engineer.company/ja/glossary/bicep/index.json","markdown":"https://engineer.company/ja/glossary/bicep/index.md","pdf":"https://engineer.company/ja/glossary/bicep/index.pdf"},"kind":"page","language":"ja","title":"Bicepとは？","url":"https://engineer.company/ja/glossary/bicep/","version":1}