Använd en distributionsknapp för att distribuera mallar från GitHub lagringsplats

  • Artikel
  • 2 minuter för att läsa

Den här artikeln beskriver hur du använder knappen Distribuera till Azure för att distribuera mallar från en GitHub lagringsplats. Du kan lägga till knappen direkt i README.md på din GitHub lagringsplats. Eller så kan du lägga till knappen på en webbsida som refererar till lagringsplatsen.

Distributionsomfånget bestäms av mallschemat. Mer information finns i:

Använda en gemensam avbildning

Om du vill lägga till knappen på din webbsida eller lagringsplats använder du följande bild:

![Deploy to Azure](https://aka.ms/deploytoazurebutton)

<img src="https://aka.ms/deploytoazurebutton"/>

Bilden visas som:

Distribuera till Azure (knapp)

Skapa URL för distribution av mall

Om du vill skapa URL:en för mallen börjar du med rå-URL:en till mallen på din lagringsplatsen. Om du vill se rå-URL:en väljer du Raw.

välj Raw

Formatet för URL:en är:

https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json

Konvertera sedan URL:en till ett URL-kodat värde. Du kan använda en onlinekodare eller köra ett kommando. Följande PowerShell-exempel visar hur du URL-kodar ett värde.

$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)

Exempel-URL:en har följande värde när URL:en kodas.

https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json

Varje länk börjar med samma grundläggande URL:

https://portal.azure.com/#create/Microsoft.Template/uri/

Lägg till din URL-kodade malllänk i slutet av bas-URL:en.

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

Du har din fullständiga URL för länken.

Anteckning

Om du vill distribuera en mall eller referera till en länkad mall som är lagrad i en privat GitHub lagrings platsen, se en anpassad lösning som dokumenterats i en MVP-blogg. Du kan konfigurera en Azure-funktion som proxy för att skapa den URL som behövs för att få åtkomst till en mallfil i en privat GitHub-lagrings platsen.

Om du använder Git med Azure Repos i stället för en GitHub lagringsplatsen kan du fortfarande använda knappen Distribuera till Azure. Kontrollera att din lagringsplatsen är offentlig. Använd items-åtgärden för att hämta mallen. Din begäran ska ha följande format:

https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0

Koda denna begärande-URL.

Knappen Skapa distribuera till Azure

Slutligen sätter du ihop länken och avbildningen.

Om du vill lägga till knappen med Markdown i README.md i din GitHub lagringsplats eller en webbsida använder du:

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](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)

För HTML använder du:

<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>

För Git med Azure-lagringsplatsen har knappen formatet:

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](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)

Distribuera mallen

Om du vill testa den fullständiga lösningen väljer du följande knapp:

Distribuera till Azure

Portalen visar ett fönster där du enkelt kan ange parametervärden. Parametrarna är förfyllda med standardvärdena från mallen. Parameternamnet med kamelfall, storageAccountType, som definieras i mallen, omvandlas till en blankstegsavgränsad sträng när det visas på portalen.

Använda portalen för att distribuera

Nästa steg