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

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 CLI-vel. További lehetőségek:

• Sablon exportálása az Azure Portallal
• Sablon exportálása az Azure PowerShell-lel
• REST API-exportálás erőforráscsoportból és REST API-exportálás az üzembe helyezési előzményekből.

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 sikeres 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 az group exportot , és adja meg az erőforráscsoport nevét.

az group export --name demoGroup

A szkript megjeleníti a sablont a konzolon. Fájlba mentéshez használja a következőt:

az group export --name demoGroup > exportedtemplate.json

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.

storageAccountID=$(az resource show --resource-group demoGroup --name demostg --resource-type Microsoft.Storage/storageAccounts --query id --output tsv)
az group export --resource-group demoGroup --resource-ids $storageAccountID

Egynél több erőforrás exportálásához adja át a térelválasztó erőforrásazonosítókat. Az összes erőforrás exportálásához ne adja meg ezt az argumentumot, és ne adja meg a "*" értéket.

az group export --resource-group <resource-group-name> --resource-ids $storageAccountID1 $storageAccountID2

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 --skip-resource-name-params 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 --include-parameter-default-value 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 az az deployment group export parancsot. 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.

az deployment group export --resource-group demoGroup --name demoDeployment

A sablon megjelenik a konzolon. A fájl mentéséhez használja a következőt:

az deployment group export --resource-group demoGroup --name demoDeployment > demoDeployment.json

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

• az deployment sub export for deployments to subscriptions
• az deployment mg export for deployments to management groups
• az deployment tenant export for deployments to tenants

Következő lépések

• Megtudhatja, hogyan exportálhat sablonokat az Azure Portal, az Azure PowerShell vagy a REST API használatával.
• A Resource Manager-sablon szintaxisának megismeréséhez tekintse meg az Azure Resource Manager-sablonok szerkezetét és szintaxisát.
• A sablonok fejlesztésének módjáról a részletes oktatóanyagokban olvashat.