Udostępnij za pośrednictwem

Zainstaluj narzędzia Bicep

  • Artykuł

Przygotuj środowisko do pracy z plikami Bicep. Aby utworzyć i wdrożyć pliki Bicep, zalecamy dowolną z następujących opcji:

Zadania Opcje Instalacja interfejsu wiersza polecenia Bicep
Autor Visual Studio Code i rozszerzenie Bicep automatyczne
Visual Studio i rozszerzenie Bicep automatyczne
Wdróż Azure CLI automatyczne
Azure PowerShell Ręcznie
Visual Studio Code i rozszerzenie Bicep Ręcznie
Chmura rozsyłana powietrzem pobierz

Ostrzeżenie

Stabilność interfejsu wiersza polecenia Bicep w emulowanych środowiskach nie jest gwarantowana, ponieważ narzędzia emulacyjne, takie jak Rosetta2 i QEMU, zazwyczaj nie emulują architektury w sposób doskonały.

Rozszerzenie Visual Studio Code i Bicep

Aby utworzyć pliki Bicep, potrzebujesz dobrego edytora Bicep. Zalecamy:

  • Visual Studio Code — jeśli nie masz jeszcze programu Visual Studio Code, zainstaluj go.

  • Rozszerzenie Bicep dla programu Visual Studio Code. Program Visual Studio Code z rozszerzeniem Bicep zapewnia obsługę języka i automatyczne uzupełnianie zasobów. Rozszerzenie ułatwia tworzenie i weryfikowanie plików Bicep.

    Aby zainstalować rozszerzenie, wyszukaj bicep na karcie Rozszerzenia lub w sklepie Visual Studio Marketplace.

    Wybierz Zainstaluj.

    Zrzut ekranu przedstawiający instalowanie rozszerzenia Bicep.

Aby sprawdzić, czy rozszerzenie zostało zainstalowane, otwórz dowolny plik z .bicep rozszerzeniem pliku. Powinieneś zobaczyć, jak tryb języka w prawym dolnym rogu zmienia się na Bicep.

Zrzut ekranu przedstawiający tryb języka Bicep.

Jeśli podczas instalacji wystąpi błąd, zobacz Rozwiązywanie problemów z instalacją aplikacji Bicep.

Pliki Bicep można wdrożyć bezpośrednio z poziomu edytora programu Visual Studio Code. Aby uzyskać więcej informacji, zobacz Wdrażanie plików Bicep za pomocą programu Visual Studio Code.

Konfigurowanie rozszerzenia Bicep

Aby wyświetlić ustawienia:

  1. View Z menu wybierz pozycję Extensions.

  2. Wybierz Bicep z listy rozszerzeń.

  3. Wybierz kartę FEATURE CONTRIBUTIONS :

    Zrzut ekranu przedstawiający ustawienia rozszerzenia Bicep.

    Rozszerzenie Bicep ma następujące ustawienia i wartości domyślne:

    Identyfikator Wartość domyślna opis
    bicep.decompileOnPaste prawda Automatycznie konwertuj wklejane wartości JSON, szablony JSON usługi Azure Resource Manager (szablony ARM) lub zasoby z szablonu ARM na Bicep (użyj funkcji Cofnij, aby przywrócić). Aby uzyskać więcej informacji, zobacz polecenie Wklej JSON jako Bicep.
    bicep.enableOutputTimestamps prawda Poprzedzić każdą linię wyświetlaną w kanale wyjściowym Bicep Operations znacznikiem czasowym.
    bicep.suppressedWarnings Ostrzeżenia, które są pomijane, ponieważ przycisk "Nie pokazuj ponownie" został naciśnięty. Usuń elementy, aby zresetować.
    bicep.enableSurveys prawda Umożliwiaj okazjonalne ankiety, aby zbierać opinie, które pomagają nam ulepszyć rozszerzenie Bicep.
    bicep.uzupełnienia.getAllAccessibleAzureContainerRegistries (assuming context requires translation) fałsz Podczas kończenia odwołań do modułu "br:" wykonaj zapytanie dotyczące platformy Azure dla wszystkich rejestrów kontenerów dostępnych dla użytkownika (może być powolne). Jeśli ta opcja jest wyłączona, zostaną wyświetlone tylko rejestry skonfigurowane w obszarze moduleAliases w plikach bicepconfig.json.
    bicep.trace.server wył. Skonfiguruj śledzenie komunikatów wysyłanych na serwer języka Bicep.

