Partager via

Démarrage rapide : créer un profil Traffic Manager en utilisant Bicep

  • Article

Ce guide de démarrage rapide explique comment utiliser Bicep pour créer un profil Traffic Manager avec des points de terminaison externes en utilisant la méthode de routage des performances.

Bicep est un langage spécifique à un domaine (DSL) qui utilise la syntaxe déclarative pour déployer des ressources Azure. Il fournit une syntaxe concise, une cohérence des types fiable et une prise en charge de la réutilisation du code. Bicep offre la meilleure expérience de création pour vos solutions d’infrastructure en tant que code dans Azure.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Examiner le fichier Bicep

Le fichier Bicep utilisé dans ce guide de démarrage rapide est tiré des modèles de démarrage rapide 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

Une seule ressource Azure est définie dans le fichier Bicep :

Déployer le fichier Bicep

  1. Enregistrez le fichier Bicep en tant que main.bicep sur votre ordinateur local.

  2. Déployez le fichier Bicep à l’aide d’Azure CLI ou d’Azure PowerShell.

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

    Le déploiement du fichier Bicep crée un profil avec deux points de terminaison externes. Endpoint1 utilise un point de terminaison cible de www.microsoft.com avec comme emplacement Europe Nord. Endpoint2 utilise un point de terminaison cible de learn.microsoft.com avec comme localisation USA Centre Sud.

    Notes

    uniqueDNSname doit être un nom global unique pour que le fichier Bicep puisse être déployé correctement.

    Une fois le déploiement terminé, un message doit s’afficher pour indiquer que le déploiement a réussi.

Valider le déploiement

Utilisez Azure CLI ou Azure PowerShell pour valider le déploiement.

  1. Déterminez le nom DNS du profil Traffic Manager.

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

    Copiez la valeur fqdn dans la sortie. Celle-ci sera au format suivant : <relativeDnsName>.trafficmanager.net. Cette valeur correspond également au nom DNS de votre profil Traffic Manager.

  2. Exécutez la commande suivante en remplaçant la variable {relativeDnsName} par <relativeDnsName>.trafficmanager.net.

    nslookup -type=cname {relativeDnsName}

    Vous devez obtenir le nom canonique www.microsoft.com ou learn.microsoft.com, en fonction de la région qui est la plus proche de vous.

  3. Pour vérifier si vous pouvez résoudre l’autre point de terminaison, désactivez le point de terminaison pour la cible que vous avez obtenu lors de la dernière étape. Remplacez {endpointName} par endpoint1 ou endpoint2 pour désactiver la cible pour www.microsoft.com ou learn.microsoft.com, respectivement.

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

  4. Réexécutez la commande de l’étape 2 dans Azure CLI ou Azure PowerShell. Cette fois, vous devez obtenir l’autre nom canonique/NameHost pour l’autre point de terminaison.

Nettoyer les ressources

Lorsque vous n’avez plus besoin du profil Traffic Manager, utilisez le Portail Azure, Azure CLI ou Azure PowerShell pour supprimer le groupe de ressources. Cette action supprime le profil Traffic Manager et toutes les ressources associées.

az group delete --name exampleRG

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un profil Traffic Manager en utilisant Bicep.

Pour plus d’informations sur le routage du trafic, passez aux tutoriels Traffic Manager.

Didacticiels Traffic Manager