Tutorial: Crie e implemente o seu primeiro modelo ARMTutorial: Create and deploy your first ARM template

Este tutorial apresenta-o aos modelos do Gestor de Recursos Azure (modelos ARM).This tutorial introduces you to Azure Resource Manager templates (ARM templates). Mostra como criar um modelo de arranque e implantá-lo para Azure.It shows you how to create a starter template and deploy it to Azure. Você vai aprender sobre a estrutura do modelo e as ferramentas que você precisa para trabalhar com modelos.You'll learn about the structure of the template and the tools you'll need for working with templates. Leva cerca de 12 minutos para completar este tutorial, mas o tempo real variará com base em quantas ferramentas precisa instalar.It takes about 12 minutes to complete this tutorial, but the actual time will vary based on how many tools you need to install.

Este tutorial é o primeiro de uma série.This tutorial is the first of a series. À medida que progride através da série, modifica o modelo inicial passo a passo até que tenha explorado todas as partes centrais de um modelo ARM.As you progress through the series, you modify the starting template step by step until you've explored all of the core parts of an ARM template. Estes elementos são os blocos de construção para modelos muito mais complexos.These elements are the building blocks for much more complex templates. 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.We hope by the end of the series you're confident creating your own templates and ready to automate your deployments with templates.

Se quiser saber sobre os benefícios da utilização de modelos e por que deve automatizar a implementação com modelos, consulte os modelos do Gestor de Recursos Azure.If you want to learn about the benefits of using templates and why you should automate deployment with templates, see Azure Resource Manager templates.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Obter ferramentasGet tools

Comecemos por ter a certeza de que tem as ferramentas necessárias para criar e implementar modelos.Let's start by making sure you have the tools you need to create and deploy templates. Instale estas ferramentas na sua máquina local.Install these tools on your local machine.

EditorEditor

Os modelos são ficheiros JSON.Templates are JSON files. Para criar modelos, precisa de um bom editor JSON.To create templates, you need a good JSON editor. Recomendamos o Código do Estúdio Visual com a extensão de Ferramentas do Gestor de Recursos.We recommend Visual Studio Code with the Resource Manager Tools extension. Se precisar de instalar estas ferramentas, consulte Quickstart: Crie modelos de Gestor de Recursos Azure com Código de Estúdio Visual.If you need to install these tools, see Quickstart: Create Azure Resource Manager templates with Visual Studio Code.

Implantação da linha de comandoCommand-line deployment

Também precisa de Azure PowerShell ou Azure CLI para implementar o modelo.You also need either Azure PowerShell or Azure CLI to deploy the template. Se utilizar o Azure CLI, deve ter a versão mais recente.If you use Azure CLI, you must have the latest version. Para as instruções de instalação, consulte:For the installation instructions, see:

Depois de instalar o Azure PowerShell ou o Azure CLI, certifique-se de que faz sê-lo pela primeira vez.After installing either Azure PowerShell or Azure CLI, make sure you sign in for the first time. Para obter ajuda, consulte Iniciar s-se-in - PowerShell ou Iniciar sação - Azure CLI.For help, see Sign in - PowerShell or Sign in - Azure CLI.

Importante

Se estiver a utilizar o Azure CLI, certifique-se de que tem a versão 2.6 ou posterior.If you're using Azure CLI, make sure you have version 2.6 or later. Os comandos mostrados neste tutorial não funcionarão se estiver a utilizar versões anteriores.The commands shown in this tutorial will not work if you're using earlier versions. Para verificar a sua versão instalada, utilize: az --version .To check your installed version, use: az --version.

Está pronto para começar a aprender sobre modelos.Okay, you're ready to start learning about templates.

