A Bicep-eszközök telepítése

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:

Tasks	Beállítások	Bicep CLI telepítése
Author	Visual Studio Code és Bicep bővítmény	automatic
	Visual Studio és Bicep bővítmény	automatic
Deploy	Azure CLI	automatic
	Azure PowerShell	manual
	Visual Studio Code és Bicep bővítmény	manual
	Levegőben leképezett felhő	letölt

Warning

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éslehető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. A jobb alsó sarokban látnia kell, hogy a nyelvi mód Bicepre vált.

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.

Bicep-bővítmény konfigurálása

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(z) FEATURE lapot.

4. Válassza a Beállítások lehetőséget.

   

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

   azonosító	Alapértelmezett érték	Description
   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ázisokat fogja listázni a bicepconfig.json.
   bicep.decompileOnPaste	true	A beillesztett JSON-értékeket, JSON ARM-sablonokat vagy erőforrásokat automatikusan konvertálja egy JSON ARM-sablonból Bicep-re (visszavonással visszaállítható).
   bicep.enableOutputTimestamps	true	A Bicep Operations kimeneti csatornában megjelenő minden sort egy időbélyeggel kell ellátni.
   bicep.enableSurveys	true	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.suppressedWarnings		Az elnyomott figyelmeztetések, mert a "Ne jelenjen meg újra" gombot megnyomták. Távolítsa el az alaphelyzetbe állítandó elemeket.
   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.

Important

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.

Important

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

Házi készítésű módszerrel

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

Telepítés egy elzárt felhőkörnyezetben

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. Töltse le a bicep-linux-x64 fájlt a Bicep kiadási oldaláról egy nem levegőalapú 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.

• 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.

Warning

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. Bármilyen függőséget vállal ezen a csomagon, az ön saját felelősségére történik, és a Microsoft fenntartja a jogot, hogy bármikor bevezessen a csomaghoz kompatibilitástörő módosításokat.

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.