Install Bicep tools

Készítse elő a környezetet a Bicep-fájlok használatához. A Bicep-fájlok létrehozásához és üzembe helyezéséhez az alábbi lehetőségek bármelyikét javasoljuk:

Tevékenységek	Beállítások	Bicep CLI telepítése
Szerző	Visual Studio Code és Bicep bővítmény	automatikus
	Visual Studio és Bicep bővítmény	automatikus
Üzembe helyezés	Azure CLI	automatikus
	Azure PowerShell	kézikönyv
	Visual Studio Code és Bicep bővítmény	kézikönyv
	Air-gapped cloud	letöltés

Figyelmeztetés

A Bicep CLI stabilitása az emulált környezetekben nem garantált, mivel az olyan emulációs eszközök, mint a Rosetta2 és a QEMU, általában nem tökéletesen emulálják az architektúrát.

Visual Studio Code és Bicep bővítmény

Bicep-fájlok létrehozásához egy jó Bicep-szerkesztőre van szükség. Az alábbiakat javasoljuk:

• Visual Studio Code – Ha még nem rendelkezik Visual Studio Code-dal, telepítse.

• Bicep-bővítmény a Visual Studio Code-hoz. A Visual Studio Code és a Bicep bővítmény nyelvi támogatást és automatikus erőforrás-kiegészítést biztosít. A bővítmény segít a Bicep-fájlok létrehozásában és ellenőrzésében.

  A bővítmény telepítéséhez keresse meg a bicep-et a Bővítmények lapon vagy a Visual Studio piactéren.

  Válassza a Telepítés lehetőséget.

  

Ha ellenőrizni szeretné, hogy telepítette-e a bővítményt, nyissa meg a .bicep fájlkiterjesztéssel rendelkező fájlokat. You should see the language mode in the lower-right corner change to Bicep.

Ha a telepítés során hibaüzenetet kap, tekintse meg a Bicep telepítésének hibaelhárítását.

A Bicep-fájlokat közvetlenül a Visual Studio Code-szerkesztőből telepítheti. További információ: Bicep-fájlok üzembe helyezése a Visual Studio Code-ban.

Configure Bicep extension

A beállítások megtekintése:

1. A View menüben válassza a Extensions.

2. Válasszon Bicep a bővítmények listájából.

3. Válassza ki a FEATURE CONTRIBUTIONS lapot:

   

   A Bicep-bővítmény a következő beállításokkal és alapértelmezett értékekkel rendelkezik:

   ID (Azonosító)	Alapértelmezett érték	Leírás
   bicep.decompileOnPaste	igaz	A beillesztett JSON-értékeket, az Azure Resource Manager JSON-sablonjait (ARM-sablonok) vagy az erőforrásokat automatikusan Bicep formátumba konvertálja (a Visszavonás használatával visszavonhatja). További információért lásd a JSON beillesztése Bicep parancsként parancsot.
   bicep.enableOutputTimestamps	igaz	Prepend each line displayed in the Bicep Operations output channel with a timestamp.
   bicep.suppressedWarnings		Warnings that are being suppressed because a 'Don't show again' button was pressed. Távolítsa el az alaphelyzetbe állítandó elemeket.
   bicep.enableSurveys	igaz	Lehetővé teszi az alkalmi felmérések használatát olyan visszajelzések gyűjtéséhez, amelyek segítenek a Bicep-bővítmény fejlesztésében.
   bicep.completions.getAllAccessibleAzureContainerRegistries	false	A "br:" modulhivatkozások elvégzésekor lekérdezheti az Azure-t a felhasználó számára elérhető összes tárolóregisztrációs adatbázishoz (lehet, hogy lassú). Ha ez a beállítás ki van kapcsolva, csak a moduleAliases modulban konfigurált adatbázisok jelennek meg bicepconfig.json fájlokban.
   bicep.trace.server	off	Konfigurálja a Bicep nyelvi kiszolgálónak küldött üzenetek nyomkövetését.

A beállítások konfigurálása:

1. A Fájl menüben válassza a Beállítások, majd a Beállítások lehetőséget.

2. A Bővítmény kibontásával válassza ki a Bicep-et:

   

Visual Studio és Bicep bővítmény

A Bicep-fájl Visual Studióból való létrehozásához a következőkre van szükség:

• Visual Studio – Ha még nem rendelkezik Visual Studióval, telepítse.
• Bicep-bővítmény a Visual Studióhoz. A Bicep-bővítményt tartalmazó Visual Studio nyelvi támogatást és erőforrás-automatikus kiegészítést biztosít. A bővítmény segít a Bicep-fájlok létrehozásában és ellenőrzésében. Telepítse a bővítményt a Visual Studio Marketplace-ről.

Az oktatóanyag áttekintéséhez tekintse meg a Rövid útmutatót: Bicep-fájlok létrehozása a Visual Studióval.

Azure CLI

Ha az Azure CLI-t a Bicep-lel használja, minden rendelkezésére áll, ami a Bicep-fájlok üzembe helyezéséhez és felbontásához szükséges. Az Azure CLI automatikusan telepíti a Bicep CLI-t, amikor végrehajt egy parancsot, amely szüksége van rá.

Az Azure CLI 2.20.0-s vagy újabb verziójával kell rendelkeznie. Az Azure CLI különböző operációs rendszereken való telepítéséhez vagy frissítéséhez lásd:

• Telepítés Windowsra
• Telepítés Linuxon
• Telepítés macOS rendszeren

Az aktuális verzió ellenőrzéséhez futtassa a következőt:

az --version

A Bicep CLI telepítésének ellenőrzéséhez használja a következőt:

az bicep version

A legújabb verzióra való frissítéshez használja a következőt:

az bicep upgrade

További parancsok: Bicep CLI.

Fontos

Az Azure CLI telepíti a Bicep CLI egy önálló példányát. Ez a példány nem ütközik azokkal a verziókkal, amelyeket manuálisan telepítettél. Az Azure CLI nem adja hozzá a Bicep CLI-t a PATH-hoz.

A Bicep környezet beállításával elkészültél. A cikk további része azOkat a telepítési lépéseket ismerteti, amelyekre az Azure CLI használatakor nincs szüksége.

Azure PowerShell

Az Azure PowerShell 5.6.0-s vagy újabb verziójának telepítve kell lennie. A frissítésről és a telepítésről az Azure PowerShell telepítése című témakörben olvashat.

Az Azure PowerShell nem telepíti automatikusan a Bicep CLI-t. Ehelyett manuálisan kell telepítenie a Bicep CLI-t.

Fontos

Az Azure CLI által telepített Bicep CLI önálló példánya nem érhető el PowerShell-parancsokhoz. Az Azure PowerShell üzembe helyezései meghiúsulnak, ha még nem telepítette manuálisan a Bicep CLI-t.

A Bicep CLI manuális telepítésekor futtassa a Bicep-parancsokat az bicep Azure CLI szintaxisa helyett a az bicep szintaxissal.

A Bicep CLI verziójának ellenőrzéséhez futtassa a következőt:

bicep --version

Manuális telepítés

Az alábbi metódusok telepítik a Bicep CLI-t, és hozzáadják a PATH-hoz. Manuálisan kell telepítenie az Azure CLI-t nem használó használatra.

Manuálisan történő telepítéskor válasszon ki egy olyan helyet, amely eltér az Azure CLI által felügyelt helytől. Az alábbi példák mindegyike egy bicep vagy .bicep nevű helyet használ. Ez a hely nem ütközik az Azure CLI által felügyelt helytel, amely az .azure-t használja.

• 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

Az alpine-hez hasonló egyszerű Linux-disztribúciókhoz használja a bicep-linux-musl-x64-et a bicep-linux-x64 helyett az előző szkriptben.