Criar o primeiro modeloCreate your first template

  1. Código de estúdio visual aberto com a extensão de Ferramentas do Gestor de Recursos instaladas.Open Visual Studio Code with the Resource Manager Tools extension installed.

  2. A partir do menu Ficheiro, selecione Novo Ficheiro para criar um novo ficheiro.From the File menu, select New File to create a new file.

  3. A partir do menu 'Ficheiro', selecione Guardar como.From the File menu, select Save as.

  4. Nomeie o ficheiro e selecione a extensão do ficheiro JSON.Name the file azuredeploy and select the JSON file extension. O nome completo do ficheiro azuredeploy.jsem.The complete name of the file azuredeploy.json.

  5. Guarde o ficheiro para a sua estação de trabalho.Save the file to your workstation. Selecione um caminho que seja fácil de lembrar porque irá fornecer esse caminho mais tarde ao implementar o modelo.Select a path that is easy to remember because you'll provide that path later when deploying the template.

  6. Copiar e colar o seguinte JSON no ficheiro:Copy and paste the following JSON into the file:

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

    Aqui está o seu ambiente vs Code:Here's what your VS Code environment looks like:

    Modelo de código de estúdio visual do gestor de recursos

    Este modelo não implementa recursos.This template doesn't deploy any resources. 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.We're starting with a blank template so you can get familiar with the steps to deploy a template while minimizing the chance of something going wrong.

    O ficheiro JSON tem estes elementos:The JSON file has these elements:

    • $schema: Especifica a localização do ficheiro de esquema JSON.$schema: Specifies the location of the JSON schema file. O ficheiro de esquema descreve as propriedades que estão disponíveis dentro de um modelo.The schema file describes the properties that are available within a template. Por exemplo, o esquema define os recursos como uma das propriedades válidas para um modelo.For example, the schema defines resources as one of the valid properties for a template. Não se preocupe que a data para o esquema é 2019-04-01.Don't worry that the date for the schema is 2019-04-01. Esta versão de esquema está atualizada e inclui todas as funcionalidades mais recentes.This schema version is up to date and includes all of the latest features. A data do esquema não foi alterada porque não houve alterações de rutura desde a sua introdução.The schema date hasn't been changed because there have been no breaking changes since its introduction.
    • versão de conteúdo: Especifica a versão do modelo (tal como 1.0.0.0).contentVersion: Specifies the version of the template (such as 1.0.0.0). Pode fornecer qualquer valor para este elemento.You can provide any value for this element. Utilize este valor para documentar alterações significativas no seu modelo.Use this value to document significant changes in your template. Ao utilizar recursos utilizando o modelo, este valor pode ser usado para garantir que o modelo certo está a ser utilizado.When deploying resources using the template, this value can be used to make sure that the right template is being used.
    • recursos: Contém os recursos que pretende utilizar ou atualizar.resources: Contains the resources you want to deploy or update. Atualmente, está vazio, mas vai adicionar recursos mais tarde.Currently, it's empty, but you'll add resources later.
  7. Guarde o ficheiro.Save the file.

Parabéns, criaste o teu primeiro modelo.Congratulations, you've created your first template.

Iniciar sessão no AzureSign in to Azure

Para começar a trabalhar com a Azure PowerShell/Azure CLI, inscreva-se com as suas credenciais Azure.To start working with Azure PowerShell/Azure CLI, sign in with your Azure credentials.

Connect-AzAccount

Se tiver várias subscrições do Azure, selecione a subscrição que pretende utilizar:If you have multiple Azure subscriptions, select the subscription you want to use:

Set-AzContext [SubscriptionID/SubscriptionName]

Criar grupo de recursosCreate resource group

Quando implementa um modelo, especifica um grupo de recursos que conterá os recursos.When you deploy a template, you specify a resource group that will contain the resources. Antes de executar o comando de implantação, crie o grupo de recursos com Azure CLI ou Azure PowerShell.Before running the deployment command, create the resource group with either Azure CLI or Azure PowerShell. Selecione os separadores na seguinte secção de código para escolher entre Azure PowerShell e Azure CLI.Select the tabs in the following code section to choose between Azure PowerShell and Azure CLI. Os exemplos do CLI neste artigo são escritos para a concha bash.The CLI examples in this article are written for the Bash shell.

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

