Rövid útmutató: Sablon-specifikáció létrehozása és üzembe helyezése a Bicep használatával
Cikk
Ez a rövid útmutató bemutatja, hogyan hozhat létre és helyezhet üzembe sablonspektratívokat egy Bicep-fájllal. A sablon specifikációja egy erőforráscsoportban van üzembe helyezve, így a szervezet tagjai erőforrásokat helyezhetnek üzembe a Microsoft Azure-ban. A sablon specifikációi lehetővé teszik az üzembehelyezési sablonok megosztását anélkül, hogy hozzáférést kellene adni a felhasználóknak a Bicep-fájl módosításához. Ez a sablonspecifikációs példa egy Bicep-fájlt használ egy tárfiók üzembe helyezéséhez.
Sablonleképezés létrehozásakor a Bicep-fájl JavaScript Object Notation (JSON) lesz. A sablon specifikációja JSON-t használ az Azure-erőforrások üzembe helyezéséhez. Jelenleg nem használhatja a Microsoft Azure Portalt Bicep-fájlok importálására és sablon-specifikációs erőforrás létrehozására.
Sablon-specifikációt egy helyi Bicep-fájlból hozhat létre. Másolja ki a következő mintát, és mentse a számítógépre main.bicep néven. A példák a C:\templates\main.bicep elérési utat használják. Használhat egy másik elérési utat, de módosítania kell a parancsokat.
Az alábbi Bicep-fájlt használja a PowerShell és a PARANCSSOR lap. A Bicep fájlfül egy másik sablont használ, amely a Bicep és a JSON használatával hoz létre és helyez üzembe egy sablon-specifikációt.
A sablon specifikációja egy Microsoft.Resources/templateSpecs nevű erőforrástípus. Sablon specifikáció létrehozásához használja az Azure CLI-t, az Azure PowerShellt vagy egy Bicep-fájlt.
Ez a példa az erőforráscsoport nevét templateSpecRGhasználja. Más nevet is használhat, de módosítania kell a parancsokat.
Létrehozhat sablon-specifikációt egy Bicep-fájllal, de annak mainTemplate JSON-fájlban kell lennie. A JSON-sablon nem használ szabványos JSON-szintaxist. Például nincsenek sorvégi vesszők, a dupla idézőjelek egy idézőjelekre cserélődnek, a fordított perjelek (\) pedig az önálló idézőjelek kifejezésen belüli feloldására szolgálnak.
Másolja ki a következő sablont, és mentse a számítógépre main.bicep formátumban.
az deployment group create \
--resource-group templateSpecRG \
--template-file "C:\templates\main.bicep"
Sablon specifikáció üzembe helyezése
Tárfiók üzembe helyezéséhez használja a sablon specifikációt. Ez a példa az erőforráscsoport nevét storageRGhasználja. Más nevet is használhat, de módosítania kell a parancsokat.
Pontosan ugyanúgy adja meg a paramétereket, mint egy Bicep-fájl üzembe helyezéséhez. A sablon specifikációjának ismételt üzembe helyezése a tárfiók típusának paraméterével.
Ismert probléma merült fel a sablon specifikációazonosítóinak lekérésével és egy változóhoz való hozzárendelésével kapcsolatban a Windows PowerShellben.
A sablon specifikációjának üzembe helyezése.
az deployment group create \
--resource-group storageRG \
--template-spec $id
Pontosan ugyanúgy adja meg a paramétereket, mint egy Bicep-fájl üzembe helyezéséhez. A sablon specifikációjának ismételt üzembe helyezése a tárfiók típusának paraméterével.
az deployment group create \
--resource-group storageRG \
--template-spec $id \
--parameters storageAccountType="Standard_GRS"
A sablon specifikációinak Bicep-fájllal való üzembe helyezéséhez használjon egy modult. A modul egy meglévő sablonelemre hivatkozik. További információ: fájl a sablon specifikációjában.
Másolja ki a következő Bicep-modult, és mentse a számítógépre storage.bicep néven.
az deployment group create \
--resource-group storageRG \
--template-file "C:\templates\storage.bicep"
Hozzáadhat egy paramétert, és újra üzembe helyezheti a sablon specifikációt egy másik tárfióktípussal. Másolja ki a mintát, és cserélje le a storage.bicep fájlt. Ezután telepítse újra a sablon specifikációjának üzembe helyezését.
Ha engedélyezni szeretné, hogy a szervezet más felhasználói üzembe helyezhessék a sablon specifikációját, olvasási hozzáférést kell biztosítani számukra. Az Olvasó szerepkört hozzárendelheti egy Microsoft Entra-csoporthoz ahhoz az erőforráscsoporthoz, amely a megosztani kívánt sablon-specifikációkat tartalmazza. További információ : Oktatóanyag: Csoporthozzáférés biztosítása Azure-erőforrásokhoz az Azure PowerShell használatával.
Bicep-fájl frissítése
A sablon specifikációjának létrehozása után úgy döntött, hogy frissíti a Bicep-fájlt. A PowerShell- vagy CLI-lapok példáinak folytatásához másolja ki a mintát, és cserélje le a main.bicep fájlt.
A paraméter storageNamePrefix a tárfiók nevének előtagértékét adja meg. A storageAccountName változó egyedi sztringgel fűzi össze az előtagot.
Ahelyett, hogy új sablonspecifikációt hoz létre a módosított sablonhoz, adjon hozzá egy új, a meglévő sablon specifikációjának elnevezett 2.0 verziót. A felhasználók bármelyik verziót üzembe helyezhetik.
az deployment group create \
--resource-group storageRG \
--template-file "C:\templates\storage.bicep"
Clean up resources
Az ebben a rövid útmutatóban üzembe helyezett erőforrások törléséhez törölje mindkét erőforráscsoportot. Az erőforráscsoport, a sablon specifikációi és a tárfiókok törlődnek.
Az erőforráscsoportok törléséhez használja az Azure PowerShellt vagy az Azure CLI-t.