Use um botão de implantação para implementar modelos a partir de GitHub repositório

Este artigo descreve como utilizar o botão Implementar para Azure para implantar modelos a partir de um repositório GitHub. Pode adicionar o botão diretamente ao ficheiro README.md no seu repositório de GitHub. Ou, pode adicionar o botão a uma página web que faz referência ao repositório.

O âmbito de implantação é determinado pelo esquema do modelo. Para obter mais informações, consulte:

Use imagem comum

Para adicionar o botão à sua página web ou repositório, utilize a seguinte imagem:

![Deploy to Azure](https://aka.ms/deploytoazurebutton)
<img src="https://aka.ms/deploytoazurebutton"/>

A imagem aparece como:

Botão Implementar no Azure

Criar URL para implementar o modelo

Para criar o URL para o seu modelo, comece com o URL cru para o modelo no seu repo. Para ver o URL cru, selecione Raw.

selecionar Raw

O formato do URL é:

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

Em seguida, converta o URL num valor codificado por URL. Pode utilizar um codificader on-line ou executar um comando. O exemplo seguinte do PowerShell mostra como codificar um valor url.

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

O URL de exemplo tem o seguinte valor quando o URL codificado.

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

Cada ligação começa com o mesmo URL base:

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

Adicione o seu link de modelo codificado por URL ao fim do URL base.

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

Tem o URL completo para a ligação.

Nota

Para implementar um modelo ou referência de um modelo ligado que é armazenado num repo GitHub privado, consulte uma solução personalizada documentada num blog MVP. Você pode configurar uma função Azure como um proxy para construir o URL necessário para aceder a um ficheiro de modelo em um repo GitHub privado.

Se estiver a utilizar o Git com Azure Repos em vez de um repo GitHub, ainda pode utilizar o botão Implementar para Azure. Certifique-se de que o seu repo é público. Utilize a operação Itens para obter o modelo. O seu pedido deve estar no seguinte formato:

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

Codificar este URL de pedido.

Criar implementar para o botão Azure

Finalmente, junte o link e a imagem.

Para adicionar o botão com o Markdown no ficheiro README.md no seu repositório de GitHub ou numa página web, utilize:

[![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)

Para HTML, utilize:

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

Para Git com Azure repo, o botão está no formato:

[![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)

Implementar o modelo

Para testar a solução completa, selecione o seguinte botão:

Implementar no Azure

O portal apresenta um painel que lhe permite fornecer facilmente valores de parâmetros. Os parâmetros são pré-preenchidos com os valores predefinidos do modelo. O nome do parâmetro em caixa de camelo, storageAccountType, definido no modelo é transformado numa cadeia separada do espaço quando exibida no portal.

Use o portal para implementar

Passos seguintes