A Bicep-környezet konfigurálása

A Bicep támogatja a bicepconfig.json nevű opcionális konfigurációs fájlt. Ebben a fájlban olyan értékeket adhat hozzá, amelyek testre szabják a Bicep fejlesztési élményét. Ez a fájl egyesül az alapértelmezett konfigurációs fájllal. További információ: Az egyesítési folyamat ismertetése. A konfiguráció testreszabásához hozzon létre egy konfigurációs fájlt ugyanabban a könyvtárban vagy a Bicep-fájlok szülőkönyvtárában. Ha több szülőkönyvtár is tartalmaz bicepconfig.json fájlokat, a Bicep a legközelebbi konfigurációt használja. További információ: A fájlfeloldási folyamat ismertetése.

A Bicep-bővítmény beállításainak konfigurálásához tekintse meg a Visual Studio Code és a Bicep bővítményt.

A konfigurációs fájl létrehozása a Visual Studio Code-ban

A konfigurációs fájl létrehozásához bármilyen szövegszerkesztőt használhat.

Ha bicepconfig.json fájlt szeretne létrehozni a Visual Studio Code-ban, nyissa meg a parancskatalógust ([CTRL/CMD]+[SHIFT]+P), majd válassza a Bicep: Bicep konfigurációs fájl létrehozása lehetőséget. További információ: Bicep-konfigurációs fájl létrehozása.

A Visual Studio Code Bicep-bővítménye támogatja az IntelliSense-t bicepconfig.json fájlokhoz. Az IntelliSense használatával felderítheti az elérhető tulajdonságokat és értékeket.

Az egyesítési folyamat ismertetése

A bicepconfig.json fájl rekurzív alulról felfelé egyesítési folyamaton megy keresztül az alapértelmezett konfigurációs fájllal. Az egyesítési folyamat során a Bicep mindkét konfigurációban megvizsgálja az egyes útvonalakat. Ha egy elérési út nem szerepel az alapértelmezett konfigurációban, az elérési út és a hozzá tartozó érték hozzáadódik a végeredményhez. Ezzel szemben, ha az alapértelmezett konfigurációban egy másik értékkel rendelkező elérési út található, akkor a bicepconfig.json értéke elsőbbséget élvez az egyesített eredményben.

Fontolja meg azt a forgatókönyvet, amelyben az alapértelmezett konfiguráció a következőképpen van definiálva:

{
  "cloud": {
    ...
    "credentialPrecedence": [
      "AzureCLI",
      "AzurePowerShell"
    ]
  },
  "moduleAliases": {
    "ts": {},
    "br": {
      "public": {
        "registry": "mcr.microsoft.com",
        "modulePath": "bicep"
      }
    }
  },
  ...
}

A bicepconfig.json pedig az alábbiak szerint van definiálva:

{
  "cloud": {
    "credentialPrecedence": [
      "AzurePowerShell",
      "AzureCLI"
    ]
  },
  "moduleAliases": {
    "br": {
      "ContosoRegistry": {
        "registry": "contosoregistry.azurecr.io"
      },
      "CoreModules": {
        "registry": "contosoregistry.azurecr.io",
        "modulePath": "bicep/modules/core"
      }
    }
  }
}

Az eredményül kapott egyesített konfiguráció a következő:

{
  "cloud": {
    ...
    "credentialPrecedence": [
      "AzurePowerShell",
      "AzureCLI"
    ]
  },
  "moduleAliases": {
    "ts": {},
    "br": {
      "public": {
        "registry": "mcr.microsoft.com",
        "modulePath": "bicep"
      },
      "ContosoRegistry": {
        "registry": "contosoregistry.azurecr.io"
      },
      "CoreModules": {
        "registry": "contosoregistry.azurecr.io",
        "modulePath": "bicep/modules/core"
      }
    }
  },
  ...
}

