Sablon exportálása Azure PowerShell használatával

  • Cikk

Az Azure Resource Manager-sablonok létrehozásához meglévő erőforrásokból exportálhat sablonokat. Az exportált sablon segít megérteni az erőforrásokat üzembe helyező JSON-szintaxist és tulajdonságokat. A jövőbeli üzemelő példányok automatizálásához kezdje az exportált sablonnal, és módosítsa azt a forgatókönyvéhez. Az exportálási sablonfolyamat használható sablont próbál létrehozni. A legtöbb exportált sablon azonban némi módosítást igényel az Azure-erőforrások üzembe helyezéséhez.

Resource Manager lehetővé teszi egy vagy több erőforrás kiválasztását egy sablonba való exportáláshoz. A sablonban pontosan a szükséges erőforrásokra összpontosíthat.

Ez a cikk bemutatja, hogyan exportálhat sablonokat Azure PowerShell keresztül. További lehetőségekért lásd:

A megfelelő exportálási lehetőség kiválasztása

Kétféleképpen exportálhat sablont:

  • Exportálás erőforráscsoportból vagy erőforrásból. Ez a beállítás új sablont hoz létre a meglévő erőforrásokból. Az exportált sablon az erőforráscsoport aktuális állapotának pillanatképe. Exportálhat egy teljes erőforráscsoportot vagy adott erőforrásokat az adott erőforráscsoporton belül.

  • Mentés az előzményekből. Ez a beállítás lekéri az üzembe helyezéshez használt sablon pontos másolatát. Az üzembe helyezést az üzembe helyezési előzményekből adhatja meg.

A választott lehetőségtől függően az exportált sablonok különböző tulajdonságokkal rendelkeznek.

Erőforráscsoportból vagy erőforrásból Előzményekből
A sablon automatikusan létre van hozva. Az üzembe helyezés előtt valószínűleg javítania kell a kódot. A sablon a sablon szerzője által létrehozott példány pontos másolata. Készen áll az újbóli üzembe helyezésre módosítások nélkül.
A sablon az erőforrások aktuális állapotának pillanatképe. Tartalmazza az üzembe helyezés után végzett manuális módosításokat. A sablon csak az erőforrások állapotát jeleníti meg az üzembe helyezéskor. Az üzembe helyezés után végzett manuális módosítások nem lesznek belefoglalva.
Kiválaszthatja, hogy mely erőforrásokat szeretné exportálni egy erőforráscsoportból. Az adott üzemelő példányhoz tartozó összes erőforrást tartalmazza. Nem választhatja ki az erőforrások egy részét, és nem adhat hozzá más időpontban hozzáadott erőforrásokat.
A sablon tartalmazza az erőforrások összes tulajdonságát, beleértve azokat a tulajdonságokat is, amelyek általában nem lennének beállítva az üzembe helyezés során. Előfordulhat, hogy a sablon újbóli használata előtt el szeretné távolítani vagy törölni ezeket a tulajdonságokat. A sablon csak az üzembe helyezéshez szükséges tulajdonságokat tartalmazza. A sablon ritkább és könnyebben olvasható.
A sablon valószínűleg nem tartalmazza az újrafelhasználáshoz szükséges összes paramétert. A legtöbb tulajdonságérték nehezen kódolt a sablonban. A sablon más környezetekben való újbóli üzembe helyezéséhez olyan paramétereket kell hozzáadnia, amelyek növelik az erőforrások konfigurálásának képességét. A Paraméterek belefoglalása jelölőnégyzetet megszüntetheti, hogy saját paramétereket szerkesszen. A sablon olyan paramétereket tartalmaz, amelyek megkönnyítik a különböző környezetekben való újbóli üzembe helyezést.

Exportálja a sablont egy erőforráscsoportból vagy erőforrásból, ha:

  • Rögzítenie kell az eredeti üzembe helyezés után végrehajtott erőforrások módosításait.
  • Ki szeretné választani, hogy mely erőforrásokat exportálja a rendszer.
  • Az erőforrások nem sablonnal lettek létrehozva.

Exportálja a sablont az előzményekből, amikor:

  • Könnyen újrafelhasználható sablont szeretne.
  • Nem kell belefoglalnia az eredeti üzembe helyezés után végrehajtott módosításokat.

Korlátozások

Az exportálás nem garantáltan sikeres. Az exportálás nem megbízható módszer arra, hogy a meglévő erőforrásokat éles környezetben használható sablonokká alakítsa. Jobb, ha kézzel írt Bicep-fájl, ARM-sablon vagy terraform használatával hoz létre erőforrásokat az alapoktól.

Erőforráscsoportból vagy erőforrásból való exportáláskor az exportált sablon az egyes erőforrástípusok közzétett sémáiból jön létre. Időnként a séma nem rendelkezik az erőforrástípus legújabb verziójával. Ellenőrizze az exportált sablont, hogy tartalmazza-e a szükséges tulajdonságokat. Szükség esetén szerkessze az exportált sablont a szükséges API-verzió használatához.

