Instalar ferramentas do Bicep

Prepare seu ambiente para trabalhar com arquivos Bicep. Para criar e implantar arquivos Bicep, recomendamos qualquer uma das seguintes opções:

A extensão Bicep e o Visual Studio Code

Para criar arquivos Bicep, você precisará de um bom editor de Bicep. Recomendações:

• Visual Studio Code - Se você ainda não tiver o Visual Studio Code, instale-o.

• Extensão de Bicep para o Visual Studio Code. O Visual Studio Code com a extensão do Bicep fornece suporte a idiomas e preenchimento automático de recursos. A extensão ajuda a criar e validar arquivos Bicep.

  Para instalar a extensão, pesquise bicep na guia Extensões ou no Marketplace do Visual Studio.

  Selecione Instalar.

  

Para verificar se você instalou a extensão, abra qualquer arquivo com a extensão de arquivo .bicep. Você deve ver o modo de idioma no canto inferior direito mudar para Bicep.

Se você receber um erro durante a instalação, consulte Troubleshoot Bicep installation.

Você pode implantar seus arquivos Bicep diretamente do editor do Visual Studio Code. Para obter mais informações, veja Implantar arquivos Bicep com o Visual Studio Code.

Configurar a extensão Bicep

Para exibir as configurações:

1. No menu View, selecione Extensions.

2. Selecione Bicep na lista de extensões.

3. Selecione a guia FEATURE.

4. Selecione Configurações.

   

   A extensão Bicep apresenta estas configurações e valores padrão:

   ID	Valor padrão	Description
   bicep.completions.getAllAccessibleAzureContainerRegistries	false	Ao concluir referências de módulo "br:", consulte o Azure para todos os registros de contêiner acessíveis ao usuário. Isso pode demorar. Se essa opção estiver desativada, somente os registros configurados em moduleAliases no bicepconfig.json serão listados.
   bicep.decompileOnPaste	true	Converta automaticamente os valores JSON, modelos do ARM JSON ou recursos de um modelo do ARM JSON colados no Bicep (use Desfazer para reverter).
   bicep.enableOutputTimestamps	true	Acrescente um carimbo de data/hora para cada linha exibida no canal de saída de operações do Bicep.
   bicep.enableSurveys	true	Habilite pesquisas ocasionais para coletar comentários que nos ajudem a melhorar a extensão Bicep.
   bicep.suppressedWarnings		Avisos que estão sendo suprimidos porque um botão "Não mostrar novamente" foi pressionado. Remover itens para redefinir.
   bicep.trace.server	off	Configure o rastreamento de mensagens enviadas para o servidor de linguagem Bicep.

Para configurar as definições:

1. No menu Arquivo, selecione Preferências e Configurações.

2. Expandir Extensões para selecionarBicep:

   

Visual Studio e a Extensão Bicep

Para criar o arquivo Bicep no Visual Studio, você precisa:

• Visual Studio – Se você ainda não tiver o Visual Studio, instale-o.
• Extensão de Bicep para o Visual Studio. O Visual Studio com a extensão do Bicep fornece suporte a idiomas e preenchimento automático de recursos. A extensão ajuda a criar e validar arquivos Bicep. Instale a extensão Visual Studio Marketplace.

Para um passo a passo do tutorial, confira Início Rápido: Criar arquivos Bicep com o Visual Studio.

CLI do Azure

Ao usar a CLI do Azure com o Bicep, você tem tudo o que precisa para implantar e descompilar arquivos Bicep. A CLI do Azure instalará automaticamente a CLI do Bicep quando um comando for executado que precise dele.

Você deve ter a CLI do Azure versão 2.20.0 ou mais recente instalada. Para instalar ou atualizar o CLI do Azure em diferentes sistemas operacionais, veja:

• Instalar no Windows
• Instalar no Linux
• Instalar no macOS

Para verificar sua versão atual, execute:

az --version

Para validar a instalação da CLI do Bicep, use:

az bicep version

Para atualizar para a versão mais recente, use:

az bicep upgrade

Para obter mais comandos, consulte CLI do Bicep.

