Partilhar via

Tutorial: Criar e implantar seu primeiro modelo ARM

Este tutorial apresenta os modelos do Azure Resource Manager (modelos ARM). Ele mostra como criar um modelo inicial e implantá-lo no Azure. Ele ensina sobre a estrutura do modelo e as ferramentas que você precisa para trabalhar com modelos. Esta instrução leva 12 minutos para ser concluída, mas o tempo real de término varia de acordo com quantas ferramentas você precisa instalar.

Este tutorial é o primeiro de uma série. À medida que você progride na série, você modifica o modelo inicial, passo a passo, até explorar todas as partes principais de um modelo ARM. Esses elementos são os blocos de construção para modelos mais complexos. Esperamos que, até o final da série, você esteja confiante em criar seus próprios modelos e pronto para automatizar suas implantações com modelos.

Se você quiser saber mais sobre os benefícios do uso de modelos e por que você deve automatizar implantações com modelos, consulte Visão geral do modelo ARM. Para saber mais sobre modelos ARM por meio de um conjunto guiado de módulos do Learn, consulte Implantar e gerenciar recursos no Azure usando modelos JSON ARM.

Se você não tiver uma assinatura do Microsoft Azure, crie uma conta gratuita antes de começar.

Sugestão

Se és novo em modelos ARM, podes considerar aprender Bicep em alternativa. Bicep é uma nova linguagem que oferece os mesmos recursos que os modelos ARM, mas com uma sintaxe mais fácil de usar. Para começar a aprender Bicep, consulte Guia de início rápido: criar arquivos Bicep com o Visual Studio Code.

Obter ferramentas

Vamos começar certificando-nos de que você tem as ferramentas necessárias para criar e implantar modelos. Instale essas ferramentas em sua máquina local.

Editor

Os modelos são arquivos JSON (JavaScript Object Notation). Para criar modelos, você pode usar o Visual Studio Code.

Implantação de linha de comando

Você também precisa do Azure PowerShell ou da CLI (Interface de Command-Line do Azure) para implantar o modelo. Se você usa a CLI do Azure, precisa ter a versão 2.37.0 ou posterior. Para obter instruções de instalação, consulte:

Depois de instalar o Azure PowerShell ou a CLI do Azure, certifique-se de entrar pela primeira vez. Para obter ajuda, consulte Entrar - PowerShell ou Entrar - CLI do Azure.

Importante

Se estiver a utilizar a CLI do Azure, certifique-se de que tem a versão 2.37.0 ou posterior. Se estiver a utilizar o Azure PowerShell, certifique-se de que tem a versão 7.2.4 ou posterior. Os comandos mostrados neste tutorial não funcionam se você estiver usando versões anteriores. Para verificar a versão instalada, use: az --version.

Ok, você está pronto para começar a aprender sobre modelos.

Crie o seu primeiro modelo

  1. Abre Visual Studio Code.

  2. No menu Arquivo , selecione Novo arquivo para criar um novo arquivo.

  3. No menu Arquivo , selecione Salvar como.

  4. Nomeie o arquivo azuredeploy e selecione a extensão de arquivo json . O nome completo do ficheiro é azuredeploy.json.

  5. Salve o arquivo em sua estação de trabalho. Selecione um caminho fácil de lembrar, pois você precisa fornecer esse caminho mais tarde ao implantar o modelo.

  6. Copie e cole o seguinte JSON no arquivo:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": []
}

    Veja a aparência do seu ambiente do Visual Studio Code:

    Captura de tela do Visual Studio Code exibindo um modelo ARM vazio com estrutura JSON no editor.

    Este modelo não efetua a implantação de quaisquer recursos. Estamos começando com um modelo em branco para que você possa se familiarizar com as etapas para implantar um modelo enquanto minimiza a chance de algo dar errado.

    O arquivo JSON tem estes elementos:

    • $schema: Especifica o local do arquivo de esquema JSON. O arquivo de esquema descreve as propriedades disponíveis em um modelo. O esquema, por exemplo, define resources como uma das propriedades válidas para um modelo. Não se preocupe que a data para o esquema é 01-04-2019. Esta versão do esquema está atualizada e inclui todos os recursos mais recentes. A data do esquema não foi alterada porque não houve alterações significativas desde a sua introdução.
    • contentVersion: Especifica a versão do modelo, como 1.0.0.0. Você pode fornecer qualquer valor para esse elemento. Use esse valor para documentar alterações significativas em seu modelo. Ao implantar recursos usando o modelo, você pode usar esse valor para se certificar de que está usando o modelo correto.
    • resources: Contém os recursos que você deseja implantar ou atualizar. Atualmente, ele está vazio, mas você pode adicionar recursos mais tarde.

  7. Salve o arquivo.

