Guida introduttiva: Creare uno spazio dei nomi del bus di servizio e una coda usando un file Bicep

  • Articolo

Questo articolo illustra come usare un file Bicep che crea uno spazio dei nomi del bus di servizio e una coda all'interno di tale spazio dei nomi. L'articolo spiega come specificare le risorse da distribuire e come definire i parametri che devono essere specificati quando viene eseguita la distribuzione. È possibile usare questo file Bicep per le proprie distribuzioni o personalizzarlo per soddisfare i requisiti.

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('Name of the Service Bus namespace')
param serviceBusNamespaceName string

@description('Name of the Queue')
param serviceBusQueueName string

@description('Location for all resources.')
param location string = resourceGroup().location

resource serviceBusNamespace 'Microsoft.ServiceBus/namespaces@2022-01-01-preview' = {
  name: serviceBusNamespaceName
  location: location
  sku: {
    name: 'Standard'
  }
  properties: {}
}

resource serviceBusQueue 'Microsoft.ServiceBus/namespaces/queues@2022-01-01-preview' = {
  parent: serviceBusNamespace
  name: serviceBusQueueName
  properties: {
    lockDuration: 'PT5M'
    maxSizeInMegabytes: 1024
    requiresDuplicateDetection: false
    requiresSession: false
    defaultMessageTimeToLive: 'P10675199DT2H48M5.4775807S'
    deadLetteringOnMessageExpiration: false
    duplicateDetectionHistoryTimeWindow: 'PT10M'
    maxDeliveryCount: 10
    autoDeleteOnIdle: 'P10675199DT2H48M5.4775807S'
    enablePartitioning: false
    enableExpress: false
  }
}

Le risorse definite nel file Bicep includono:

Nota

I modelli di Azure Resource Manager seguenti sono disponibili per il download e la distribuzione.

Altri modelli bicep/ARM sono disponibili in Modelli di avvio rapido di Azure

Distribuire il file Bicep

Con questo file Bicep si distribuisce uno spazio dei nomi del bus di servizio con una coda.

Le code del bus di servizio consentono un recapito dei messaggi di tipo FIFO (First In, First Out) a uno o più consumer concorrenti.

  1. Salvare il file Bicep come main.bicep nel computer locale.

  2. Distribuire il file Bicep usando l'interfaccia della riga di comando di Azure o Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep

    Verrà richiesto di immettere i valori dei parametri seguenti:

    • serviceBusNamespaceName: nome dello spazio dei nomi del bus di servizio.
    • serviceBusQueueName: nome della coda.

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

Convalidare la distribuzione

Usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per elencare le risorse distribuite nel gruppo di risorse.

az resource list --resource-group exampleRG

Pulire le risorse

Quando non è più necessario, usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per eliminare la macchina virtuale e tutte le risorse nel gruppo di risorse.

az group delete --name exampleRG

Passaggi successivi

Vedere l'argomento seguente che illustra come creare una regola di autorizzazione per lo spazio dei nomi o la coda:

Creare una regola di autorizzazione del bus di servizio per spazio dei nomi e coda usando un modello di Azure Resource Manager

Per informazioni su come gestire queste risorse, vedere gli articoli seguenti: