Modulbeállítások hozzáadása a Bicep konfigurációs fájlban
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
- A Bicep-környezet konfigurálása
- Linterbeállítások hozzáadása a Bicep-konfigurációhoz
- Tudnivalók a modulokról