Az előző példában a rendszer lecseréli az értékeketcloud.credentialPrecedence, míg az egyesített konfiguráció értékeit cloud.moduleAliases.CoreModulescloud.moduleAliases.ContosoRegistry hozzáfűzi.

A fájlfeloldási folyamat ismertetése

A bicepconfig.json fájl ugyanabban a könyvtárban vagy a Bicep-fájlok szülőkönyvtárában helyezhető el. Ha több szülőkönyvtár is tartalmaz bicepconfig.json fájlokat, a Bicep a legközelebbi konfigurációs fájlt használja. Például abban a mappastruktúrában, amelyben minden mappa bicepconfig.json fájllal rendelkezik:

Ha a main.bicep fájlt a child mappában fordítja le, a rendszer a mappában lévő child bicepconfig.json fájlt használja. A rendszer figyelmen kívül hagyja a parent mappában és a root mappában lévő konfigurációs fájlokat. Ha a child mappa nem tartalmaz konfigurációs fájlt, a Bicep egy konfigurációt keres a parent mappában, majd a root mappát. Ha egyik mappában sem található konfigurációs fájl, a Bicep alapértelmezés szerint az alapértelmezett értékeket használja.

A több modult invokáló Bicep-fájl kontextusában minden modul fordításon megy keresztül a legközelebbi bicepconfig.json használatával. Ezután a fő Bicep-fájl a hozzá tartozó bicepconfig.json lesz lefordítva. Az alábbi forgatókönyvben modA.bicep a rendszer a mappában A található bicepconfig.json használatával fordítja le, modB.bicep a bicepconfig.json a mappábanB, végül pedig a main.bicep a mappában található root bicepconfig.json használatával lesz lefordítva.

Ha nincs bicepconfig.json fájl a AB mappában, a rendszer mind a három Bicep-fájlt a mappában root található bicepconfig.json használatával állítja össze. Ha bicepconfig.json egyik mappában sem szerepel, a fordítás alapértelmezés szerint az alapértelmezett értékeket használja.

Bicep-modulok konfigurálása

A modulok használatakor aliasokat adhat hozzá a modul elérési útjaihoz. Ezek az aliasok leegyszerűsítik a Bicep-fájlt, mert nem kell bonyolult útvonalakat megismételnie. A felhőprofil és a hitelesítő adatok elsőbbséget is konfigurálhat az Azure-ba való hitelesítéshez a Bicep CLI-ből és a Visual Studio Code-ból. A hitelesítő adatokkal modulok tehetők közzé a regisztrációs adatbázisokban, és visszaállíthatók a külső modulok a helyi gyorsítótárba az erőforrásfüggvény beszúrásakor. További információ: Modulbeállítások hozzáadása a Bicep konfigurációhoz.

Linter-szabályok konfigurálása

A Bicep-linter szintaxishibákat és ajánlott eljárásokat keres a Bicep-fájlokban. Módosíthatja a bicepconfig.json fájlokat, hogy felülbírálják a Bicep-fájlok érvényesítésének alapértelmezett beállításait. További információ: Linter-beállítások hozzáadása a Bicep konfigurációhoz.

Kísérleti funkciók engedélyezése

A kísérleti funkciók engedélyezéséhez adja hozzá a következő szakaszt a bicepconfig.json fájlhoz. A kísérleti funkciók automatikusan lehetővé teszik a 2.0-s verziójú kódgenerálást.

Íme egy példa a funkciók "helyességi" és a "testFramework" engedélyezésére.

{
  "experimentalFeaturesEnabled": {
    "assertions": true,
    "testFramework": true
  }
}

A Bicep kísérleti funkcióival kapcsolatos további információkért tekintse meg a Kísérleti funkciók című témakört.

Következő lépések

• Megtudhatja, hogyan adhat hozzá modulbeállításokat és linterbeállításokat a Bicep konfigurációs fájlban.
• Tudnivalók a Bicep linterről.