macOS

Via homebrew

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

BASH-en keresztül

# 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

A Bicep CLI 0.16.X-es vagy újabb verziójának telepítése nem igényel Gatekeeper-kivételt. A Bicep CLI éjszakai buildjei azonban továbbra is kivételt igényelnek.

Windows

Windows Installer

Töltse le és futtassa a legújabb Windows-telepítőt. A telepítő nem igényel rendszergazdai jogosultságokat. A telepítés után a Bicep CLI hozzáadódik a felhasználói ELÉRÉSI ÚT-hoz. Zárja be és nyissa meg újra a nyitott parancshéj ablakait a PATH-módosítás érvénybe lépéséhez.

Chocolatey

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

Kézikönyv a PowerShell használatához

# 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!

Install on air-gapped cloud

A bicep install és bicep upgrade parancsok nem működnek egy hálózattól elzárt környezetben. Ahhoz, hogy a Bicep CLI-t zárt hálózati környezetben telepítse, manuálisan kell letöltenie a Bicep CLI végrehajtható fájlt, és az .azure/bin mappába kell mentenie. Ezen a helyen települ az Azure CLI által felügyelt példány.

• Linux

  1. Download bicep-linux-x64 from the Bicep release page in a non-air-gapped environment.
  2. Másolja a végrehajtható fájlt a $HOME/.azure/bin könyvtárba egy elszigetelt gépen. A fájl átnevezése bicep névre.

• macOS

  1. Töltse le a bicep-osx-x64 fájlt a Bicep kiadási oldaláról egy nem levegőtől elzárt környezetben.
  2. Másolja a végrehajtható fájlt a $HOME/.azure/bin könyvtárba egy elszigetelt gépen. A fájl átnevezése bicep névre.

• Windows

  1. Töltse le a bicep-win-x64.exe fájlt a Bicep kiadási oldaláról, nem elszigetelt környezetben.
  2. Másolja a végrehajtható fájlt a %UserProfile%/.azure/bin könyvtárba egy hálózattól elzárt gépen. Nevezze át a fájlt bicep.exe-re.

Ha az Azure CLI-feladatot levegőalapú felhőben használja, a useGlobalConfig feladat tulajdonságát a következőre truekell beállítania: . Az alapértelmezett érték false. Példaként tekintse meg az Azure Pipelines- és Bicep-fájlokat tartalmazó CI/CD-t .

Az éjszakai buildek telepítése

Ha ki szeretné próbálni a Bicep legújabb előzetes verzióit a kiadás előtt, olvassa el az Éjszakai buildek telepítése című témakört.

Figyelmeztetés

Ezek a kiadás előtti buildek sokkal valószínűbbek, hogy ismert vagy ismeretlen hibákkal rendelkeznek.

A NuGet-csomag telepítése

A Bicep csapata nyilvánosan elérhetővé tette az Azure.Bicep.Core NuGet-csomagot nuget.org. Bár nyilvános, nem támogatott csomag. Any dependency you take on this package will be done at your own risk, and Microsoft reserves the right to push breaking changes to this package at any time.

További információ a NuGet-csomagok telepítéséről és felhasználásáról: Csomaghasználati munkafolyamat.

Következő lépések

• A Visual Studio Code és a Bicep bővítmény használatával kapcsolatos további információkért tekintse meg a Rövid útmutatót: Bicep-fájlok létrehozása a Visual Studio Code-tal.
• Ha problémákat tapasztal a Bicep telepítésével kapcsolatban, tekintse meg a Bicep telepítésének hibaelhárítását.
• Bicep-fájlok Azure Pipeline-ból való üzembe helyezéséhez tekintse meg a Bicep és az Azure Pipelines integrálása című rövid útmutatót. A Bicep-fájlok GitHub Actionsen keresztüli üzembe helyezéséhez tekintse meg a Rövid útmutatót: Bicep-fájlok üzembe helyezése a GitHub Actions használatával.