Megosztás a következőn keresztül:

Rövid útmutató: Bicep-modulok közzététele a privát modulregisztrációs adatbázisban

  • Cikk

Megtudhatja, hogyan teheti közzé a Bicep-modulokat a privát modulok regisztrációs adatbázisában, és hogyan hívhatja meg a modulokat a Bicep-fájlokból. A privát modulregisztrációs adatbázis lehetővé teszi a Bicep-modulok megosztását a szervezeten belül. További információ: Privát beállításjegyzék létrehozása Bicep-modulokhoz.

Előfeltételek

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

A modulregisztrációs adatbázisok használatához a Bicep CLI 0.4.1008-es vagy újabb verziójával kell rendelkeznie. Az Azure CLI használatához az Azure CLI 2.31.0-s vagy újabb verziójával is rendelkeznie kell; az Azure PowerShell használatához az Azure PowerShell 7.0.0-s vagy újabb verziójával is rendelkeznie kell.

A Bicep-beállításjegyzék az Azure Container Registryben (ACR) található. A létrehozáshoz tekintse meg a rövid útmutatót: Tárolóregisztrációs adatbázis létrehozása Bicep-fájl használatával.

A Bicep-fejlesztés környezetének beállításához tekintse meg a Bicep-eszközök telepítését. A lépések elvégzése után a Visual Studio Code és a Bicep bővítmény, illetve a Visual Studio és a Bicep bővítmény lesz a rendelkezésére.

Bicep-modulok létrehozása

A modul egy másik Bicep-fájlból üzembe helyezett Bicep-fájl. Bármely Bicep-fájl használható modulként. Ebben a rövid útmutatóban az alábbi Bicep-fájlt használhatja. Létrehoz egy tárfiókot:

@minLength(3)
@maxLength(11)
param storagePrefix string

@allowed([
  'Standard_LRS'
  'Standard_GRS'
  'Standard_RAGRS'
  'Standard_ZRS'
  'Premium_LRS'
  'Premium_ZRS'
  'Standard_GZRS'
  'Standard_RAGZRS'
])
param storageSKU string = 'Standard_LRS'
param location string

var uniqueStorageName = '${storagePrefix}${uniqueString(resourceGroup().id)}'

resource stg 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: uniqueStorageName
  location: location
  sku: {
    name: storageSKU
  }
  kind: 'StorageV2'
  properties: {
    supportsHttpsTrafficOnly: true
  }
}

output storageEndpoint object = stg.properties.primaryEndpoints

Mentse a Bicep-fájlt storage.bicep néven.

Modulok közzététele

Ha nem rendelkezik Azure-tárolóregisztrációs adatbázissal (ACR), tekintse meg a létrehozás előfeltételeit . Az ACR bejelentkezési kiszolgálójának nevére van szükség. A bejelentkezési kiszolgáló nevének formátuma: <registry-name>.azurecr.io. A bejelentkezési kiszolgáló nevének lekérése:

az acr show --resource-group <resource-group-name> --name <registry-name> --query loginServer

Az alábbi szintaxissal közzétehet egy Bicep-fájlt modulként egy privát modulregisztrációs adatbázisban.

az bicep publish --file storage.bicep --target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 --documentationUri https://www.contoso.com/exampleregistry.html

Az előző példában a ./storage.bicep a közzéteendő Bicep-fájl. Szükség esetén frissítse a fájl elérési útját. A modul elérési útja a következő szintaxist tartalmazza:

br:<registry-name>.azurecr.io/<file-path>:<tag>
  • a br egy Bicep-beállításjegyzék sémaneve.
  • a fájl elérési útját az Azure Container Registry hívja meg repository . A fájl elérési útja tartalmazhat olyan szegmenseket, amelyeket a karakter elválaszt./ Ez a fájlútvonal akkor jön létre, ha nem létezik a beállításjegyzékben.
  • A modul egy verziójának megadásához címke szolgál.

A közzétett modulok ellenőrzéséhez listázhatja az ACR-adattárat:

az acr repository list --name <registry-name> --output table

Modulok hívása

Modul meghívásához hozzon létre egy új Bicep-fájlt a Visual Studio Code-ban. Az új Bicep-fájlban adja meg a következő sort.

module stgModule 'br:<registry-name>.azurecr.io/bicep/modules/storage:v1'

Cserélje le <a beállításjegyzék nevét> az ACR-beállításjegyzék nevére. A modul helyi gyorsítótárba való visszaállítása rövid ideig tart. A modul visszaállítása után a modul elérési útja alatti piros görbületi vonal eltűnik. A sor végén adjon hozzá = egy szóközt, majd válassza ki a szükséges tulajdonságokat az alábbi képernyőképen látható módon. A modul struktúrája automatikusan fel lesz töltve.

Visual Studio Code Bicep-bővítmény szükséges tulajdonságai

Az alábbi példa egy befejezett Bicep-fájl.

@minLength(3)
@maxLength(11)
param namePrefix string
param location string = resourceGroup().location

module stgModule 'br:ace1207.azurecr.io/bicep/modules/storage:v1' = {
  name: 'stgStorage'
  params: {
    location: location
    storagePrefix: namePrefix
  }
}

Mentse a Bicep-fájlt helyileg, majd az Azure CLI vagy az Azure PowerShell használatával telepítse a Bicep-fájlt:

resourceGroupName = "{provide-a-resource-group-name}"
templateFile="{provide-the-path-to-the-bicep-file}"

az group create --name $resourceGroupName --location eastus

az deployment group create --resource-group $resourceGroupName --template-file $templateFile

Az Azure Portalon ellenőrizze, hogy a tárfiók sikeresen létrejött-e.

Az erőforrások eltávolítása

Ha az Azure-erőforrásokra már nincs szükség, az Azure CLI vagy az Azure PowerShell modul használatával törölje a rövid útmutató erőforráscsoportját.

resourceGroupName = "{provide-the-resource-group-name}"

az group delete --name $resourceGroupName

Következő lépések

Learn modules for Bicep