Előfordulhat, hogy egyes jelszóparaméterek hiányoznak az exportált sablonokból. Mielőtt a sablonokkal üzembe helyezheti az erőforrásokat, ellenőriznie kell a sablonreferenciát, és manuálisan kell hozzáadnia ezeket a paramétereket.

Az exportálási sablon funkció nem támogatja Azure Data Factory erőforrások exportálását. A Data Factory-erőforrások exportálásának módjáról az Adat-előállító másolása vagy klónozása Azure Data Factory című témakörben olvashat.

A klasszikus üzemi modellel létrehozott erőforrások exportálásához migrálnia kell őket a Resource Manager üzemi modellbe.

Ha egy olyan sablon exportálásakor figyelmeztetést kap, amely azt jelzi, hogy egy erőforrástípust nem exportáltak, akkor is felfedezheti az adott erőforrás tulajdonságait. Az erőforrás-tulajdonságokról a sablonreferenciában olvashat. Az erőforrástípushoz az Azure REST API-t is megtekintheti.

Az exportált sablont létrehozó erőforráscsoportban legfeljebb 200 erőforrás lehet. Ha olyan erőforráscsoportot próbál exportálni, amely több mint 200 erőforrással rendelkezik, a hibaüzenet Export template is not supported for resource groups more than 200 resources jelenik meg.

Sablon exportálása erőforráscsoportból

Az erőforráscsoport beállítása után exportálhat egy Azure Resource Manager-sablont az erőforráscsoporthoz.

Egy erőforráscsoport összes erőforrásának exportálásához használja az Export-AzResourceGroup parancsmagot, és adja meg az erőforráscsoport nevét.

Export-AzResourceGroup -ResourceGroupName demoGroup

A sablont helyi fájlként menti.

Az erőforráscsoport összes erőforrásának exportálása helyett kiválaszthatja, hogy mely erőforrásokat szeretné exportálni.

Egy erőforrás exportálásához adja meg ezt az erőforrás-azonosítót.

$resource = Get-AzResource `
  -ResourceGroupName <resource-group-name> `
  -ResourceName <resource-name> `
  -ResourceType <resource-type>
Export-AzResourceGroup `
  -ResourceGroupName <resource-group-name> `
  -Resource $resource.ResourceId

Ha egynél több erőforrást szeretne exportálni, adja át az erőforrásazonosítókat egy tömbben.

Export-AzResourceGroup `
  -ResourceGroupName <resource-group-name> `
  -Resource @($resource1.ResourceId, $resource2.ResourceId)

A sablon exportálásakor megadhatja, hogy a sablonban használ-e paramétereket. Alapértelmezés szerint az erőforrásnevek paraméterei is szerepelnek, de nem rendelkeznek alapértelmezett értékkel.

"parameters": {
  "serverfarms_demoHostPlan_name": {
    "type": "String"
  },
  "sites_webSite3bwt23ktvdo36_name": {
    "type": "String"
  }
}

Ha a paramétert a -SkipResourceNameParameterization sablon exportálásakor használja, az erőforrásnevek paraméterei nem szerepelnek a sablonban. Ehelyett az erőforrás neve közvetlenül az erőforráson van beállítva az aktuális értékre. A név nem szabható testre az üzembe helyezés során.

"resources": [
  {
    "type": "Microsoft.Web/serverfarms",
    "apiVersion": "2022-09-01",
    "name": "demoHostPlan",
    ...
  }
]

Ha a paramétert a -IncludeParameterDefaultValue sablon exportálásakor használja, a sablonparaméter tartalmaz egy alapértelmezett értéket, amely az aktuális értékre van állítva. Használhatja ezt az alapértelmezett értéket, vagy felülírhatja az alapértelmezett értéket egy másik érték átadásával.

"parameters": {
  "serverfarms_demoHostPlan_name": {
    "defaultValue": "demoHostPlan",
    "type": "String"
  },
  "sites_webSite3bwt23ktvdo36_name": {
    "defaultValue": "webSite3bwt23ktvdo36",
    "type": "String"
  }
}

Sablon mentése az üzembe helyezési előzményekből

A sablonokat az üzembe helyezési előzményekben lévő központi telepítésből mentheti. A kapott sablon pontosan az üzembe helyezéshez használt sablon.

Ha sablont szeretne lekérni egy erőforráscsoport üzemelő példányából, használja a Save-AzResourceGroupDeploymentTemplate parancsmagot. Meg kell adnia a lekérni kívánt üzembe helyezés nevét. Ha segítségre van szüksége az üzembe helyezés nevének lekéréséhez, olvassa el az Üzembe helyezési előzmények megtekintése az Azure Resource Manager használatával című témakört.

Save-AzResourceGroupDeploymentTemplate -ResourceGroupName demoGroup -DeploymentName demoDeployment

A sablont a rendszer helyi fájlként menti az üzembe helyezés nevével.

Ha más szinteken szeretné üzembe helyezni a sablonokat, használja a következőt:

Következő lépések