Criar uma zona e um registro DNS do Azure usando um modelo ARM

2024-11-06

Este guia de início rápido descreve como usar um modelo do Azure Resource Manager (modelo do ARM) para criar uma zona DNS que contém um registro A.

Um Modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo usa a sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se seu ambiente atender aos pré-requisitos e você estiver familiarizado com o uso de modelos ARM, selecione o botão Implantar no Azure. O modelo será aberto no portal do Azure.

Pré-requisitos

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

Examinar o modelo

O modelo usado neste início rápido é proveniente dos Modelos de Início Rápido do Azure.

Neste guia de início rápido, você criará uma zona DNS exclusiva com o sufixo azurequickstart.org. Um registro A apontando para dois endereços IP também será colocado na zona.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.30.23.60470",
      "templateHash": "418957128302192274"
    }
  },
  "parameters": {
    "zoneName": {
      "type": "string",
      "defaultValue": "[format('{0}.azurequickstart.org', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "The name of the DNS zone to be created.  Must have at least 2 segments, e.g. hostname.org"
      }
    },
    "recordName": {
      "type": "string",
      "defaultValue": "www",
      "metadata": {
        "description": "The name of the DNS record to be created.  The name is relative to the zone, not the FQDN."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Network/dnsZones",
      "apiVersion": "2018-05-01",
      "name": "[parameters('zoneName')]",
      "location": "global"
    },
    {
      "type": "Microsoft.Network/dnsZones/A",
      "apiVersion": "2018-05-01",
      "name": "[format('{0}/{1}', parameters('zoneName'), parameters('recordName'))]",
      "properties": {
        "TTL": 3600,
        "ARecords": [
          {
            "ipv4Address": "203.0.113.1"
          },
          {
            "ipv4Address": "203.0.113.2"
          }
        ]
      },
      "dependsOn": [
        "[resourceId('Microsoft.Network/dnsZones', parameters('zoneName'))]"
      ]
    }
  ],
  "outputs": {
    "nameServers": {
      "type": "array",
      "value": "[reference(resourceId('Microsoft.Network/dnsZones', parameters('zoneName')), '2018-05-01').nameServers]"
    }
  }
}

Dois recursos do Azure foram definidos no modelo:

Microsoft.Network/dnsZones
Microsoft.Network/dnsZones/A: Usado para criar um registro A na zona.

Para encontrar mais modelos relacionados ao Gerenciador de Tráfego do Azure, confira Modelos de início rápido do Azure.

Implantar o modelo

Clique em Experimentar no bloco de código a seguir para abrir o Azure Cloud Shell e então acompanhe as instruções para entrar no Azure.

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.network/azure-dns-new-zone/azuredeploy.json"

$resourceGroupName = "${projectName}rg"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri

Read-Host -Prompt "Press [ENTER] to continue ..."

Aguarde até ver o prompt do console.

Selecione Copiar no bloco de códigos anterior para copiar o script do PowerShell.
Clique com o botão direito do mouse no painel do console do shell e selecione Colar.
Insira os valores.

A implantação de modelo cria uma zona com um registro A que aponta para dois endereços IP. O nome do grupo de recursos é o nome do projeto com o acréscimo de rg.

O modelo leva alguns segundos para ser implantado. Quando tiver concluído, a saída deverá ser semelhante a:

O Azure PowerShell é usado para implantar o modelo. Além do Azure PowerShell, você também pode usar o portal do Azure, a CLI do Azure e a API REST. Para saber mais sobre outros métodos de implantação, confira Implantar modelos.

Validar a implantação

Entre no portal do Azure.
Escolha Grupos de recursos no painel esquerdo.
Selecione o grupo de recursos criado na seção anterior. O nome do grupo de recursos padrão é o nome do projeto com o acréscimo de rg.
O grupo de recursos deve conter os seguintes recursos vistos aqui:
Selecione a zona DNS com o sufixo azurequickstart.org para verificar se a zona foi criada corretamente com um registro A referenciando os valores 203.0.113.1 e 203.0.113.2.
Copie um dos nomes de servidor de nomes da etapa anterior.
Abra um prompt de comando e execute o seguinte:
```
nslookup www.<dns zone name> <name server name>
```
Por exemplo:
```
nslookup www.2lwynbseszpam.azurequickstart.org ns1-09.azure-dns.com.
```
Você deverá ver algo semelhante à seguinte captura de tela:

O nome do host www.2lwynbseszpam.azurequickstart.org resolve para 203.0.113.1 e 203.0.113.2 conforme você o configurou. Esse resultado verifica se a resolução do nome está funcionando corretamente.

Limpar os recursos

Quando não precisar mais dos recursos que você criou com a zona DNS, exclua o grupo de recursos. Essa ação remove a zona DNS e todos os recursos relacionados.

Para excluir o grupo de recursos, chame o cmdlet Remove-AzResourceGroup:

Remove-AzResourceGroup -Name <your resource group name>

Próximas etapas

Neste início rápido, você criou:

Zona DNS
Registro A

Agora que você criou sua primeira zona e o registro DNS usando um modelo do ARM, poderá criar registros para um aplicativo Web em um domínio personalizado.

Criar registros DNS para um aplicativo Web em um domínio personalizado