Udostępnij za pośrednictwem

Szybki start: tworzenie przestrzeni nazw usługi Service Bus i kolejki przy użyciu pliku Bicep

  • Artykuł

W tym artykule pokazano, jak używać pliku Bicep, który tworzy przestrzeń nazw usługi Service Bus i kolejkę w tej przestrzeni nazw. W tym artykule wyjaśniono, jak określić, które zasoby są wdrażane, oraz jak zdefiniować parametry określone podczas wdrażania. Możesz użyć tego pliku Bicep dla własnych wdrożeń lub dostosować go do swoich wymagań.

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('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
  }
}

Zasoby zdefiniowane w pliku Bicep obejmują:

Uwaga

Następujące szablony usługi ARM są dostępne do pobrania i wdrożenia.

Więcej szablonów Bicep/ARM można znaleźć w artykule Szablony szybkiego startu platformy Azure

Wdrażanie pliku Bicep

Za pomocą tego pliku Bicep wdrożysz przestrzeń nazw usługi Service Bus z kolejką.

Kolejki usługi Service Bus oferują dostarczanie komunikatów first in, first out (FIFO) do co najmniej jednego konkurencyjnego odbiorcy.

  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.

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

    Zostanie wyświetlony monit o wprowadzenie następujących wartości parametrów:

    • serviceBusNamespaceName: nazwa przestrzeni nazw usługi Service Bus.
    • serviceBusQueueName: nazwa kolejki.

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

Weryfikowanie wdrożenia

Użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby wyświetlić listę wdrożonych zasobów w grupie zasobów.

az resource list --resource-group exampleRG

Czyszczenie zasobów

Gdy maszyna wirtualna i wszystkie zasoby w grupie zasobów nie będą już potrzebne, użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

az group delete --name exampleRG

Następne kroki

Zobacz następujący temat, który pokazuje, jak utworzyć regułę autoryzacji dla przestrzeni nazw/kolejki:

Tworzenie reguły autoryzacji usługi Service Bus dla przestrzeni nazw i kolejki przy użyciu szablonu usługi ARM

Dowiedz się, jak zarządzać tymi zasobami, przeglądając następujące artykuły: