Início Rápido: Criar um perfil do Gestor de Tráfego com o Bicep

Artigo
06/01/2023

Este início rápido descreve como utilizar o Bicep para criar um perfil do Gestor de Tráfego com pontos finais externos com o método de encaminhamento de desempenho.

O Bicep é uma linguagem (DSL) específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipo fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para as 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.

Rever o ficheiro Bicep

O ficheiro Bicep utilizado neste início rápido é proveniente dos 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 ficheiro Bicep:

Microsoft.Network/trafficManagerProfiles

Implementar o ficheiro Bicep

Guarde o ficheiro Bicep como main.bicep no seu computador local.
Implemente o ficheiro Bicep com a CLI do Azure ou 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 implementação de ficheiros Bicep cria um perfil com dois pontos finais externos. O Ponto Final1 utiliza um ponto final de destino de www.microsoft.com com a localização na Europa do Norte. O Ponto Final2 utiliza um ponto final de destino de learn.microsoft.com com a localização nos E.U.A. Centro-Sul.

Nota

uniqueDNSname tem de ser um nome globalmente exclusivo para que o ficheiro Bicep seja implementado com êxito.

Quando a implementação terminar, verá uma mensagem a indicar que a implementação foi efetuada com êxito.

Validar a implementação

Utilize a CLI do Azure ou Azure PowerShell para validar a implementação.

Determine o nome DNS do perfil do Gestor de Tráfego.
- CLI
- PowerShell
```
az network traffic-manager profile show --name ExternalEndpointExample --resource-group exampleRG 
```
A partir da saída, copie o valor fqdn . Estará 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 perfil do Gestor de Tráfego é <relativeDnsName>.trafficmanager.net.
Execute o seguinte comando ao substituir a variável <relativeDnsName>.trafficmanager.net{relativeDnsName} por .
- CLI
- PowerShell
```
nslookup -type=cname {relativeDnsName}
```
Deve obter um nome canónico de qualquer um www.microsoft.com ou learn.microsoft.com consoante a região mais próxima de si.
```
Resolve-DnsName -Name {relativeDnsname} | Select-Object NameHost | Select -First 1
```
Deverá obter um NameHost de qualquer um www.microsoft.com ou learn.microsoft.com consoante a região mais próxima de si.

Para verificar se consegue resolver o outro ponto final, desative o ponto final do destino que obteve no último passo. Substitua { endpointName} pelo ponto final1 ou ponto final2 para desativar o destino para www.microsoft.com ou learn.microsoft.com respetivamente.

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 a partir do Passo 2 novamente na CLI do Azure ou Azure PowerShell. Desta vez, deverá obter o outro nome canónico/NameHost para o outro ponto final.

Limpar os recursos

Quando já não precisar do perfil do Gestor de Tráfego, utilize o portal do Azure, a CLI do Azure ou Azure PowerShell para eliminar o grupo de recursos. Esta ação remove o perfil do Gestor de Tráfego e todos os recursos relacionados.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Passos seguintes

Neste início rápido, criou um perfil do Gestor de Tráfego com o Bicep.

Para saber mais sobre o encaminhamento de tráfego, avance para os tutoriais do Gestor de Tráfego.

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

Share via