Implementar o modeloDeploy template

Para implementar o modelo, utilize o Azure CLI ou o Azure PowerShell.To deploy the template, use either Azure CLI or Azure PowerShell. Utilize o grupo de recursos que criou.Use the resource group you created. Dê um nome à implementação para que possa identificá-lo facilmente no histórico de implantação.Give a name to the deployment so you can easily identify it in the deployment history. Por conveniência, também crie uma variável que armazena o caminho para o arquivo do modelo.For convenience, also create a variable that stores the path to the template file. Esta variável torna mais fácil executar os comandos de implementação, porque não tem de reescrever o caminho sempre que implementa.This variable makes it easier for you to run the deployment commands because you don't have to retype the path every time you deploy.

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

O comando de implantação retorna os resultados.The deployment command returns results. Procure ProvisioningState para ver se o destacamento foi bem sucedido.Look for ProvisioningState to see whether the deployment succeeded.

Nota

Se a implementação falhar, utilize o interruptor verboso para obter informações sobre os recursos que estão a ser criados.If the deployment failed, use the verbose switch to get information about the resources being created. Use o interruptor de depuração para obter mais informações para depurar.Use the debug switch to get more information for debugging.

Verificar a implementaçãoVerify deployment

Pode verificar a implementação explorando o grupo de recursos a partir do portal Azure.You can verify the deployment by exploring the resource group from the Azure portal.

  1. Inicie sessão no portal do Azure.Sign in to the Azure portal.

  2. A partir do menu esquerdo, selecione Grupos de Recursos.From the left menu, select Resource groups.

  3. Selecione o grupo de recursos implementar no último procedimento.Select the resource group deploy in the last procedure. O nome predefinido é myResourceGroup.The default name is myResourceGroup. Não verá nenhum recurso implantado dentro do grupo de recursos.You shall see no resource deployed within the resource group.

  4. Note-se no canto superior direito da visão geral, o estado da implantação é visualizado.Notice in the upper right of the overview, the status of the deployment is displayed. Selecione 1 Conseguiu.Select 1 Succeeded.

    Ver estado de implantação

  5. Vê-se um histórico de implantação para o grupo de recursos.You see a history of deployment for the resource group. Selecione otemplate em branco.Select blanktemplate.

    Selecione implantação

  6. Vê-se um resumo da implantação.You see a summary of the deployment. Neste caso, não há muito para ver porque não foram mobilizados recursos.In this case, there's not a lot to see because no resources were deployed. Mais tarde nesta série poderá ser útil rever o resumo do histórico de implementação.Later in this series you might find it helpful to review the summary in the deployment history. Note à esquerda, pode ver entradas, saídas e o modelo utilizado durante a implementação.Notice on the left you can view inputs, outputs, and the template used during deployment.

    Ver resumo de implementação

Limpar os recursosClean up resources

Se está a avançar para o próximo tutorial, não precisa de eliminar o grupo de recursos.If you're moving on to the next tutorial, you don't need to delete the resource group.

Se está a parar agora, é melhor apagar o grupo de recursos.If you're stopping now, you might want to delete the resource group.

  1. A partir do portal Azure, selecione Grupo de Recursos do menu esquerdo.From the Azure portal, select Resource group from the left menu.
  2. Introduza o nome do grupo de recursos no campo Filtrar por nome.Enter the resource group name in the Filter by name field.
  3. Selecione o nome do grupo de recursos.Select the resource group name.
  4. Selecione Eliminar o grupo de recursos do menu superior.Select Delete resource group from the top menu.

Passos seguintesNext steps

Criou um modelo simples para implementar para O Azure.You created a simple template to deploy to Azure. No próximo tutorial, irá adicionar uma conta de armazenamento ao modelo e implantá-la-á para o seu grupo de recursos.In the next tutorial, you'll add a storage account to the template and deploy it to your resource group.