Erőforrások meghatározása

Befejeződött

A Bicep-sablonok a létrehozott fájlok, amelyek meghatározzák az üzembe helyezendő Azure-erőforrásokat.

A toy cégnek szüksége van egy újrafelhasználható Bicep-sablon létrehozására a termékbemutatókhoz. A sablonnak üzembe kell helyeznie egy Azure Storage-fiókot és Azure-alkalmazás service-erőforrásokat, amelyeket az egyes új termékek forgalomba hozatalához használnak az üzembe helyezés során.

Ebben a leckében megtudhatja, hogyan definiálhat egy erőforrást egy Bicep-sablonban, hogyan működnek az erőforrásnevek, és hogyan hozhat létre egymással kapcsolatos erőforrásokat.

Feljegyzés

Az egység parancsai a fogalmakat szemléltetik. Még ne futtassa a parancsokat. Hamarosan gyakorolja, amit itt tanul.

Erőforrás definiálása

A Bicep-sablonokkal a legfontosabb teendő az Azure-erőforrások meghatározása. Íme egy példa arra, hogyan néz ki egy tipikus erőforrásdefiníció a Bicepben. Ez a példa létrehoz egy tárfiókot .toylaunchstorage

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'toylaunchstorage'
  location: 'westus3'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

Tekintsük át az erőforrásdefiníció néhány fontos részét:

• Az resource első kulcsszó azt jelzi a Bicep-nek, hogy erőforrást szeretne definiálni.

• Ezután szimbolikus nevet ad az erőforrásnak. A példában az erőforrás szimbolikus neve .storageAccount A Bicepben szimbolikus neveket használnak az erőforrásra való hivatkozáshoz, de soha nem jelennek meg az Azure-ban.

• Microsoft.Storage/storageAccounts@2022-09-01 az erőforrás erőforrástípusa és API-verziója . Microsoft.Storage/storageAccounts azt jelzi a Bicepnek, hogy azure-tárfiókot deklarál. A dátum 2022-09-01 az Azure Storage API azon verziója, amelyet a Bicep az erőforrás létrehozásakor használ.

  Tipp.

  A Visual Studio Code Bicep-bővítménye segít megtalálni a létrehozott erőforrások erőforrástípusát és API-verzióit. Ha ismeri az ARM-sablonokat, vegye figyelembe, hogy az API-verzió megegyezik az ott használt verzióval.

• Deklarálnia kell egy erőforrásnevet, amely az a név, amelyet a tárfiók hozzárendel az Azure-ban. A kulcsszó használatával name beállít egy erőforrásnevet.

  Fontos

  A szimbolikus nevek csak a Bicep-sablonban használatosak, és nem jelennek meg az Azure-ban. Az erőforrásnevek megjelennek az Azure-ban.

• Ezután beállítja az erőforrás egyéb adatait, például a helyét, az SKU-t (tarifacsomagot) és a típust. Vannak olyan tulajdonságok is, amelyek különbözőek az egyes erőforrástípusokhoz. A különböző API-verziók is eltérő tulajdonságokat eredményezhetnek. Ebben a példában a tárfiók hozzáférési szintjét állítjuk be a következőre Hot: .

Tipp.

Az erőforrásnevek gyakran olyan szabályokat tartalmaznak, amelyeket be kell tartania, például a maximális hosszokat, az engedélyezett karaktereket és az egyediséget az Összes Azure-ban. Az erőforrásnevek követelményei minden Azure-erőforrástípus esetében eltérőek. Mielőtt hozzáadná őket a sablonhoz, mindenképpen ismerje meg az elnevezési korlátozásokat és követelményeket.

Mi történik, ha az erőforrások egymástól függnek?

A Bicep-sablonok általában több erőforrást tartalmaznak. Gyakran szükség van egy erőforrásra, hogy egy másik erőforrástól függjön. Előfordulhat, hogy ki kell nyernie néhány információt az egyik erőforrásból, hogy definiálhasson egy másikat. Ha webalkalmazást helyez üzembe, létre kell hoznia a kiszolgálói infrastruktúrát, mielőtt hozzá tud adni egy alkalmazást. Ezeket a kapcsolatokat függőségeknek nevezzük.

Telepítenie kell egy App Service-alkalmazást a sablonhoz, amely segít a termék elindításában, de egy App Service-alkalmazás létrehozásához először létre kell hoznia egy App Service-csomagot. Az App Service-csomag a kiszolgáló üzemeltetési erőforrásait jelöli, és az alábbi példához hasonlóan deklarálva van:

resource appServicePlan 'Microsoft.Web/serverFarms@2023-12-01' = {
  name: 'toy-product-launch-plan'
  location: 'westus3'
  sku: {
    name: 'F1'
  }
}

Ez az erőforrásdefiníció azt jelzi, hogy a Bicep egy olyan App Service-csomagot szeretne üzembe helyezni, amely erőforrástípussal rendelkezik Microsoft.Web/serverFarms. A terverőforrás neve toy-product-launch-planaz USA 3. nyugati régiójában van üzembe helyezve. Az F1 díjszabási termékváltozatát használja, amely az App Service ingyenes szintje.

Most, hogy deklarálta az App Service-csomagot, a következő lépés az alkalmazás deklarálása:

resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
  name: 'toy-product-launch-1'
  location: 'westus3'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

Ez a sablon arra utasítja az Azure-t, hogy üzemeltetje az alkalmazást a létrehozott terven. Figyelje meg, hogy a csomag definíciója tartalmazza az App Service-csomag szimbolikus nevét ezen a sorban: serverFarmId: appServicePlan.id. Ez a sor azt jelenti, hogy a Bicep a tulajdonság használatával id lekéri az App Service-csomag erőforrás-azonosítóját. Gyakorlatilag azt mondja, hogy az alkalmazás kiszolgálófarm-azonosítója a korábban definiált App Service-csomag azonosítója.

Tipp.

Az Azure-ban az erőforrás-azonosító minden erőforrás egyedi azonosítója. Az erőforrás-azonosító tartalmazza az Azure-előfizetés azonosítóját, az erőforráscsoport nevét és az erőforrás nevét, valamint néhány egyéb információt.

Az alkalmazáserőforrásnak a terv szimbolikus nevére hivatkozó tulajdonsággal való deklarálásával az Azure megérti az App Service-alkalmazás és a csomag közötti implicit függőséget . Az erőforrások üzembe helyezésekor az Azure biztosítja, hogy az alkalmazás üzembe helyezése előtt teljes mértékben üzembe helyezze a csomagot.