Freigeben über

Schnellstart: Erstellen eines Traffic Manager-Profils mithilfe von Bicep

  • Artikel

In dieser Schnellstartanleitung wird beschrieben, wie Sie Bicep verwenden, um mithilfe der leistungsorientierten Routingmethode ein Traffic Manager-Profil mit externen Endpunkten zu erstellen.

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

@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

In der Bicep-Datei ist eine einzelne Azure-Ressource definiert:

Bereitstellen der Bicep-Datei

  1. Speichern Sie die Bicep-Datei als main.bicep auf Ihrem lokalen Computer.

  2. Stellen Sie die Bicep-Datei entweder mit Azure CLI oder mit Azure PowerShell bereit.

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

    Bei der Bereitstellung der Bicep-Datei wird ein Profil mit zwei externen Endpunkten erstellt. Endpoint1 verwendet den Zielendpunkt www.microsoft.com mit dem Standort in Europa, Norden. Endpoint2 verwendet den Zielendpunkt learn.microsoft.com mit dem Standort in USA, Süden-Mitte.

    Hinweis

    uniqueDNSname muss ein global eindeutiger Name sein, damit die Bicep-Datei erfolgreich bereitgestellt werden kann.

    Nach Abschluss der Bereitstellung wird eine Meldung mit dem Hinweis angezeigt, dass die Bereitstellung erfolgreich war.

Überprüfen der Bereitstellung

Verwenden Sie die Azure CLI oder Azure PowerShell, um die Bereitstellung zu überprüfen.

  1. Bestimmen Sie den DNS-Namen des Traffic Manager-Profils.

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

    Kopieren Sie aus der Ausgabe den Wert fqdn. Es hat folgendes Format: <relativeDnsName>.trafficmanager.net. Dieser Wert ist auch der DNS-Name Ihres Traffic Manager-Profils.

  2. Führen Sie den folgenden Befehl aus, und ersetzen Sie dabei die Variable {relativeDnsName} durch <relativeDnsName>.trafficmanager.net.

    nslookup -type=cname {relativeDnsName}

    Abhängig davon, welche Region näher zu Ihnen liegt, sollte als kanonischer Name entweder www.microsoft.com oder learn.microsoft.com zurückgegeben werden.

  3. Um zu überprüfen, ob die Auflösung in den anderen Endpunkt möglich ist, deaktivieren Sie den Endpunkt für das im letzten Schritt abgerufene Ziel. Ersetzen Sie {endpointName} entweder durch endpoint1 oder durch endpoint2, um das Ziel für www.microsoft.com oder learn.microsoft.com zu deaktivieren.

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

  4. Führen Sie den Befehl aus Schritt 2 erneut in einer Azure CLI oder Azure PowerShell aus. Dieses Mal sollten Sie den anderen kanonischen Namen/NameHost für den anderen Endpunkt erhalten.

Bereinigen von Ressourcen

Wenn das Traffic Manager-Profil nicht mehr benötigt wird, löschen Sie die Ressourcengruppe über das Azure-Portal, mit der Azure CLI oder mit Azure PowerShell. Dadurch werden das Traffic Manager-Profil und alle zugehörigen Ressourcen entfernt.

az group delete --name exampleRG

Nächste Schritte

In dieser Schnellstartanleitung haben Sie mit Bicep ein Traffic Manager-Profil erstellt.

Weitere Informationen zum Weiterleiten des Datenverkehrs finden Sie in den Tutorials zu Traffic Manager.

Traffic Manager-Tutorials