Üzembe helyezési gomb használata távoli sablonok üzembe helyezéséhez
Ez a cikk bemutatja, hogyan helyezhet üzembe távoli ARM JSON-sablonokat gitHub-adattárból vagy Azure Storage-fiókból az Üzembe helyezés az Azure-ban gomb használatával. A gombot közvetlenül a GitHub-adattár README.md fájljához is hozzáadhatja. Vagy hozzáadhatja a gombot egy olyan weblaphoz, amely az adattárra hivatkozik. Ez a módszer nem támogatja a távoli Bicep-fájlok üzembe helyezését.
Az üzembehelyezési hatókört a sablonséma határozza meg. További információkért lásd:
Szükséges engedélyek
Bicep-fájl vagy ARM-sablon üzembe helyezéséhez írási joggal kell rendelkeznie az üzembe helyezett erőforrásokhoz, és hozzá kell férnie a Microsoft.Resources/deployments erőforrástípus összes műveletéhez. Egy virtuális gép üzembe helyezéséhez például szüksége van Microsoft.Compute/virtualMachines/write az engedélyekre és Microsoft.Resources/deployments/* az engedélyekre. A lehetőségelemzési műveletnek ugyanazok az engedélykövetelményei vannak.
A szerepkörök és engedélyek listáját megtalálja a Beépített Azure-szerepkörök című cikkben.
Közös rendszerkép használata
Ha fel szeretné adni a gombot a weblapra vagy az adattárba, használja a következő képet:
<img src="https://aka.ms/deploytoazurebutton"/>
A kép a következőképpen jelenik meg:
URL-cím létrehozása sablon üzembe helyezéséhez
Ez a szakasz bemutatja, hogyan szerezheti be a GitHubon és az Azure Storage-fiókban tárolt sablonok URL-címét, és hogyan formázhatja az URL-címeket.
A GitHubon tárolt sablon
A sablon URL-címének létrehozásához kezdje a Sablon nyers URL-címével a GitHub-adattárban. A nyers URL-cím megtekintéséhez válassza a Nyers lehetőséget.
Az URL formátuma a következő:
https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
Megjegyzés
Ha sablont szeretne üzembe helyezni, vagy egy privát GitHub-adattárban tárolt csatolt sablonra szeretne hivatkozni, tekintse meg az Egyéni és biztonságos Azure Portal-ajánlat létrehozása című témakört. Létrehozhat egy Azure-függvényt, amely lekéri a GitHub-tokent az Azure Key Vault.
Ha a Gitet Az Azure-adattárral használja GitHub-adattár helyett, továbbra is használhatja az Üzembe helyezés az Azure-ban gombot. Győződjön meg arról, hogy az adattár nyilvános. A sablon lekéréséhez használja az Items (Elemek) műveletet . A kérésnek a következő formátumban kell lennie:
https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0
Az Azure Storage-fiókban tárolt sablon
A nyilvános tárolóban tárolt sablonok URL-címeinek formátuma a következő:
https://{storage-account-name}.blob.core.windows.net/{container-name}/{template-file-name}
Például:
https://demostorage0215.blob.core.windows.net/democontainer/azuredeploy.json
A sablont SAS-jogkivonattal biztonságossá teheti. További információ: Privát ARM-sablon üzembe helyezése SAS-jogkivonattal. Az alábbi URL-cím egy SAS-jogkivonattal rendelkező példa:
https://demostorage0215.blob.core.windows.net/privatecontainer/azuredeploy.json?sv=2019-07-07&sr=b&sig=rnI8%2FvKoCHmvmP7XvfspfyzdHjtN4GPsSqB8qMI9FAo%3D&se=2022-02-16T17%3A47%3A46Z&sp=r
Az URL-cím formázása
Miután megkapta az URL-címet, url-címmel kódolt értékké kell alakítania az URL-címet. Használhat online kódolót, vagy futtathat egy parancsot. Az alábbi PowerShell-példa bemutatja, hogyan kódolhat url-címeket egy értékhez.
$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)
A példa URL-cím a következő értékkel rendelkezik, ha az URL-cím kódolása történik.
https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Minden hivatkozás ugyanazzal az alap URL-címmel kezdődik:
https://portal.azure.com/#create/Microsoft.Template/uri/
Adja hozzá az URL-kódolású sablon hivatkozását az alap URL-cím végéhez.
https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Rendelkezik a hivatkozás teljes URL-címével.
Üzembe helyezés létrehozása az Azure-ban gomb
Végül helyezze össze a hivatkozást és a képet.
Ha a GitHub-adattárban vagy egy weblapon található README.md fájlban a Markdown gombot szeretné hozzáadni, használja a következőt:
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json)
HTML esetén használja a következőt:
<a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json" target="_blank">
<img src="https://aka.ms/deploytoazurebutton"/>
</a>
Az Azure-adattárral rendelkező Git esetében a gomb formátuma a következő:
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fdev.azure.com%2Forgname%2Fprojectname%2F_apis%2Fgit%2Frepositories%2Freponame%2Fitems%3FscopePath%3D%2freponame%2fazuredeploy.json%26api-version%3D6.0)
A sablon üzembe helyezése
A teljes megoldás teszteléséhez kattintson a következő gombra:
A portál egy panelt jelenít meg, amely lehetővé teszi a paraméterértékek egyszerű megadását. A paraméterek előre ki vannak töltve a sablon alapértelmezett értékeivel. A sablonban definiált camel-cased paraméternév, a storageAccountType szóközzel elválasztott sztringgé alakul, amikor megjelenik a portálon.
Következő lépések
- A sablonokról további információt az ARM-sablonok szerkezetének és szintaxisának ismertetése című témakörben talál.