Inicio rápido: Creación de una cola y un espacio de nombres de Service Bus usando un archivo de Bicep

  • Artículo

En este artículo se muestra cómo utilizar un archivo Bicep que crea una cola y un espacio de nombres de Service Bus dentro de un espacio de nombres. En el artículo se explica cómo especificar los recursos que se implementan y cómo definir los parámetros que se especifican cuando se ejecuta la implementación. Puede usar este archivo de Bicep para sus propias implementaciones o personalizarlo a su gusto.

Bicep es un lenguaje específico de dominio (DSL) que usa una sintaxis declarativa para implementar recursos de Azure. Brinda sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

Requisitos previos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Revisión del archivo de Bicep

El archivo de Bicep usado en este inicio rápido forma parte de las plantillas de inicio rápido de 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
  }
}

Entre los recursos definidos en el archivo Bicep se incluyen los siguientes:

Nota

Las siguientes plantillas de ARM están disponibles para su descarga e implementación.

Puede encontrar más plantillas de ARM o Bicep en las plantillas de inicio rápido de Azure.

Implementación del archivo de Bicep

Con este archivo Bicep, implementa un espacio de nombres de Service Bus con una cola.

Las colas de Service Bus ofrecen una entrega de mensajes según el modelo “primero en entrar, primero en salir” (FIFO) a uno o más consumidores de la competencia.

  1. Guarde el archivo de Bicep como main.bicep en el equipo local.

  2. Implemente el archivo de Bicep mediante la CLI de Azure o Azure PowerShell.

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

    Se le pedirá que escriba los siguientes valores de parámetro:

    • serviceBusNamespaceName: nombre del espacio de nombres de Service Bus.
    • serviceBusQueueName: nombre de la cola.

    Una vez finalizada la implementación, debería mostrarse un mensaje indicando que la implementación se realizó correctamente.

Validación de la implementación

Use los Azure Portal, CLI de Azure o Azure PowerShell para enumerar los recursos implementados en el grupo de recursos.

az resource list --resource-group exampleRG

Limpieza de recursos

Cuando ya no los necesite, use Azure Portal, la CLI de Azure o Azure PowerShell para eliminar la máquina virtual y todos los recursos del grupo de recursos.

az group delete --name exampleRG

Pasos siguientes

Vea el siguiente tema, en el que se explica cómo crear una regla de autorización para la cola o el espacio de nombres:

Creación de una regla de autorización de Service Bus para un espacio de nombres y una cola mediante una plantilla de Resource Manager

Vea los siguientes artículos para aprender a administrar estos recursos: