Bicep-fájlok létrehozása a Visual Studio Code használatával

  • Cikk

Ez a cikk bemutatja, hogyan hozhat létre Bicep-fájlokat a Visual Studio Code használatával.

A VS Code telepítése

A környezet Bicep-fejlesztéshez való beállításához lásd: A Bicep-eszközök telepítése. A lépések elvégzése után a Visual Studio Code és a Bicep bővítmény is elérhető lesz. A legújabb Azure CLI-vel vagy a legújabb Azure PowerShell modullal is rendelkezik.

Bicep-parancsok

A Visual Studio Code számos Bicep-parancsot tartalmaz.

Nyisson meg vagy hozzon létre egy Bicep-fájlt a VS Code-ban, válassza a Nézet menüt, majd válassza a Parancskatalógus lehetőséget. Az F1 billentyűkombinációval vagy a Ctrl+Shift+P billentyűkombinációval is felveheti a parancskatalógust. A Bicep-parancsok listázásához írja be a Bicep parancsot.

Képernyőkép a Visual Studio Code Bicep-parancsokról a parancskatalógusban.

Ezek a parancsok a következők:

Ezek a parancsok akkor is megjelennek a helyi menüben, ha a jobb gombbal egy Bicep-fájlra kattint:

Képernyőkép a Visual Studio Code Bicep-parancsokról a Bicep-fájlok helyi menüjében.

Amikor a jobb gombbal egy JSON-fájlra kattint:

Képernyőkép a Visual Studio Code Bicep-parancsokról az ARM JSON-sablonok helyi menüjében.

ARM-sablon létrehozása

A build parancs Egy Bicep-fájlt Azure Resource Manager-sablonlá (ARM-sablon) alakít át. Az új JSON-sablon ugyanabban a mappában található, ugyanazzal a fájlnévvel. Ha ugyanazzal a fájlnévvel rendelkező fájl létezik, felülírja a régi fájlt. További információ: Bicep CLI-parancsok.

Bicep-konfigurációs fájl létrehozása

A Bicep-konfigurációs fájl (bicepconfig.json) segítségével testre szabhatja a Bicep fejlesztési élményét. Több címtárban is felvehető bicepconfig.json . A rendszer a címtárhierarchiában található bicep-fájlhoz legközelebb eső konfigurációs fájlt használja. Ha ezt a parancsot választja, a bővítmény megnyit egy párbeszédpanelt a mappa kiválasztásához. Az alapértelmezett mappa az, ahol a Bicep-fájlt tárolja. Ha már létezik fájl bicepconfig.json a mappában, felülírhatja a meglévő fájlt.

Bicep-konfigurációs fájl létrehozása:

  1. Nyissa meg a Visual Studio Code-ot.
  2. A Nézet menüben válassza a Parancskatalógus lehetőséget (vagy nyomja le a Ctrl/Cmd+Shift+P billentyűkombinációt), majd válassza a Bicep: Bicep konfigurációs fájl létrehozása lehetőséget.
  3. Válassza ki azt a fájlkönyvtárat, ahová a fájlt el szeretné helyezni.
  4. Ha elkészült, mentse a konfigurációs fájlt.

Bomlasztás a Bicep-be

Ez a parancs felbont egy ARM JSON-sablont egy Bicep-fájlba, és ugyanabban a könyvtárban helyezi el, mint az ARM JSON-sablon. Az új fájl neve megegyezik a .bicep kiterjesztéssel. Ha egy azonos fájlnévvel rendelkező Bicep-fájl már létezik ugyanabban a mappában, a Visual Studio Code megkéri, hogy írja felül a meglévő fájlt, vagy hozzon létre egy másolatot.

Bicep-fájl üzembe helyezése

Bicep-fájlokat közvetlenül a Visual Studio Code-ból helyezhet üzembe. Válassza a Bicep-fájl üzembe helyezése lehetőséget a parancskatalógusban vagy a helyi menüben. A bővítmény arra kéri, hogy jelentkezzen be az Azure-ba, válassza ki az előfizetést, hozzon létre/válasszon erőforráscsoportot, és adja meg a paraméterértékeket.

Megjegyzés

A Bicep üzembe helyezési parancsa a vscode-on belülről az Azure-fiók bővítményt használja a hitelesítéshez. Nem használja a bicepconfig.json felhőprofiljait.

Paraméterfájl létrehozása

Ez a parancs egy paraméterfájlt hoz létre ugyanabban a mappában, mint a Bicep-fájl. Létrehozhat egy Bicep-paraméterfájlt vagy egy JSON-paraméterfájlt. Az új Bicep paraméterfájl neve <bicep-file-name>.bicepparam, míg az új JSON paraméterfájl neve <bicep-file-name>.parameters.json.

Kubernetes-jegyzék importálása (előzetes verzió)

Ez a parancs importál egy Kubernetes-jegyzékfájlt, és létrehoz egy Bicep-modult. További információ: Bicep bővíthetőségi Kubernetes-szolgáltató és rövid útmutató: Azure-alkalmazások üzembe helyezése Azure Kubernetes Service (AKS-) fürtön a Bicep Kubernetes-szolgáltató (előzetes verzió) használatával.

Erőforrás beszúrása

A insert resource parancs hozzáad egy erőforrás-deklarációt a Bicep-fájlhoz egy meglévő erőforrás erőforrás-azonosítójának megadásával. Az Erőforrás beszúrása lehetőség kiválasztása után adja meg az erőforrás-azonosítót a parancskatalógusban. Az erőforrás beszúrása néhány percet vesz igénybe.

Az erőforrás-azonosítót az alábbi módszerek egyikével keresheti meg:

A sablonok exportálásához hasonlóan a folyamat egy használható erőforrást próbál létrehozni. A beszúrt erőforrások többsége azonban némi módosítást igényel az Azure-erőforrások üzembe helyezéséhez.

További információt az ARM-sablon JSON-ból Bicep-be történő felbontásáról szóló cikkben talál.

Bicep-vizualizáció megnyitása

A vizualizáció megjeleníti a Bicep-fájlban definiált erőforrásokat az erőforrás-függőségi adatokkal. A diagram egy Linux rendszerű Bicep-fájl vizualizációja.

Visual Studio Code Bicep-vizualizáció

A vizualizációt egymás mellett is megnyithatja a Bicep-fájllal.

Bicep-modulok visszaállítása

Ha a Bicep-fájl egy beállításjegyzékben közzétett modulokat használ, a visszaállítási parancs lekéri az összes szükséges modul másolatát a beállításjegyzékből. Ezeket a másolatokat egy helyi gyorsítótárban tárolja. További információ: visszaállítás.

Típusdokumentum megtekintése

A Visual Studio Code-ból egyszerűen megnyithatja a sablonhivatkozást ahhoz az erőforrástípushoz, amelyen dolgozik. Ehhez vigye a kurzort az erőforrás szimbolikus nevére, majd válassza a Dokumentum megtekintése elemet.

Képernyőkép a Visual Studio Code Bicep nézettípusú dokumentumáról.

Beillesztés Bicep-ként

Egy JSON-kódrészletet egy ARM-sablonból beilleszthet a Bicep-fájlba. A Visual Studio Code automatikusan lebontja a JSON-t a Bicep-be. Ez a funkció csak a Bicep-bővítmény 0.14.0-s vagy újabb verziójával érhető el. Ez a funkció alapértelmezés szerint engedélyezve van. A funkció letiltásához lásd a VS Code és a Bicep bővítményt.

Ezzel a funkcióval beillesztheti a következőt:

  • Teljes ARM JSON-sablonok.
  • Egy vagy több erőforrás.
  • JSON-értékek, például objektumok, tömbök és sztringek. A kettős idézőjeleket tartalmazó sztringeket a rendszer egy idézőjelekké alakítja.

Például a következő Bicep-fájllal kezdhet:

@description('Storage Account type')
@allowed([
  'Standard_LRS'
  'Standard_GRS'
  'Standard_ZRS'
  'Premium_LRS'
])
param storageAccountsku string = 'Standard_LRS'

@description('Location for all resources.')
param location string = resourceGroup().location

var storageAccountName = '${uniqueString(resourceGroup().id)}storage'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-08-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: storageAccountsku
  }
  kind: 'StorageV2'
  tags: {
    ObjectName: storageAccountName
  }
  properties: {}
}

output storageAccountName string = storageAccountName

Illessze be a következő JSON-t:

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2021-06-01",
  "name": "[parameters('batchAccountName')]",
  "location": "[parameters('location')]",
  "tags": {
    "ObjectName": "[parameters('batchAccountName')]"
  },
  "properties": {
    "autoStorage": {
      "storageAccountId": "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
    }
  }
}

A Visual Studio Code automatikusan bicep-mé alakítja a JSON-t. Figyelje meg, hogy a nevű batchAccountNameparamétert is hozzá kell adnia.

A felbontást a Ctrl+Z billentyűkombinációval vonhatja vissza. Az eredeti JSON megjelenik a fájlban.

Következő lépések

A rövid útmutatót a Rövid útmutató: Bicep-fájlok létrehozása a Visual Studio Code-tal című témakörben tekintheti meg.