Tutorial: Crie e implemente o seu primeiro modelo ARM

Este tutorial apresenta-o aos modelos Azure Resource Manager (modelos ARM). Mostra como criar um modelo de arranque e implantá-lo para Azure. Ensina-lhe sobre a estrutura do modelo e as ferramentas que precisa para trabalhar com modelos. Esta instrução leva 12 minutos para ser concluída, mas o tempo de acabamento real varia com base em quantas ferramentas precisa de instalar.

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

Se quiser saber sobre os benefícios da utilização de modelos e por que deve automatizar implementações com modelos, consulte a visão geral do modelo ARM. Para aprender sobre os modelos ARM através de um conjunto guiado de módulos Learn, consulte Implementar e gerir recursos em Azure utilizando modelos JSON ARM.

Se não tiver uma subscrição Microsoft Azure, crie uma conta gratuita antes de começar.

Dica

Se você é novo em modelos ARM, você pode considerar aprender Bicep em vez disso. Bicep é uma nova linguagem que oferece as mesmas capacidades que os modelos ARM, mas com uma sintaxe mais fácil de usar. Para começar a aprender Bicep, consulte Quickstart: Crie ficheiros Bicep com Código de Estúdio Visual.

Obter ferramentas

Comecemos por ter a certeza de que tem as ferramentas necessárias para criar e implementar modelos. Instale estas ferramentas na sua máquina local.

Editor

Os modelos são ficheiros JavaScript Object Notation (JSON). Para criar modelos, precisa de um bom editor JSON. Recomendamos código de estúdio visual com a extensão Azure Resource Manager Tools. Se precisar de instalar estas ferramentas, consulte Quickstart: Crie modelos ARM com Código de Estúdio Visual.

Implantação da linha de comando

Você também precisa de Azure PowerShell ou Azure Command-Line Interface (CLI) para implementar o modelo. Se utilizar o Azure CLI, tem de ter a versão 2.37.0 ou mais tarde. Para as instruções de instalação, consulte:

Depois de instalar Azure PowerShell ou Azure CLI, certifique-se de que faz sê-lo pela primeira vez. Para obter ajuda, consulte Iniciar s-se-in - PowerShell ou Iniciar sação - Azure CLI.

Importante

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

Está pronto para começar a aprender sobre modelos.

Criar o primeiro modelo

  1. Abra o Código do Estúdio Visual com a extensão de ferramentas do processador ARM instalado.

  2. A partir do menu 'Ficheiro' selecione Novo Ficheiro para criar um novo ficheiro.

  3. No menu Ficheiro, selecione Guardar como.

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

  5. Guarde o ficheiro para a sua estação de trabalho. Selecione um caminho que seja fácil de lembrar porque precisa fornecer esse caminho mais tarde ao implementar o modelo.

  6. Copiar e colar o seguinte JSON no ficheiro:

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

    Aqui está o seu ambiente visual Studio Code:

    Modelo de arm Visual Studio Code primeiro modelo.

    Este modelo não implementa recursos. Estamos começando com um modelo em branco para que você possa se familiarizar com os passos para implementar um modelo, minimizando a chance de algo correr mal.

    O ficheiro JSON tem estes elementos:

    • $schema: Especifica a localização do ficheiro de esquema JSON. O ficheiro de esquema descreve as propriedades que estão disponíveis dentro de um modelo. O esquema, por exemplo, define como uma das propriedades válidas resources para um modelo. Não se preocupe que a data para o esquema é 2019-04-01. Esta versão de esquema está atualizada e inclui todas as funcionalidades mais recentes. A data do esquema não foi alterada porque não houve alterações de rutura desde a sua introdução.
    • contentVersion: Especifica a versão do modelo, tal como 1.0.0.0. Pode fornecer qualquer valor para este elemento. Utilize este valor para documentar alterações significativas no seu modelo. Ao implementar recursos utilizando o modelo, pode utilizar este valor para se certificar de que está a utilizar o modelo certo.
    • resources: Contém os recursos que pretende utilizar ou atualizar. Atualmente, está vazio, mas pode adicionar recursos mais tarde.
  7. Guarde o ficheiro.

Parabéns, criaste o teu primeiro modelo.

Iniciar sessão no Azure

Para começar a trabalhar com Azure PowerShell ou Azure CLI, inicie sação com as suas credenciais Azure.

Selecione os separadores nas seguintes secções de código para escolher entre Azure PowerShell e Azure CLI. Os exemplos do CLI neste artigo são escritos para a concha bash.

Connect-AzAccount

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

Set-AzContext SubscriptionName

Criar grupo de recursos

Ao implementar um modelo, pode especificar um grupo de recursos para incluir os recursos. Antes de executar o comando de implementação, crie o grupo de recursos com o Bash a CLI do Azure ou o Azure PowerShell.

Nota

As amostras para o CLI Azure são escritas para a casca de bash. Para executar esta amostra em Windows PowerShell ou no Pedido de Comando, poderá ser necessário remover as barras traseiras e escrever o comando como uma linha como:

az group create --name myResourceGroup --location "Central US"

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

Implementar o modelo

Para implementar o modelo, utilize o Azure CLI ou Azure PowerShell. Use o grupo de recursos que criou. Dê um nome à implementação para que possa identificá-lo facilmente no histórico de implantação. Por conveniência, também crie uma variável que armazena o caminho para o arquivo do modelo. Esta variável torna mais fácil executar os comandos de implementação, porque não tem de reescrever o caminho sempre que implementa. Substitua {provide-the-path-to-the-template-file} e as chaves {} encaracoladas pelo caminho para o seu ficheiro de modelo.

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

O comando de implantação retorna os resultados. ProvisioningState Procure para ver se o destacamento foi bem sucedido.

Nota

Se a implementação falhar, utilize o verbose interruptor para obter informações sobre os recursos que estão a ser criados. Use o debug interruptor para obter mais informações para depuração.

Verificar a implementação

Pode verificar a implementação explorando o grupo de recursos a partir do portal do Azure.

  1. Inicie sessão no portal do Azure.

  2. A partir do menu esquerdo, selecione Grupos de Recursos.

  3. Verifique a caixa à esquerda do myResourceGroup e selecione myResourceGroup.

  4. Selecione o grupo de recursos que criou no procedimento anterior. O nome predefinido é myResourceGroup. O grupo de recursos ainda não tem recursos porque implementou um modelo em branco.

  5. Note-se no meio da visão geral, na secção Essencial , a página apresenta o estado de implantação ao lado das Implementações. Selecione 1 Conseguiu.

    Ver estado de implantação.

  6. Vê-se um histórico de implantação para o grupo de recursos. Verifique a caixa à esquerda da placa em branco e selecione o blanktemplate.

    Selecione a implementação.

  7. Vê-se um resumo da implantação. Neste caso, não há muito para ver porque não há recursos. Mais tarde nesta série poderá ser útil rever o resumo do histórico de implementação. Note à esquerda, pode ver entradas, saídas e o modelo que a implementação utilizou.

    Consulte o resumo da implantação.

Limpar os recursos

Se for para o próximo tutorial, não precisa de eliminar o grupo de recursos.

Se está a parar agora, é melhor apagar o grupo de recursos.

  1. A partir do portal do Azure, selecione grupos de recursos do menu esquerdo.

  2. Digite o nome do grupo de recursos no Filtro para qualquer campo... campo de texto.

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

  4. Selecione Eliminar o grupo de recursos do menu superior.

    Ver supressão.

Passos seguintes

Criou um modelo simples para implementar para OZure. No próximo tutorial, pode aprender a adicionar uma conta de armazenamento ao modelo e implantá-la no seu grupo de recursos.