Установка инструментов Bicep

Давайте настроим вашу среда для работы с файлами Bicep. Чтобы создавать и развертывать файлы Bicep, рекомендуется использовать любой из следующих вариантов:

Задания	Варианты	Установка Bicep CLI
Автор	VS Code и расширение Bicep	automatic
	Visual Studio и расширение Bicep	automatic
Развернуть	Azure CLI	automatic
	Azure PowerShell	manual
	VS Code и расширение Bicep	manual
	Облако, отключенное от сети	скачиваемого файла

VS Code и расширение Bicep

Для создания файлов Bicep нужен хороший редактор Bicep. Примите во внимание следующие рекомендации.

• Visual Studio Code. Если у вас еще нет Visual Studio Code, установите это приложение.

• Расширение Bicep для Visual Studio Code. Visual Studio Code с расширением Bicep обеспечивает поддержку языка и автозавершение ресурсов. Расширение позволяет создавать и проверять файлы Bicep.

  Чтобы установить расширение, выполните поиск по запросу Bicep на вкладке Расширения или в Visual Studio Marketplace.

  Нажмите кнопку Установить.

  

Чтобы убедиться в том, что расширение установлено, откройте любой файл с расширением .bicep. Языковой режим в правом нижнем углу должен измениться на Bicep.

Если при установке произошла ошибка, см. сведения в статье Устранение неполадок с установкой Bicep.

Файлы Bicep можно развертывать непосредственно из редактора VS Code. Дополнительные сведения см. в статье Развертывание файлов Bicep из Visual Studio Code.

Visual Studio и расширение Bicep

Чтобы создать файл Bicep из Visual Studio, вам потребуется:

• Visual Studio — если у вас еще нет Visual Studio, установите ее.
• Расширение Bicep для Visual Studio. Visual Studio с расширением Bicep обеспечивает языковую поддержку и автозавершение ресурсов. Расширение позволяет создавать и проверять файлы Bicep. Установите расширение из Visual Studio Marketplace.

Пошаговое руководство см. в статье Краткое руководство. Создание файлов Bicep с помощью Visual Studio.

Azure CLI

При использовании Azure CLI с Bicep у вас есть все необходимое для развертывания и декомпиляции файлов Bicep. Azure CLI автоматически устанавливает Bicep CLI при выполнении команды, которой требуется этот интерфейс.

Необходимо установить Azure CLI версии 2.20.0 или более поздней. Чтобы установить или обновить Azure CLI, см. следующие статьи:

• Установка Azure CLI в Windows
• Установка Azure CLI в Linux
• Установка Azure CLI в macOS

Чтобы проверить текущую версию, выполните следующую команду:

az --version

Чтобы проверить установку Bicep CLI, используйте следующую команду:

az bicep version

Чтобы произвести обновление до последней версии, используйте следующую команду:

az bicep upgrade

Дополнительные команды см. в разделе Bicep CLI.

Важно!

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.

Важно!

Автономный экземпляр Bicep CLI, устанавливаемый интерфейсом Azure CLI, недоступен для команд PowerShell. Если вы не установили интерфейс Bicep CLI вручную, развертывание Azure PowerShell завершается сбоем.

Если интерфейс Bicep CLI установлен вручную, выполняйте команды Bicep с синтаксисом bicep вместо синтаксиса az bicep для Azure CLI.

Чтобы проверить версию Bicep CLI, выполните следующую команду:

bicep --version

Установка вручную

Указанные ниже методы позволяют установить Bicep CLI и выполнить добавление в PATH. Этот интерфейс необходимо установить вручную для любого использования, кроме Azure CLI.

При установке вручную выберите расположение, которое отличается от расположения, управляемого Azure CLI. Во всех следующих примерах используется расположение с именем bicep или .bicep. Это расположение не конфликтует с расположением, управляемым 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!

Примечание

Для упрощенных дистрибутивов Linux, таких как Alpine, используйте bicep-linux-musl-x64 вместо bicep-linux-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!

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. Пример см. в статье CI/CD с файлами Azure Pipelines и Bicep .

Установка ежедневных ночных сборок

Если вы хотите испытать последние предварительные версии Bicep перед их выпуском, см. статью об установке ежедневных ночных сборок.

Предупреждение

Эти предварительные сборки с большей вероятностью имеют известные или неизвестные ошибки.

Установка пакета NuGet

Команда Bicep сделала пакет NuGet Azure.Bicep.Core общедоступным на nuget.org. Хотя он является общедоступным, он не является поддерживаемым пакетом. Любая зависимость от этого пакета будет выполняться на ваш страх и риск, и мы оставляем за собой право в любое время отправлять критические изменения в этот пакет.

Дополнительные сведения об установке и использовании пакетов NuGet см. в разделе Использование пакетов.

Дальнейшие действия

Дополнительные сведения об использовании Visual Studio Code и расширения Bicep см. в кратком руководстве по созданию файлов Bicep с помощью Visual Studio Code.

Если у вас возникли проблемы с установкой Bicep, см. сведения в статье Устранение неполадок с установкой Bicep.

Сведения о развертывании файлы Bicep из Azure Pipeline см. в статье Интеграция Bicep с Azure Pipelines. Сведения о развертывании файлов Bicep с помощью GitHub Actions см. в статье Развертывание файлов Bicep с помощью GitHub Actions.