Share via

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

  • Cikk

Az Azure Resource Manager-sablonok létrehozásához a 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önyvhöz. Az exportálási sablonfolyamat használható sablont próbál létrehozni. Az exportált sablonok többsége azonban némi módosítást igényel az Azure-erőforrások üzembe helyezéséhez.

A 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 az Azure PowerShell-lel. További lehetőségek:

Válassza ki a megfelelő exportálási lehetőséget

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 beállítástó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. A kód üzembe helyezése 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. Az üzembe helyezés után végzett manuális módosításokat is tartalmazza. 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 szerepelnek benne.
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 ezeknek az erőforrásoknak a részhalmazá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ó ismételt ü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. Megszüntetheti a Belefoglalás paraméterek jelölőnégyzet jelölését, hogy saját paramétereket is létrehozhat. 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ások legyenek exportálva.
  • 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 lesz. 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. Előfordulhat, hogy a séma nem rendelkezik 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 néhány jelszóparaméter hiányzik az exportált sablonokból. Mielőtt a sablonokkal üzembe helyezheti az erőforrásokat, ellenőriznie kell a sablonreferenciákat, és manuálisan kell hozzáadnia ezeket a paramétereket.

Az exportálási sablon funkció nem támogatja az 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 Azure Data Factoryben található adat-előállítók másolása vagy klónozása című témakörben olvashat.

A klasszikus üzemi modellel létrehozott erőforrások exportálásához át kell telepítenie őket a Resource Manager-alapú üzemi modellbe.

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

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

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 exportálja.

Egy erőforrás exportálásához adja át 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

Egynél több erőforrás exportálásához 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 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. Az üzembe helyezés során nem szabhatja testre a nevet.

"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 mentheti egy központi telepítésből. A kapott sablon pontosan az üzembe helyezéshez használt sablon.

Ha sablont szeretne lekérni egy erőforráscsoport központi telepítésé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 Managerrel 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