Compartilhar via


Usar um botão de implantação para implantar modelos remotos

Este artigo descreve como usar o botão Implantar no Azure para implantar modelos JSON do ARM remotos de um repositório do GitHub ou de uma conta de armazenamento do Azure. Você pode adicionar o botão diretamente ao arquivo LEIAME.md no seu repositório GitHub. Você também pode adicioná-lo a uma página da Web que faz referência ao repositório. Este método não dá suporte à implantação de arquivos Bicep remotos.

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

Permissões necessárias

Para implantar um arquivo Bicep ou um modelo do ARM, você precisa de acesso de gravação nos recursos que está implantando e acesso a todas as operações no tipo de recurso Microsoft.Resources/implantações. Por exemplo, para implantar uma máquina virtual, você precisa Microsoft.Compute/virtualMachines/write e permissões Microsoft.Resources/deployments/*. A operação do teste de hipóteses tem os mesmos requisitos de permissão.

Para ver uma lista de funções e permissões, consulte Funções interna do Azure.

Usar imagem comum

Use a imagem a seguir para adicionar o botão à sua página da Web ou repositório:

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

A imagem aparece como:

Captura de tela do botão Implantar no Azure.

Criar uma URL para implantar o modelo

Esta seção mostra como obter as URLs para os modelos armazenados no GitHub e no conta de armazenamento do Azure e como formatar as URLs.

Modelo armazenado em GitHub

Para criar a URL para o modelo, comece com a URL bruta para o modelo no seu repositório do GitHub. Selecione o botão Raw para ver a URL bruta.

Captura de tela mostrando como selecionar Raw no GitHub.

O formato da URL é:

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

Observação

Para implantar um modelo ou fazer referência a um modelo vinculado armazenado em um repositório do GitHub privado, consulte uma solução personalizada documentada em Criar uma oferta personalizada e segura portal do Azure. É possível criar uma função do Azure que extraia o token do GitHub do Azure Key Vault.

Você ainda pode usar o botão Implantar no Azure mesmo se estiver usando o Git com Azure Repos em vez de um repositório GitHub. Verifique se o seu repositório é público. Use a Operação itens para obter o modelo. A sua solicitação 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

Modelo armazenado na conta de armazenamento do Azure

O formato das URLs para os modelos armazenados em um contêiner público é:

https://{storage-account-name}.blob.core.windows.net/{container-name}/{template-file-name}

Por exemplo:

https://demostorage0215.blob.core.windows.net/democontainer/azuredeploy.json

É possível proteger o modelo com o token SAS. Para obter mais informações, consulte Como implantar o modelo do ARM particular com token SAS. A URL a seguir é um exemplo com o token SAS:

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

Formatar a URL

Depois de ter a URL, você precisará converter a URL em um valor codificado em URL. Você pode usar um codificador online ou executar um comando. O exemplo a seguir do PowerShell mostra como codificar um valor de URL.

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

A URL de exemplo tem o seguinte valor quando é codificada.

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

Cada link começa com a mesma URL base:

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

Adicione o link de modelo codificado de URL ao final da 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

Agora você tem a URL completa para o link.

Criar o botão Implantar no Azure

Por fim, coloque o link e a imagem juntos.

Para adicionar o botão com Markdown no arquivo LEIAME.md no repositório GitHub ou em uma página da Web, use:

[![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, use:

<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 o Git com repositório do Azure, 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)

Implantar o modelo

Selecione o seguinte botão para testar a solução completa:

Captura de tela do botão Implantar no Azure com link.

O portal exibe um painel que permite fornecer valores de parâmetro com facilidade. Os parâmetros são previamente preenchidos com os valores padrão do modelo. O nome do parâmetro camel-cased, storageAccountType, definido no modelo é transformado em uma cadeia de caracteres separada por espaço quando exibido no portal.

Captura de tela do portal do Microsoft Azure exibindo o painel para o fornecimento dos valores dos parâmetros.

Próximas etapas