Guia de início rápido: criar um perfil do Gerenciador de Tráfego usando o Bicep

Artigo
06/14/2024

Este guia de início rápido descreve como usar o Bicep para criar um perfil do Gerenciador de Tráfego com pontos de extremidade externos usando o método de roteamento de desempenho.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

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

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de Modelos de Início Rápido do Azure.

@description('Relative DNS name for the traffic manager profile, must be globally unique.')
param uniqueDnsName string

resource ExternalEndpointExample 'Microsoft.Network/trafficmanagerprofiles@2022-04-01' = {
  name: 'ExternalEndpointExample'
  location: 'global'
  properties: {
    profileStatus: 'Enabled'
    trafficRoutingMethod: 'Performance'
    dnsConfig: {
      relativeName: uniqueDnsName
      ttl: 30
    }
    monitorConfig: {
      protocol: 'HTTPS'
      port: 443
      path: '/'
      expectedStatusCodeRanges: [
        {
          min: 200
          max: 202
        }
        {
          min: 301
          max: 302
        }
      ]
    }
    endpoints: [
      {
        type: 'Microsoft.Network/TrafficManagerProfiles/ExternalEndpoints'
        name: 'endpoint1'
        properties: {
          target: 'www.microsoft.com'
          endpointStatus: 'Enabled'
          endpointLocation: 'northeurope'
        }
      }
      {
        type: 'Microsoft.Network/TrafficManagerProfiles/ExternalEndpoints'
        name: 'endpoint2'
        properties: {
          target: 'docs.microsoft.com'
          endpointStatus: 'Enabled'
          endpointLocation: 'southcentralus'
        }
      }
    ]
  }
}
output name string = ExternalEndpointExample.name
output resourceGroupName string = resourceGroup().name
output resourceId string = ExternalEndpointExample.id

Um recurso do Azure é definido no arquivo Bicep:

Microsoft.Network/trafficManagerProfiles

Implantar o arquivo Bicep

Salve o arquivo Bicep como main.bicep em seu computador local.
Implante o arquivo Bicep usando a CLI do Azure ou o Azure PowerShell.
- CLI
- PowerShell
```
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters uniqueDnsName=<dns-name>
```
```
New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -uniqueDnsName "<dns-name>"
```
A implantação do arquivo Bicep cria um perfil com dois pontos de extremidade externos. O Endpoint1 usa um endpoint de destino com a localização no norte da www.microsoft.com Europa. O ponto de extremidade2 usa um ponto de extremidade de learn.microsoft.com destino com a localização no Centro-Sul dos EUA.

Nota

uniqueDNSname precisa ser um nome globalmente exclusivo para que o arquivo Bicep seja implantado com êxito.

Quando a implantação for concluída, você verá uma mensagem indicando que a implantação foi bem-sucedida.

Validar a implementação

Use a CLI do Azure ou o Azure PowerShell para validar a implantação.

Determine o nome DNS do perfil do Gerenciador de Tráfego.
- CLI
- PowerShell
```
az network traffic-manager profile show --name ExternalEndpointExample --resource-group exampleRG 
```
Na saída, copie o valor fqdn . Será no seguinte formato: <relativeDnsName>.trafficmanager.net. Este valor é também o nome DNS do seu perfil do Gestor de Tráfego.
```
Get-AzTrafficManagerProfile -Name ExternalEndpointExample -ResourceGroupName exampleRG | Select RelativeDnsName
```
Copie o valor RelativeDnsName . O nome DNS do seu perfil do Gestor de Tráfego é <relativeDnsName>.trafficmanager.net.
Execute o seguinte comando substituindo a variável {relativeDnsName} por <relativeDnsName>.trafficmanager.net.
- CLI
- PowerShell
```
nslookup -type=cname {relativeDnsName}
```
Você deve obter um nome canônico de qualquer um www.microsoft.com ou learn.microsoft.com dependendo de qual região está mais perto de você.
```
Resolve-DnsName -Name {relativeDnsname} | Select-Object NameHost | Select -First 1
```
Você deve obter um NameHost de qualquer um www.microsoft.com ou learn.microsoft.com dependendo de qual região está mais perto de você.

Para verificar se você pode resolver para o outro ponto de extremidade, desative o ponto de extremidade para o destino que você obteve na última etapa. Substitua {endpointName} por endpoint1 ou endpoint2 para desabilitar o destino para www.microsoft.com ou learn.microsoft.com respectivamente.

CLI
PowerShell

az network traffic-manager endpoint update --name {endpointName} --type externalEndpoints --profile-name ExternalEndpointExample --resource-group exampleRG --endpoint-status "Disabled"

Disable-AzTrafficManagerEndpoint -Name {endpointName} -Type ExternalEndpoints -ProfileName ExternalEndpointExample -ResourceGroupName exampleRG -Force

Execute o comando da Etapa 2 novamente na CLI do Azure ou no Azure PowerShell. Desta vez, você deve obter o outro nome canônico/NameHost para o outro ponto de extremidade.

Clean up resources (Limpar recursos)

Quando não precisar mais do perfil do Gerenciador de Tráfego, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos. Isso remove o perfil do Gerenciador de Tráfego e todos os recursos relacionados.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximos passos

Neste início rápido, você criou um perfil do Gerenciador de Tráfego usando o Bicep.

Para saber mais sobre como rotear tráfego, continue para os tutoriais do Gerenciador de Tráfego.

Traffic Manager tutorials (Tutoriais do Gestor de Tráfego)

Partilhar via