Bicep ツールのインストール

Bicep ファイルを操作するために環境を準備します。 Bicep ファイルを作成してデプロイするために、次のいずれかのオプションをお勧めします。

Tasks	オプション	Bicep CLI のインストール
Author	Visual Studio Code と Bicep 拡張機能	automatic
	Visual Studio と Bicep 拡張機能	automatic
Deploy	Azure CLI	automatic
	Azure PowerShell	manual
	Visual Studio Code と Bicep 拡張機能	manual
	エアギャップクラウド	ダウンロード

Warning

Rosetta2 や QEMU などのエミュレーションツールは、通常、アーキテクチャを完全にエミュレートしていないため、エミュレートされた環境での Bicep CLI の安定性は保証されません。

Visual Studio Code と Bicep 拡張機能

Bicep ファイルを作成するには、適切な Bicep エディターが必要です。以下のことが推奨されます。

Visual Studio Code - まだ Visual Studio Code をインストールしていない場合は、インストールします。
Visual Studio Code 用の Bicep 拡張機能。 Visual Studio Code と Bicep 拡張機能によって、言語サポートとリソースオートコンプリートが提供されます。この拡張機能は、Bicep ファイルの作成と検証に役立ちます。

拡張機能をインストールするには、 [拡張機能] タブまた Visual Studio マーケットプレースで "bicep" を検索します。

[インストール] を選択します。

拡張機能がインストールされていることを確認するには、.bicep ファイル拡張子を持つ任意のファイルを開きます。右下隅の言語モードが Bicep に変わります。

Bicep 言語モードのスクリーンショット。

インストール中にエラーが発生する場合は、「Bicep のインストールのトラブルシューティング」を参照してください。

Visual Studio Code エディターから直接 Bicep ファイルをデプロイできます。詳細については、Visual Studio Code での Bicep ファイルのデプロイに関するページを参照してください。

Bicep 拡張機能を構成する

設定を表示するには:

[View] メニューから、[Extensions] を選択します。
拡張機能の一覧から [Bicep] を選択します。
[FEATURE](アクション) タブを選択します。

設定を選択します。

Bicep 拡張機能の設定のスクリーンショット。

Bicep 拡張機能には、これらの設定と既定値があります。

ID	既定値	Description
bicep.completions.getAllAccessibleAzureContainerRegistries	false	"br:" モジュール参照を完了するときに、ユーザーがアクセスできるすべてのコンテナーレジストリについて Azure にクエリを実行します (低速になる可能性があります)。このオプションがオフの場合、bicepconfig.json の moduleAliases で構成されたレジストリのみが一覧表示されます。
bicep.decompileOnPaste	true	貼り付けられた JSON 値、JSON ARM テンプレート、または JSON ARM テンプレートのリソースを Bicep に自動的に変換します (元に戻すには [元に戻す] を使用します)。
bicep.enableOutputTimestamps	true	Bicep 演算の出力チャネルに表示される各行の先頭にタイムスタンプを付けます。
bicep.enableSurveys	true	不定期のアンケートで、Bicep 拡張機能の改善に役立つフィードバックを収集できるようにします。
bicep.suppressedWarnings		[次からは表示しない] ボタンが押されたために抑制されている警告。リセットする項目を削除します。
bicep.trace.server	off	Bicep 言語サーバーに送信されるメッセージのトレースを構成します。

設定を構成するには:

[ファイル] メニューから、 [基本設定] を選択し、次に [設定] を選択します。
[拡張機能] を展開して [Bicep] を選択します。

Visual Studio と Bicep 拡張機能

Visual Studio から Bicep ファイルを作成するには、以下が必要です。

Visual Studio - まだ Visual Studio をインストールしていない場合は、インストールします。
Visual Studio 用の Bicep 拡張機能。 Visual Studio と Bicep 拡張機能によって、言語サポートとリソースオートコンプリートが提供されます。この拡張機能は、Bicep ファイルの作成と検証に役立ちます。 Visual Studio Marketplace から拡張機能をインストールします。

チュートリアルを行うには、「クイックスタート: Visual Studio を使用して Bicep ファイルを作成する」を参照してください。

Azure CLI

Bicep と Azure CLI を使用する場合、Bicep ファイルをデプロイして逆コンパイルするために必要なものがすべて揃います。 Bicep CLI は、これを必要とするコマンドを実行するときに Azure CLI によって自動的にインストールされます。

Azure CLI のバージョン 2.20.0 以降 をインストールしてある必要があります。さまざまなオペレーティングシステムに Azure CLI をインストールまたは更新するには、次を参照してください。

現在のバージョンを確認するには、次の手順を実行します。

az --version

Bicep CLI のインストールを確認するには、次のコマンドを使用します。

az bicep version

最新バージョンにアップグレードするには、以下を使用します。

az bicep upgrade

その他のコマンドについては、Bicep CLI に関するページを参照してください。

Important

Azure CLI によって、Bicep CLI の自己完結型インスタンスがインストールされます。このインスタンスは、手動でインストールしたバージョンと競合しません。 Azure CLI は、Bicep CLI を PATH に追加しません。

Bicep 環境の設定が完了しました。この記事の残りの部分では、Azure CLI を使用するときに不要なインストール手順について説明します。

Azure PowerShell

Azure PowerShell のバージョン 5.6.0 以降をインストールしてある必要があります。更新またはインストールする方法については、Azure PowerShell のインストールに関するページを参照してください。

Azure PowerShell では、Bicep CLI は自動的にインストールされません。代わりに、 Bicep CLI を手動でインストールする必要があります。

Important

Azure CLI によってインストールされた Bicep CLI の自己完結型インスタンスは、PowerShell コマンドでは使用できません。 Bicep CLI を手動でインストールしていない場合、Azure PowerShell のデプロイは失敗します。

Bicep CLI を手動でインストールする場合は、Azure CLI のbicep構文ではなく、az bicep構文を使用して Bicep コマンドを実行します。

Bicep CLI のバージョンを確認するには、次を実行します。

bicep --version

手動でインストールする

次のメソッドでは、Bicep CLI をインストールし、PATH に追加します。 Azure CLI 以外を使用する場合は、手動でインストールする必要があります。

手動でインストールする場合は、Azure CLI で管理されている場所とは異なる場所を選択します。次の例はすべて、bicep または .bicep という名前の場所を使用します。この場所は、Azure CLI によって管理される場所と競合しません。Azure CLI では .azure が使用されます。

Linux
macOS
Windows

Linux

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-linux-x64
# Mark it as executable
chmod +x ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Note

Alpine のような軽量 Linux ディストリビューションの場合は、前のスクリプトで bicep-linux-x64 ではなく bicep-linux-musl-x64 を使用します。

macOS

Homebrew を使って

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

BASH 経由

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-osx-x64
# Mark it as executable
chmod +x ./bicep
# Add Gatekeeper exception (requires admin)
sudo spctl --add ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Note

Bicep CLI バージョン 0.16.X 以降のインストールでは、Gatekeeper の例外は必要ありません。ただし、Bicep CLI の夜間ビルドでも例外が必要です。

Windows

Windows インストーラ

最新の Windows インストーラーをダウンロードして実行します。インストーラーには管理者特権は必要ありません。インストールが完了すると、Bicep CLI がユーザーの PATH に追加されます。 PATH の変更を有効にするために、開いているコマンドシェルウィンドウを閉じてから再度開きます。

Chocolatey

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

PowerShell での手動

# Create the install folder
$installPath = "$env:USERPROFILE\.bicep"
$installDir = New-Item -ItemType Directory -Path $installPath -Force
$installDir.Attributes += 'Hidden'
# Fetch the latest Bicep CLI binary
(New-Object Net.WebClient).DownloadFile("https://github.com/Azure/bicep/releases/latest/download/bicep-win-x64.exe", "$installPath\bicep.exe")
# Add bicep to your PATH
$currentPath = (Get-Item -path "HKCU:\Environment" ).GetValue('Path', '', 'DoNotExpandEnvironmentNames')
if (-not $currentPath.Contains("%USERPROFILE%\.bicep")) { setx PATH ($currentPath + ";%USERPROFILE%\.bicep") }
if (-not $env:path.Contains($installPath)) { $env:path += ";$installPath" }
# Verify you can now access the 'bicep' command.
bicep --help
# Done!

エアギャップクラウドへのインストール

bicep install および bicep upgrade コマンドは、エアギャップ環境では機能しません。エアギャップ環境に Bicep CLI をインストールするには、Bicep CLI の実行可能ファイルを手動でダウンロードし、.azure/bin に保存する必要があります。この場所には、Azure CLI によって管理されるインスタンスがインストールされます。

Linux
1. bicep-linux-x64 を、Bicep リリースページからエアギャップではない環境にダウンロードします。
2. 実行可能ファイルを、エアギャップマシン上の $HOME/.azure/bin ディレクトリにコピーします。ファイルの名前を bicep に変更します。
macOS
1. bicep-osx-x64 を、Bicep リリースページからエアギャップではない環境にダウンロードします。
2. 実行可能ファイルを、エアギャップマシン上の $HOME/.azure/bin ディレクトリにコピーします。ファイルの名前を bicep に変更します。
Windows
1. bicep-win-x64.exe を、Bicep リリースページからエアギャップではない環境にダウンロードします。
2. 実行可能ファイルを、エアギャップマシン上の %UserProfile%/.azure/bin ディレクトリにコピーします。ファイルの名前を bicep.exe に変更します。

Azure CLI タスクをエアギャップクラウドで使う場合、タスクの useGlobalConfig プロパティを true に設定する必要があります。既定値は false です。例については、Azure Pipelines と Bicep ファイルを使った CI/CD に関する記事を参照してください。

夜間ビルドのインストール

リリース前に Bicep の最新プレリリースビットを試す場合は、夜間ビルドのインストールに関する記事を参照してください。

Warning

これらのプレリリースビルドには、既知または不明なバグが含まれている可能性が非常に高くなります。

NuGet パッケージのインストール

Bicep チームは、Azure.Bicep.Core NuGet パッケージを nuget.org で一般公開しました。これは一般公開されてはいますが、サポートされているパッケージではありません。このパッケージに対して行われる依存関係は、お客様自身の責任で行われます。Microsoft は、このパッケージに重大な変更をいつでもプッシュする権利を留保します。

NuGet パッケージのインストールと使用の詳細については、「パッケージの使用ワークフロー」を参照してください。

次のステップ

Visual Studio Code と Bicep 拡張機能の使用方法の詳細については、「クイックスタート: Visual Studio Code を使用して Bicep ファイルを作成する」を参照してください。
Bicep のインストールに問題がある場合は、「Bicep のインストールのトラブルシューティング」を参照してください。
Azure Pipeline から Bicep ファイルをデプロイするには、「クイックスタート: Bicep と Azure Pipelines の統合」を参照してください。 GitHub Actions を使用して Bicep ファイルをデプロイするには、「クイックスタート: GitHub Actions を使用して Bicep ファイルをデプロイする」を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-07-25