Szybki start: tworzenie profilu usługi Traffic Manager przy użyciu Bicep

W tym przewodniku Szybki start opisano, jak używać Bicep do tworzenia profilu usługi Traffic Manager z zewnętrznymi punktami końcowymi przy użyciu metody routingu wydajności.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Bicep oferuje najlepsze środowisko tworzenia rozwiązań infrastruktury jako kodu na platformie Azure.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Przejrzyj plik Bicep

Plik Bicep używany w tym przewodniku Szybki start pochodzi z szablonów szybkiego startu platformy 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

Jeden zasób platformy Azure jest zdefiniowany w pliku Bicep:

• Microsoft.Network/trafficManagerProfiles

Wdrażanie pliku Bicep

1. Zapisz plik Bicep jako main.bicep na komputerze lokalnym.

2. Wdróż plik Bicep przy użyciu interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

   Interfejs wiersza polecenia

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

   Program PowerShell

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

   Wdrożenie pliku Bicep tworzy profil z dwoma zewnętrznymi punktami końcowymi. Punkt końcowy Endpoint1 używa docelowego punktu końcowego www.microsoft.com z lokalizacją w Europie Północnej. Punkt końcowy Endpoint2 używa docelowego punktu końcowego learn.microsoft.com z lokalizacją w południowo-środkowych stanach USA.

   Uwaga

   nazwa uniqueDNSname musi być globalnie unikatową nazwą, aby plik Bicep został pomyślnie wdrożony.

   Po zakończeniu wdrażania zostanie wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Weryfikowanie wdrożenia

Użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby zweryfikować wdrożenie.

1. Określ nazwę DNS profilu usługi Traffic Manager.

   Interfejs wiersza polecenia

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

   Z danych wyjściowych skopiuj wartość fqdn . Będzie on mieć następujący format: <relativeDnsName>.trafficmanager.net. Ta wartość jest również nazwą DNS profilu usługi Traffic Manager.

   Program PowerShell

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

   Skopiuj wartość RelativeDnsName. Nazwa DNS profilu usługi Traffic Manager to <relativeDnsName>.trafficmanager.net.

2. Uruchom następujące polecenie, zastępując zmienną {relativeDnsName} zmienną <relativeDnsName>.trafficmanager.net.

   Interfejs wiersza polecenia

   nslookup -type=cname {relativeDnsName}
   

   Należy uzyskać nazwę kanoniczną www.microsoft.com lub learn.microsoft.com w zależności od tego, który region jest bliżej Ciebie.

   Program PowerShell

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

   Powinien zostać wyświetlony element NameHost www.microsoft.com learn.microsoft.com lub w zależności od tego, który region jest bliżej Ciebie.

3. Aby sprawdzić, czy możesz rozpoznać inny punkt końcowy, wyłącz punkt końcowy dla miejsca docelowego, który został wyświetlony w ostatnim kroku. Zastąp element {endpointName} punktem końcowym1 lub punktem końcowym2, aby wyłączyć obiekt docelowy www.microsoft.com dla lub learn.microsoft.com odpowiednio.

   Interfejs wiersza polecenia

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

   Program PowerShell

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

4. Uruchom ponownie polecenie z kroku 2 w interfejsie wiersza polecenia platformy Azure lub programie Azure PowerShell. Tym razem należy pobrać inną nazwę kanoniczną/nazwę NameHost dla innego punktu końcowego.

Czyszczenie zasobów

Jeśli nie potrzebujesz już profilu usługi Traffic Manager, użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby usunąć grupę zasobów. Spowoduje to usunięcie profilu usługi Traffic Manager i wszystkich powiązanych zasobów.

Interfejs wiersza polecenia

az group delete --name exampleRG

Program PowerShell

Remove-AzResourceGroup -Name exampleRG

Następne kroki

W tym przewodniku Szybki start utworzono profil usługi Traffic Manager przy użyciu aplikacji Bicep.

Aby dowiedzieć się więcej o kierowaniu ruchu, przejdź do samouczków usługi Traffic Manager.

Samouczki usługi Traffic Manager