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:

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. A nyelvi módnak a jobb alsó sarokban a Bicepre kell váltania.

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 menüben válassza a View lehetőséget 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	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ó). További információ: A JSON beillesztése Bicep-parancsként.
   bicep.enableOutputTimestamps	true	A Bicep Operations kimeneti csatornában megjelenő sorokat előre fel kell függesztetni egy időbélyeggel.
   bicep.suppressedWarnings		A letiltott figyelmeztetések, mert a "Ne jelenjen meg újra" gombot lenyomták. Távolítsa el az alaphelyzetbe állítandó elemeket.
   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.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	kikapcsolva	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 Bicep kiválasztásához bontsa ki a bővítményeket:

   

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

Elkészült a Bicep-környezet beállításával. 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.

A Bicep CLI manuális telepítésekor az Azure CLI szintaxisa helyett futtassa a bicep Bicep-parancsokat 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 egy olyan helyet, amely eltér az Azure CLI által kezelt helyétő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!

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!

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.

Csokoládés

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

Manuális a PowerShell-lel

# 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 a levegőben csatlakoztatott felhőben

A bicep install parancsok és bicep upgrade a parancsok nem működnek légi környezetben. Ahhoz, hogy a Bicep CLI-t levegőalapú környezetben telepítse, manuálisan kell letöltenie a Bicep CLI-t, és mentenie kell az .azure/bin fájlba. 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 légileképezett gépen. Fájl átnevezése bicep fájlra.

• macOS

  1. Töltse le a bicep-osx-x64 fájlt a Bicep kiadási oldaláról , nem levegővel leképezett környezetben.
  2. Másolja a végrehajtható fájlt a $HOME/.azure/bin könyvtárba egy légileképezett gépen. Fájl átnevezése bicep fájlra.

• Windows

  1. Töltse le bicep-win-x64.exe a Bicep kiadási oldaláról , nem levegőalapú környezetben.
  2. Másolja a végrehajtható fájlt a %UserProfile%/.azure/bin könyvtárba egy légileképezett gépen. Fájl átnevezése bicep.exe.

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.

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. A csomagra vonatkozó függőségek a saját felelősségére lesznek végrehajtva, és fenntartjuk a jogot arra, hogy bármikor leküldjük a csomag kompatibilitástörő módosításait.

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

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.

A Bicep-fájlok Azure Pipeline-ból való üzembe helyezéséhez lásd : Bicep integrálása az Azure Pipelinesszal. A Bicep-fájlok GitHub Actionsen keresztüli üzembe helyezéséről további információt a Bicep-fájlok GitHub Actions használatával történő üzembe helyezéséről talál.