Een implementatieknop gebruiken om sjablonen te implementeren vanuit GitHub opslagplaats
In dit artikel wordt beschreven hoe u de knop Implementeren in Azure gebruikt om sjablonen te implementeren vanuit GitHub opslagplaats. U kunt de knop rechtstreeks toevoegen aan het README.md in uw GitHub opslagplaats. U kunt de knop ook toevoegen aan een webpagina die verwijst naar de opslagplaats.
Het implementatiebereik wordt bepaald door het sjabloonschema. Zie voor meer informatie:
Algemene afbeelding gebruiken
Gebruik de volgende afbeelding om de knop toe te voegen aan uw webpagina of opslagplaats:
<img src="https://aka.ms/deploytoazurebutton"/>
De afbeelding wordt weergegeven als:
URL maken voor het implementeren van een sjabloon
Als u de URL voor uw sjabloon wilt maken, begint u met de onbewerkte URL naar de sjabloon in uw repo. Als u de onbewerkte URL wilt zien, selecteert u Onbewerkt.
De indeling van de URL is:
https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
Converteert de URL vervolgens naar een url-gecodeerde waarde. U kunt een online encoder gebruiken of een opdracht uitvoeren. In het volgende PowerShell-voorbeeld ziet u hoe u een URL codeert voor een waarde.
$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)
De voorbeeld-URL heeft de volgende waarde wanneer url is gecodeerd.
https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Elke koppeling begint met dezelfde basis-URL:
https://portal.azure.com/#create/Microsoft.Template/uri/
Voeg de url-gecodeerde sjabloonkoppeling toe aan het einde van de basis-URL.
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
U hebt de volledige URL voor de koppeling.
Notitie
Voor het implementeren van een sjabloon of een verwijzing naar een gekoppelde sjabloon die is opgeslagen in een persoonlijke GitHub-opslag plaats, raadpleegt u een aangepaste oplossing die wordt beschreven in een MVP-blog. U kunt een Azure- functie instellen als een proxy om de URL te maken die nodig is voor toegang tot een sjabloon bestand in een persoonlijke github-opslag plaats.
Als u Git gebruikt met Azure Repos in plaats van een GitHub,kunt u nog steeds de knop Implementeren in Azure gebruiken. Zorg ervoor dat uw repo openbaar is. Gebruik de bewerking Items om de sjabloon op te halen. Uw aanvraag moet de volgende indeling hebben:
https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0
Codeer deze aanvraag-URL.
Knop Implementeren in Azure maken
Plaats ten slotte de koppeling en de afbeelding bij elkaar.
Als u de knop met Markdown wilt toevoegen aan README.md bestand in GitHub opslagplaats of op een webpagina, gebruikt u:
[](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)
Gebruik voor HTML:
<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>
Voor Git met Azure-repo heeft de knop de volgende indeling:
[](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)
De sjabloon implementeren
Als u de volledige oplossing wilt testen, selecteert u de volgende knop:
In de portal wordt een deelvenster weergegeven waarmee u eenvoudig parameterwaarden kunt opgeven. De parameters worden vooraf ingevuld met de standaardwaarden uit de sjabloon. De parameternaam van de camel-cased, storageAccountType, die in de sjabloon is gedefinieerd, wordt omgezet in een door spatie gescheiden tekenreeks wanneer deze wordt weergegeven in de portal.
Volgende stappen
- Zie Inzicht in de structuur en syntaxis van ARM-sjablonen voor meer informatie over sjablonen.