Parabéns, você criou seu primeiro modelo.

Iniciar sessão no Azure

Para começar a trabalhar com o Azure PowerShell ou a CLI do Azure, entre com suas credenciais do Azure.

Selecione as guias nas seções de código a seguir para escolher entre o Azure PowerShell e a CLI do Azure. Os exemplos de CLI neste artigo foram escritos para o shell Bash.

Connect-AzAccount

Se tiver várias subscrições do Azure, escolha a subscrição que pretende utilizar. Substitua SubscriptionName pelo nome da sua subscrição. Também pode utilizar o ID da subscrição em vez do nome da subscrição.

Set-AzContext SubscriptionName

Criar grupo de recursos

Ao implantar um modelo, você pode especificar um grupo de recursos para conter os recursos. Antes de executar o comando de implantação, crie o grupo de recursos com a CLI do Azure Bash ou o Azure PowerShell.

Observação

Os exemplos para o CLI do Azure são escritos para o bash shell. Para executar este exemplo no Windows PowerShell ou no Prompt de Comando, talvez seja necessário remover as barras invertidas e escrever o comando como uma única linha, tal como:

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Implementar o modelo

Para implantar o modelo, use a CLI do Azure ou o Azure PowerShell. Use o grupo de recursos que você criou. Dê um nome à implantação para que você possa identificá-la facilmente no histórico de implantação. Por conveniência, crie também uma variável que armazene o caminho para o arquivo de modelo. Essa variável facilita a execução dos comandos de implantação, pois não é necessário redigitar o caminho toda vez que implanta. Substitua {provide-the-path-to-the-template-file} e as chavetas {} com o caminho para o ficheiro de modelo.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

O comando deployment retorna resultados. Procure por ProvisioningState para verificar se a implantação foi bem-sucedida.

Observação

Se a implantação falhar, use a opção verbose para obter informações sobre os recursos que estão a ser criados. Use o comando debug para obter mais informações para depuração.

Verificar a implementação

Você pode verificar a implantação explorando o grupo de recursos no portal do Azure.

  1. Inicie sessão no portal Azure.

  2. No menu à esquerda, selecione Grupos de recursos.

  3. Marque a caixa à esquerda de myResourceGroup e selecione myResourceGroup.

  4. Selecione o grupo de recursos criado no procedimento anterior. O nome padrão é myResourceGroup. O grupo de recursos ainda não tem recursos porque você implantou um modelo em branco.

  5. Observe que, no meio da visão geral, na seção Essentials , a página exibe o status da implantação ao lado de Implantações. Selecione 1 Aprovado.

    Captura de ecrã do portal do Azure a mostrar o estado da implementação na secção Essentials do grupo de recursos.

  6. Pode ver um histórico de implementação para o grupo de recursos. Marque a caixa à esquerda de blanktemplate e selecione blanktemplate.

    Captura de tela do portal do Azure exibindo o histórico de implantação com a implantação de modelo em branco selecionada.

  7. Você verá um resumo da implantação. Neste caso, não há muito para ver porque não há recursos implantados. Mais adiante nesta série, você pode achar útil revisar o resumo no histórico de implantação. Observe à esquerda que você pode ver entradas, saídas e o modelo que a implantação usou.

    Captura de tela do portal do Azure mostrando o resumo da implantação para a implantação de modelo em branco.

Limpeza de recursos

Se você estiver passando para o próximo tutorial, não precisará excluir o grupo de recursos.

Se estiveres a parar agora, podes querer eliminar o grupo de recursos.

  1. No portal do Azure, selecione Grupos de recursos no menu à esquerda.

  2. Escreva o nome do grupo de recursos no campo Filtrar por qualquer campo... .

  3. Marque a caixa ao lado de myResourceGroup e selecione myResourceGroup ou o nome do seu grupo de recursos.

  4. Selecione Excluir grupo de recursos no menu superior.

    Captura de ecrã do portal do Azure com a opção Eliminar grupo de recursos realçada na vista do grupo de recursos.

Próximos passos

Você criou um modelo simples para implantar no Azure. No próximo tutorial, você pode aprender como adicionar uma conta de armazenamento ao modelo e implantá-la em seu grupo de recursos.

Adicionar recurso

  • Last updated on