Guida introduttiva: Creare un profilo di Gestione traffico con Bicep

Articolo
06/14/2024

Questa guida introduttiva descrive come usare Bicep per creare un profilo Gestione traffico con endpoint esterni usando il metodo di routing delle prestazioni.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, indipendenza dai tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Esaminare il file Bicep

Il file Bicep usato in questo avvio rapido proviene dai modelli di avvio rapido di 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

Nel file Bicep è definita una risorsa di Azure:

Microsoft.Network/trafficManagerProfiles

Distribuire il file Bicep

Salvare il file Bicep come main.bicep nel computer locale.
Distribuisci il file Bicep usando l'interfaccia della riga di comando di Azure o 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>"
```
La distribuzione di file Bicep crea un profilo con due endpoint esterni. Endpoint1 usa un endpoint di destinazione www.microsoft.com con località Europa settentrionale. Endpoint2 usa un endpoint di destinazione learn.microsoft.com con località Stati Uniti centro-meridionali.

Nota

uniqueDNSname deve essere un nome univoco globale affinché il file Bicep venga distribuito correttamente.

Al termine della distribuzione, verrà visualizzato un messaggio che indica che la distribuzione è riuscita.

Convalidare la distribuzione

Usare l'interfaccia della riga di comando di Azure o Azure PowerShell per convalidare la distribuzione.

Determinare il nome DNS del profilo di Gestione traffico.
- CLI
- PowerShell
```
az network traffic-manager profile show --name ExternalEndpointExample --resource-group exampleRG 
```
Nell'output copiare il valore fqdn . Sarà nel formato seguente: <relativeDnsName>.trafficmanager.net. Questo valore è anche il nome DNS del profilo di Gestione traffico.
```
Get-AzTrafficManagerProfile -Name ExternalEndpointExample -ResourceGroupName exampleRG | Select RelativeDnsName
```
Copiare il valore RelativeDnsName. Il nome DNS del profilo di Gestione traffico è <relativeDnsName>.trafficmanager.net.
Eseguire il comando seguente sostituendo la variabile {relativeDnsName} con <relativeDnsName>.trafficmanager.net.
- CLI
- PowerShell
```
nslookup -type=cname {relativeDnsName}
```
Si dovrebbe ottenere un nome canonico di o learn.microsoft.com a seconda dell'area www.microsoft.com più vicina all'utente.
```
Resolve-DnsName -Name {relativeDnsname} | Select-Object NameHost | Select -First 1
```
Si dovrebbe ottenere il NameHost www.microsoft.com o learn.microsoft.com, in base all'area più vicina.

Per verificare se è possibile risolvere l'altro endpoint, disabilitare l'endpoint per la destinazione ottenuta nel passaggio precedente. Sostituire {endpointName} con endpoint1 o endpoint2 per disabilitare la destinazione per www.microsoft.com o learn.microsoft.com rispettivamente.

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

Eseguire di nuovo il comando dal passaggio 2 nell'interfaccia della riga di comando di Azure o in Azure PowerShell. Questa volta, si dovrebbe ottenere l'altro nome canonico/NameHost per l'altro endpoint.

Pulire le risorse

Quando il profilo di Gestione traffico non è più necessario, usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per eliminare il gruppo di risorse. Oltre al profilo di Gestione traffico verranno rimosse tutte le risorse correlate.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Passaggi successivi

In questa guida introduttiva è stato creato un profilo Gestione traffico usando Bicep.

Per altre informazioni su come instradare il traffico, passare alle esercitazioni di Gestione traffico.

Esercitazioni di Gestione traffico

Condividi tramite