Você terminou de configurar seu ambiente Bicep. O restante desse artigo descreve as etapas de instalação que você não precisa ao usar a CLI do Azure.

Azure PowerShell

Você precisa ter o Azure PowerShell versão 5.6.0 ou mais recente instalado. Para atualizar ou instalar, consulte Instalar o Azure PowerShell.

O Azure PowerShell não instala automaticamente a CLI do Bicep. Em vez disso, você deve instalar a CLI do Bicep manualmente.

Ao instalar manualmente a CLI do Bicep, execute os comandos Bicep com a bicep sintaxe em vez da az bicep sintaxe da CLI do Azure.

Para verificar sua versão da CLI do Bicep, execute:

bicep --version

Instalar manualmente

Os métodos a seguir instalam a CLI do Bicep e a adicionam ao seu PATH. Você deve instalar manualmente para qualquer uso que não seja o CLI do Azure.

Ao instalar manualmente, selecione um local diferente daquele gerenciado pela CLI do Azure. Todos os exemplos a seguir usam um local chamado bicep ou .bicep. Esse local não entrará em conflito com o local gerenciado pelo CLI do Azure, que usa .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

Através do Homebrew

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

Via 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

Baixe e execute o instalador mais recente do Windows. O instalador não requer privilégios administrativos. Após a instalação, o Bicep CLI é adicionado ao seu PATH de usuário. Feche qualquer janela do shell de comando que esteja aberta e a reabra para que a alteração de PATH entre em vigor.

Chocolatey

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

Manual com 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!

Instalar em uma nuvem desconectada

Os comandos bicep install e bicep upgrade não funcionam em um ambiente desconectado. Para instalar a CLI do Bicep em um ambiente desconectado, é necessário baixar o executável da CLI do Bicep manualmente e salvá-lo em determinado local para .azure/bin. Esse local é onde a instância gerenciada pelo Azure CLI é instalada.

• Linux

  1. Baixe o bicep-linux-x64 na página da versão do Bicep em um ambiente desconectado.
  2. Copie o executável para o diretório $HOME/.azure/bin em um computador desconectado. Renomeie o arquivo como bicep.

• macOS

  1. Baixe o bicep-osx-x64 na página da versão do Bicep em um ambiente desconectado.
  2. Copie o executável para o diretório $HOME/.azure/bin em um computador desconectado. Renomeie o arquivo como bicep.

• Windows

  1. Baixe o bicep-win-x64.exe na página da versão do Bicep em um ambiente desconectado.
  2. Copie o executável para o diretório %UserProfile%/.azure/bin em um computador desconectado. Renomeie o arquivo como bicep.exe.

Ao usar a tarefa da CLI do Azure em uma nuvem desconectada, você precisa definir a propriedade useGlobalConfig da tarefa como true. O valor padrão é false. Confira CI/CD com o Azure Pipelines e os arquivos Bicep para ver um exemplo.

Instalar as compilações noturnas

Para experimentar os bits de pré-lançamento mais recentes do Bicep antes do lançamento, consulte Instalar compilações noturnas.

Instalar o pacote NuGet

A equipe do Bicep disponibilizou publicamente o pacote NuGet Azure.Bicep.Core no nuget.org. Embora seja público, não é um pacote com suporte. Qualquer dependência que você assumir nesse pacote será por sua conta e risco, e a Microsoft se reserva o direito de introduzir alterações significativas nesse pacote a qualquer momento.

Para obter mais informações sobre como instalar e consumir pacotes NuGet, consulte o fluxo de trabalho de consumo de pacotes.

Próximas etapas

• Para obter mais informações sobre como usar o Visual Studio Code e a extensão de Bicep, consulte Início rápido: criar arquivos Bicep com o Visual Studio Code.
• Se você tiver problemas com a instalação do Bicep, consulte Solucionar problemas de instalação do Bicep.
• Para implantar arquivos Bicep dos Azure Pipelines, consulte Início Rápido: Integração do Bicep com Azure Pipelines. Para implantar arquivos Bicep por meio do GitHub Actions, consulte Início Rápido: Implantar arquivos Bicep usando o GitHub Actions.