Snabbstart: Skapa en Traffic Manager-profil med Bicep

Artikel
06/14/2024

Den här snabbstarten beskriver hur du använder Bicep för att skapa en Traffic Manager-profil med externa slutpunkter med hjälp av prestandaroutningsmetoden.

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. Det ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder den bästa redigeringsupplevelsen för dina infrastruktur-som-kod-lösningar i Azure.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Granska Bicep-filen

Bicep-filen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

@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 Azure-resurs definieras i Bicep-filen:

Microsoft.Network/trafficManagerProfiles

Distribuera Bicep-filen

Spara Bicep-filen som main.bicep på den lokala datorn.
Distribuera Bicep-filen med antingen Azure CLI eller 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>"
```
Bicep-fildistributionen skapar en profil med två externa slutpunkter. Endpoint1 använder en målslutpunkt www.microsoft.com för med platsen i Europa, norra. Endpoint2 använder en målslutpunkt learn.microsoft.com för med platsen i USA, södra centrala.

Kommentar

uniqueDNSname måste vara ett globalt unikt namn för att Bicep-filen ska kunna distribueras.

När distributionen är klar visas ett meddelande som anger att distributionen lyckades.

Verifiera distributionen

Använd Azure CLI eller Azure PowerShell för att verifiera distributionen.

Fastställa DNS-namnet på Traffic Manager-profilen.
- CLI
- PowerShell
```
az network traffic-manager profile show --name ExternalEndpointExample --resource-group exampleRG 
```
Kopiera fqdn-värdet från utdata. Det kommer att vara i följande format: <relativeDnsName>.trafficmanager.net. Det här värdet är också DNS-namnet på din Traffic Manager-profil.
```
Get-AzTrafficManagerProfile -Name ExternalEndpointExample -ResourceGroupName exampleRG | Select RelativeDnsName
```
Kopiera värdet RelativeDnsName. DNS-namnet på din Traffic Manager-profil är <relativeDnsName>.trafficmanager.net.
Kör följande kommando genom att ersätta variabeln {relativeDnsName} med <relativeDnsName>.trafficmanager.net.
- CLI
- PowerShell
```
nslookup -type=cname {relativeDnsName}
```
Du bör få ett kanoniskt namn på antingen www.microsoft.com eller learn.microsoft.com beroende på vilken region som ligger närmare dig.
```
Resolve-DnsName -Name {relativeDnsname} | Select-Object NameHost | Select -First 1
```
Du bör få en NameHost för antingen www.microsoft.com eller learn.microsoft.com beroende på vilken region som ligger närmare dig.

Om du vill kontrollera om du kan matcha mot den andra slutpunkten inaktiverar du slutpunkten för målet som du fick i det senaste steget. Ersätt {endpointName} med antingen slutpunkt1 eller slutpunkt2 för att inaktivera målet för www.microsoft.com respektivelearn.microsoft.com.

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

Kör kommandot från steg 2 igen i Azure CLI eller Azure PowerShell. Den här gången bör du hämta det andra kanoniska namnet/NameHost för den andra slutpunkten.

Rensa resurser

När du inte längre behöver Traffic Manager-profilen använder du Azure Portal, Azure CLI eller Azure PowerShell för att ta bort resursgruppen. Detta tar bort Traffic Manager-profilen och alla relaterade resurser.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Nästa steg

I den här snabbstarten skapade du en Traffic Manager-profil med Bicep.

Om du vill veta mer om att dirigera trafik kan du gå vidare till Traffic Manager-självstudierna.

Självstudier för Traffic Manager

Dela via