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

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

Расширения Visual Studio 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 непосредственно из редактора Visual Studio Code. Для получения дополнительной информации см. Развертывание Bicep-файлов с помощью Visual Studio Code.

Настройка расширения Bicep

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

1. View В меню выберите Extensions.

2. Выберите Bicep из списка расширений.

3. Выберите вкладку FEATURE.

4. Выберите Параметры.

   

   Расширение Bicep имеет следующие параметры и значения по умолчанию:

   ID	Значение по умолчанию	Description
   bicep.completions.getAllAccessibleAzureContainerRegistries	false	При завершении ссылок на модуль 'br:', выполните запрос к Azure для получения всех реестров контейнеров, доступных пользователю (это может занять время). Если этот параметр отключен, будут перечислены только реестры, настроенные в модулеAliases в bicepconfig.json.
   bicep.decompileOnPaste	true	Автоматически преобразуйте вставленные значения JSON, шаблоны ARM JSON или ресурсы из шаблона ARM JSON в Bicep (используйте отмену для возврата).
   bicep.enableOutputTimestamps	true	Добавьте временную метку перед каждой строкой, отображаемой в выходном канале операций Bicep.
   bicep.enableSurveys	true	Включите опросы, проводимые время от времени, чтобы собирать отзывы, которые помогают нам улучшать расширение Bicep.
   bicep.suppressedWarnings		Предупреждения, скрытые после нажатия кнопки "Не показывать снова". Удалите элементы для сброса.
   bicep.trace.server	off	Настройте трассировку сообщений, отправленных на сервер языка Bicep.

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

1. В меню Файл последовательно выберите команды Настройки и Параметры.

2. Разверните Дополнения, чтобы выбрать Bicep:

   

Расширение Bicep для Visual Studio

Чтобы создать 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 в разных операционных системах см. в следующих статье:

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

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

az --version

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

az bicep version

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

az bicep upgrade

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

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

Azure PowerShell

У вас должен быть установлен модуль Azure PowerShell версии 5.6.0 или более поздней. Инструкции по обновлению или установке см. в статье Установка Azure PowerShell.

Azure PowerShell не устанавливает Bicep CLI автоматически. Вместо этого необходимо установить интерфейс командной строки Bicep вручную.

При ручной установке интерфейса командной строки Bicep выполните команды 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!

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 Installer

Скачайте и запустите последнюю версию установщика Windows. Для установщика не требуются права администратора. После установки интерфейс командной строки Bicep добавляется в путь пользователя. Закройте и снова откройте все открытые окна командной оболочки, чтобы изменения 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.