Modulbeállítások hozzáadása a Bicep konfigurációs fájlban

  • Cikk

Egy bicepconfig.json fájlban létrehozhat aliasokat a modulútvonalakhoz, és konfigurálhatja a profilt és a hitelesítő adatok elsőbbséget a modulok közzétételéhez és visszaállításához.

Ez a cikk a Bicep-modulok használatához elérhető beállításokat ismerteti.

Modulok aliasai

A modulokhoz való csatolás útjának egyszerűsítése érdekében hozzon létre aliasokat a konfigurációs fájlban. Az alias egy modulregisztrációs adatbázisra vagy egy sablon-specifikációkat tartalmazó erőforráscsoportra utal.

A konfigurációs fájlnak van egy tulajdonsága a következőhöz moduleAliases: . Ez a tulajdonság az Ön által definiált összes aliast tartalmazza. Ebben a tulajdonságban az aliasok el vannak osztva attól függően, hogy egy beállításjegyzékre vagy egy sablon specifikációjára hivatkoznak.

Ha aliast szeretne létrehozni egy Bicep-beállításjegyzékhez, adjon hozzá egy tulajdonságot br . Ha aliast szeretne hozzáadni egy sablon specifikációhoz, használja a tulajdonságot ts .

{
  "moduleAliases": {
    "br": {
      <add-registry-aliases>
    },
    "ts": {
      <add-template-specs-aliases>
    }
  }
}

A tulajdonságon br belül adjon hozzá annyi aliast, amennyit csak szeretne. Minden aliashoz adjon nevet és a következő tulajdonságokat:

  • beállításjegyzék (kötelező): beállításjegyzék bejelentkezési kiszolgáló neve
  • modulePath (nem kötelező): beállításjegyzék-adattár, ahol a modulokat tárolják

A tulajdonságon ts belül adjon hozzá annyi aliast, amennyit csak szeretne. Minden aliashoz adjon nevet és a következő tulajdonságokat:

  • előfizetés (kötelező): a sablon specifikációit tartalmazó előfizetés-azonosító
  • resourceGroup (kötelező): a sablon specifikációit tartalmazó erőforráscsoport neve

Az alábbi példa egy konfigurációs fájlt mutat be, amely két aliast határoz meg egy modulregisztrációs adatbázishoz, és egy aliast egy olyan erőforráscsoporthoz, amely sablon-specifikációkat tartalmaz.

{
  "moduleAliases": {
    "br": {
      "ContosoRegistry": {
        "registry": "contosoregistry.azurecr.io"
      },
      "CoreModules": {
        "registry": "contosoregistry.azurecr.io",
        "modulePath": "bicep/modules/core"
      }
    },
    "ts": {
      "CoreSpecs": {
        "subscription": "00000000-0000-0000-0000-000000000000",
        "resourceGroup": "CoreSpecsRG"
      }
    }
  }
}

Ha aliast használ a modulhivatkozásban, a következő formátumokat kell használnia:

br/<alias>:<file>:<tag>
ts/<alias>:<file>:<tag>

Adja meg az aliasokat a modulokat tartalmazó mappához vagy erőforráscsoporthoz, nem magához a fájlhoz. A fájlnévnek szerepelnie kell a modulra való hivatkozásban.

Az aliasok nélkül a teljes elérési úttal rendelkező beállításjegyzék egy moduljára hivatkozhat.

module stgModule 'br:contosoregistry.azurecr.io/bicep/modules/core/storage:v1' = {

Az aliasokkal egyszerűsítheti a hivatkozást a beállításjegyzék aliasának használatával.

module stgModule 'br/ContosoRegistry:bicep/modules/core/storage:v1' = {

Vagy egyszerűsítheti a hivatkozást a beállításjegyzéket és a modul elérési útját meghatározó alias használatával.

module stgModule  'br/CoreModules:storage:v1' = {

Sablon specifikációihoz használja a következőt:

module stgModule  'ts/CoreSpecs:storage:v1' = {

Egy alias előre definiálva lett a nyilvános modulregisztrációs adatbázishoz. Nyilvános modulra való hivatkozáshoz a következő formátumot használhatja:

br/public:<file>:<tag>

A nyilvános modul beállításjegyzékének aliasdefinícióját felülbírálhatja a bicepconfig.json fájlban:

{
  "moduleAliases": {
    "br": {
      "public": {
        "registry": "<your_module_registry>",
        "modulePath": "<optional_module_path>"
      }
    }
  }
}

Profilok és hitelesítő adatok konfigurálása

A modulok privát modulregisztrációs adatbázisban való közzétételéhez vagy a külső modulok helyi gyorsítótárba való visszaállításához a fióknak megfelelő engedélyekkel kell rendelkeznie a beállításjegyzék eléréséhez. Manuálisan konfigurálhatja és credentialPrecedence a currentProfile Bicep konfigurációs fájljában hitelesítheti a beállításjegyzéket.

{
  "cloud": {
    "currentProfile": "AzureCloud",
    "profiles": {
      "AzureCloud": {
        "resourceManagerEndpoint": "https://management.azure.com",
        "activeDirectoryAuthority": "https://login.microsoftonline.com"
      },
      "AzureChinaCloud": {
        "resourceManagerEndpoint": "https://management.chinacloudapi.cn",
        "activeDirectoryAuthority": "https://login.chinacloudapi.cn"
      },
      "AzureUSGovernment": {
        "resourceManagerEndpoint": "https://management.usgovcloudapi.net",
        "activeDirectoryAuthority": "https://login.microsoftonline.us"
      }
    },
    "credentialPrecedence": [
      "AzureCLI",
      "AzurePowerShell"
    ]
  }
}

Az elérhető profilok a következők:

  • AzureCloud
  • AzureChinaCloud
  • AzureUSGovernment

A Bicep alapértelmezés szerint az AzureCloud Azure CLI-ben vagy az Azure PowerShellben hitelesített felhasználó profilját és hitelesítő adatait használja. Ezeket a profilokat testre szabhatja, vagy újakat is felvehet a helyszíni környezetekhez. Ha olyan nemzeti felhőkörnyezetben szeretne közzétenni vagy visszaállítani egy modult, mint például AzureUSGovernment, akkor is be kell állítania "currentProfile": "AzureUSGovernment" , ha ezt a felhőprofilt választotta az Azure CLI-ben. A Bicep nem tudja automatikusan meghatározni az aktuális felhőprofilt az Azure CLI-beállítások alapján.

A Bicep az Azure.Identity SDK használatával végez hitelesítést. A rendelkezésre álló hitelesítő adatok típusai a következők:

Feljegyzés

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

Következő lépések