Inicio rápido: Creación de un perfil de Traffic Manager mediante Bicep

En este inicio rápido se describe cómo usar Bicep para crear un perfil de Traffic Manager con puntos de conexión externos mediante el método de enrutamiento del rendimiento.

Bicep es un lenguaje específico de dominio (DSL) que usa una sintaxis declarativa para implementar recursos de Azure. Brinda sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

Requisitos previos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Revisión del archivo de Bicep

El archivo de Bicep usado en este inicio rápido forma parte de las plantillas de inicio rápido de 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

En el archivo Bicep se define un recurso de Azure:

• Microsoft.Network/trafficManagerProfiles

Implementación del archivo de Bicep

1. Guarde el archivo de Bicep como main.bicep en el equipo local.

2. Implemente el archivo de Bicep mediante la CLI de Azure o Azure PowerShell.

   CLI

   az group create --name exampleRG --location eastus
   az deployment group create --resource-group exampleRG --template-file main.bicep --parameters uniqueDnsName=<dns-name>
   

   PowerShell

   New-AzResourceGroup -Name exampleRG -Location eastus
   New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -uniqueDnsName "<dns-name>"
   

   La implementación del archivo Bicep crea un perfil con dos puntos de conexión externos. Endpoint1 usa un punto de conexión de destino de www.microsoft.com con la ubicación con la ubicación en Norte de Europa. Endpoint2 usa un punto de conexión de destino de learn.microsoft.com con la ubicación con la ubicación en Centro-sur de EE. UU.

   Nota

   uniqueDNSname debe ser un nombre globalmente único para que el archivo Bicep se implemente correctamente.

   Una vez finalizada la implementación, verá un mensaje que indicará que la implementación se hizo correctamente.

Validación de la implementación

Use la CLI de Azure o Azure PowerShell para validar la implementación.

1. Determine el nombre DNS del perfil de Traffic Manager.

   CLI

   az network traffic-manager profile show --name ExternalEndpointExample --resource-group exampleRG 
   

   En la salida, copie el valor fqdn. Tendrá el siguiente formato: <relativeDnsName>.trafficmanager.net. Este valor también es el nombre DNS del perfil de Traffic Manager.

   PowerShell

   Get-AzTrafficManagerProfile -Name ExternalEndpointExample -ResourceGroupName exampleRG | Select RelativeDnsName
   

   Copie el valor RelativeDnsName. El nombre DNS del perfil de Traffic Manager es <relativeDnsName>.trafficmanager.net.

2. Para ejecutar el siguiente comando, reemplace la variable {relativeDnsName} por <relativeDnsName>.trafficmanager.net.

   CLI

   nslookup -type=cname {relativeDnsName}
   

   Debería obtener un nombre canónico www.microsoft.com o learn.microsoft.com en función de la región que esté más próxima.

   PowerShell

   Resolve-DnsName -Name {relativeDnsname} | Select-Object NameHost | Select -First 1
   

   El valor de NameHost que debería obtener es www.microsoft.com o learn.microsoft.com en función de la región que esté más próxima.

3. Para comprobar si puede resolverlo en el otro punto de conexión, deshabilite el punto de conexión para el destino que recibió en el último paso. Reemplace {endpointName} por endpoint1 o endpoint2 para deshabilitar el destino de www.microsoft.com o learn.microsoft.com, respectivamente.

   CLI

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

   PowerShell

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

4. Ejecute el comando del paso 2 de nuevo en la CLI de Azure o Azure PowerShell. Esta vez, debe obtener el otro nombre canónico o valor de NameHost para el otro punto de conexión.

Limpieza de recursos

Cuando ya no necesite el perfil de Traffic Manager, use Azure Portal, la CLI de Azure o Azure PowerShell para eliminar el grupo de recursos. Esta acción quita el perfil de Traffic Manager y todos los recursos relacionados.

CLI

az group delete --name exampleRG

PowerShell

Remove-AzResourceGroup -Name exampleRG

Pasos siguientes

En esta guía de inicio rápido, ha creado un perfil de Traffic Manager mediante Manager.

Para más información sobre el enrutamiento del tráfico, continúe con los tutoriales de Traffic Manager.

Tutoriales de Traffic Manager