Aby skonfigurować ustawienia:

  1. W menu Plik wybierz pozycję Preferencje, a następnie pozycję Ustawienia.

  2. Rozwiń Rozszerzenia, aby wybrać Bicep:

    Zrzut ekranu przedstawiający konfigurowanie ustawień rozszerzenia Bicep.

Rozszerzenie Visual Studio i Bicep

Aby utworzyć plik Bicep z poziomu programu Visual Studio, potrzebne są następujące elementy:

  • Visual Studio — jeśli nie masz jeszcze programu Visual Studio , zainstaluj go.
  • Rozszerzenie Bicep dla programu Visual Studio. Program Visual Studio z rozszerzeniem Bicep zapewnia obsługę języka i automatyczne uzupełnianie zasobów. Rozszerzenie ułatwia tworzenie i weryfikowanie plików Bicep. Zainstaluj rozszerzenie z witryny Visual Studio Marketplace.

Aby zapoznać się z samouczkiem, zobacz Szybki start: tworzenie plików Bicep za pomocą programu Visual Studio.

Interfejs wiersza polecenia platformy Azure

W przypadku korzystania z interfejsu wiersza polecenia platformy Azure z aplikacją Bicep masz wszystko, czego potrzebujesz do wdrożenia i dekompilowania plików Bicep. Azure CLI automatycznie instaluje Bicep CLI, gdy wykonywane jest polecenie, które tego wymaga.

Musisz mieć zainstalowany interfejs wiersza polecenia platformy Azure w wersji 2.20.0 lub nowszej . Aby zainstalować lub zaktualizować interfejs wiersza polecenia platformy Azure w różnych systemach operacyjnych, zobacz:

Aby sprawdzić bieżącą wersję, uruchom:

az --version

Aby zweryfikować instalację interfejsu wiersza polecenia Bicep, użyj:

az bicep version

Aby przeprowadzić uaktualnienie do najnowszej wersji, użyj:

az bicep upgrade

Aby uzyskać więcej poleceń, zobacz Bicep CLI.

Ważne

Azure CLI instaluje samodzielne wystąpienie Bicep CLI. To wystąpienie nie powoduje konfliktu z żadnymi wersjami, które mogły zostać zainstalowane ręcznie. Interfejs CLI platformy Azure nie dodaje CLI Bicep do PATH.

Skończysz z konfigurowaniem środowiska Bicep. W pozostałej części tego artykułu opisano kroki instalacji, których nie potrzebujesz podczas korzystania z interfejsu wiersza polecenia platformy Azure.

Azure PowerShell

Musisz mieć zainstalowany program Azure PowerShell w wersji 5.6.0 lub nowszej . Aby zaktualizować lub zainstalować, zobacz Instalowanie programu Azure PowerShell.

Program Azure PowerShell nie instaluje automatycznie interfejsu wiersza polecenia Bicep. Zamiast tego należy ręcznie zainstalować Bicep CLI.

Ważne

Samodzielne wystąpienie interfejsu wiersza polecenia Bicep zainstalowanego przez Azure CLI nie jest dostępne dla poleceń PowerShell. Wdrożenia programu Azure PowerShell kończą się niepowodzeniem, jeśli nie zainstalowano ręcznie interfejsu wiersza polecenia Bicep.

Po ręcznym zainstalowaniu interfejsu wiersza polecenia Bicep uruchom polecenia Bicep za pomocą składni bicep zamiast składni az bicep dla interfejsu wiersza polecenia platformy Azure.

Aby sprawdzić wersję Bicep CLI, uruchom:

bicep --version

Instalowanie ręczne

Poniższe metody instalują interfejs wiersza polecenia Bicep i dodają go do PATH. Należy ręcznie zainstalować do każdego użytku innego niż Azure CLI.

Podczas instalowania ręcznie wybierz lokalizację inną niż ta zarządzana przez interfejs wiersza polecenia platformy Azure. Wszystkie poniższe przykłady używają lokalizacji o nazwie bicep lub .bicep. Ta lokalizacja nie spowoduje konfliktu z lokalizacją zarządzaną przez Azure CLI, która używa .azure.

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!

Uwaga

W przypadku lekkich dystrybucji systemu Linux, takich jak Alpine, użyj bicep-linux-musl-x64 zamiast bicep-linux-x64 w poprzednim skrypcie.

macOS

Za pośrednictwem oprogramowania homebrew

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

Za pośrednictwem powłoki 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!

Uwaga

Instalacja interfejsu wiersza polecenia Bicep w wersji 0.16.X lub nowszej nie wymaga wyjątku dla programu Gatekeeper. Niemniej jednak nocne kompilacje Bicep CLI nadal wymagają wyjątku.

Windows

Instalator systemu Windows

Pobierz i uruchom najnowszy instalator systemu Windows. Instalator nie wymaga uprawnień administracyjnych. Po zakończeniu instalacji dodawany jest Bicep CLI do PATH użytkownika. Zamknij i otwórz ponownie wszystkie otwarte okna powłoki poleceń, aby zmiany PATH zaczęły obowiązywać.

Czekoladka

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

Podręcznik z 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!

Instalacja w odizolowanej chmurze

Polecenia bicep install i bicep upgrade nie działają w środowisku odizolowanym od sieci. Aby zainstalować interfejs wiersza polecenia Bicep w środowisku bez dostępu do sieci, musisz ręcznie pobrać plik wykonywalny interfejsu wiersza polecenia Bicep i zapisać go do .azure/bin. W tej lokalizacji jest zainstalowane wystąpienie zarządzane przez interfejs wiersza polecenia platformy Azure.

  • Linux

    1. Pobierz plik bicep-linux-x64 ze strony wydania Bicep w środowisku niezwiązanym z powietrzem.
    2. Skopiuj plik wykonywalny do katalogu $HOME/.azure/bin na maszynie bez dostępu do sieci. Zmień nazwę pliku na bicep.

  • macOS

    1. Pobierz bicep-osx-x64 ze strony wydania Bicep w środowisku, które nie jest odizolowane.
    2. Skopiuj plik wykonywalny do katalogu $HOME/.azure/bin na maszynie odizolowanej od sieci. Zmień nazwę pliku na bicep.

  • Windows

    1. Pobierz bicep-win-x64.exe ze strony z wydaniami Bicep w środowisku z dostępem do sieci.
    2. Skopiuj plik wykonywalny do katalogu %UserProfile%/.azure/bin na odizolowanej od sieci maszynie. Zmień nazwę pliku na bicep.exe.

W przypadku korzystania z zadania Azure CLI w chmurze bez dostępu do internetu należy ustawić właściwość zadania na useGlobalConfig. Domyślna wartość to false. Zobacz przykład CI/CD z usługą Azure Pipelines i plikami Bicep (Ciągła integracja/Ciągłe wdrażanie za pomocą Azure Pipelines i plików Bicep).

Instalowanie nocnych kompilacji

Jeśli chcesz wypróbować najnowsze wersje wstępne aplikacji Bicep przed ich wydaniem, zobacz Instalowanie nocnych kompilacji.

Ostrzeżenie

Te kompilacje przed wydaniem są znacznie bardziej narażone na znane lub nieznane usterki.

Instalowanie pakietu NuGet

Zespół Bicep udostępnił pakiet NuGet Azure.Bicep.Core publicznie na nuget.org. Chociaż jest on dostępny publicznie, nie jest to obsługiwany pakiet. Każda zależność, którą podejmujesz z tym pakietem, jest na własne ryzyko, a firma Microsoft zastrzega sobie prawo do wprowadzania niekompatybilnych zmian do tego pakietu w każdej chwili.

Aby uzyskać więcej informacji na temat instalowania i używania pakietów NuGet, zobacz przepływ pracy Użycie pakietu.

Następne kroki