Vytváření prostředků služby Service Bus pomocí šablon Azure Resource Manageru

Článek
06/03/2024

Tento článek popisuje, jak vytvářet a nasazovat prostředky Service Bus pomocí šablon Azure Resource Manageru, PowerShellu a poskytovatele prostředků Service Bus.

Šablony Azure Resource Manageru pomáhají definovat prostředky, které se mají nasadit pro řešení, a zadat parametry a proměnné, které umožňují zadat hodnoty pro různá prostředí. Šablona je napsaná ve formátu JSON a skládá se z výrazů, které můžete použít k vytvoření hodnot pro vaše nasazení. Podrobné informace o psaní šablon Azure Resource Manageru a diskuzi o formátu šablon najdete v tématu struktura a syntaxe šablon Azure Resource Manageru.

Poznámka:

Příklady v tomto článku ukazují, jak pomocí Azure Resource Manageru vytvořit obor názvů služby Service Bus a entitu zasílání zpráv (frontu). Další příklady šablon najdete v galerii šablon Azure Pro rychlý start a vyhledejte Service Bus.

Poznámka:

Při práci s Azure doporučujeme používat modul Azure Az PowerShellu. Pokud chcete začít, přečtěte si téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

Šablony Service Bus Resource Manageru

Tyto šablony Service Bus Azure Resource Manageru jsou k dispozici ke stažení a nasazení. Kliknutím na následující odkazy zobrazíte podrobnosti o každé z nich s odkazy na šablony na GitHubu:

Nasazení s použitím PowerShellu

Následující postup popisuje, jak pomocí PowerShellu nasadit šablonu Azure Resource Manageru, která vytvoří obor názvů Service Bus úrovně Standard a frontu v tomto oboru názvů. Tento příklad je založený na vytvoření oboru názvů služby Service Bus se šablonou fronty . Přibližný pracovní postup je následující:

Nainstalujte PowerShell.
Vytvořte šablonu a (volitelně) soubor parametrů.
V PowerShellu se přihlaste ke svému účtu Azure.
Pokud neexistuje, vytvořte novou skupinu prostředků.
Otestujte nasazení.
V případě potřeby nastavte režim nasazení.
Nasazení šablony

Úplné informace o nasazení šablon Azure Resource Manageru najdete v tématu Nasazení prostředků pomocí šablon Azure Resource Manageru.

Instalace PowerShellu

Podle pokynů v tématu Začínáme s Azure PowerShellem nainstalujte Azure PowerShell.

Vytvořit šablonu

Naklonujte úložiště nebo zkopírujte šablonu servicebus-create-queue z GitHubu:

{
  "$schema": "https://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "serviceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusQueueName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Queue"
      }
    }
  },
  "variables": {
    "defaultSASKeyName": "RootManageSharedAccessKey",
    "authRuleResourceId": "[resourceId('Microsoft.ServiceBus/namespaces/authorizationRules', parameters('serviceBusNamespaceName'), variables('defaultSASKeyName'))]",
  "sbVersion": "2017-04-01"
  },
  "resources": [
    {
      "apiVersion": "2017-04-01",
      "name": "[parameters('serviceBusNamespaceName')]",
      "type": "Microsoft.ServiceBus/Namespaces",
      "location": "[resourceGroup().location]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusQueueName')]",
          "type": "Queues",
          "dependsOn": [
            "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
          ],
          "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"
          }
        }
      ]
    }
  ],
  "outputs": {
    "NamespaceConnectionString": {
      "type": "string",
      "value": "[listkeys(variables('authRuleResourceId'), variables('sbVersion')).primaryConnectionString]"
    },
    "SharedAccessPolicyPrimaryKey": {
      "type": "string",
      "value": "[listkeys(variables('authRuleResourceId'), variables('sbVersion')).primaryKey]"
    }
  }
}

Vytvoření souboru parametrů (volitelné)

Pokud chcete použít volitelný soubor parametrů, zkopírujte soubor servicebus-create-queue . Nahraďte hodnotu serviceBusNamespaceName názvem oboru názvů služby Service Bus, který chcete vytvořit v tomto nasazení, a nahraďte hodnotu serviceBusQueueName názvem fronty, kterou chcete vytvořit.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "serviceBusNamespaceName": {
            "value": "<myNamespaceName>"
        },
        "serviceBusQueueName": {
            "value": "<myQueueName>"
        },
        "serviceBusApiVersion": {
            "value": "2017-04-01"
        }
    }
}

Další informace najdete v článku Parametry .

Přihlaste se k Azure a nastavte předplatné Azure.

Z příkazového řádku PowerShellu spusťte následující příkaz:

Connect-AzAccount

Zobrazí se výzva, abyste se přihlásili ke svému účtu Azure. Po přihlášení spusťte následující příkaz a zobrazte dostupná předplatná:

Get-AzSubscription

Tento příkaz vrátí seznam dostupných předplatných Azure. Spuštěním následujícího příkazu zvolte předplatné pro aktuální relaci. Nahraďte <YourSubscriptionId> identifikátorEM GUID předplatného Azure, které chcete použít:

Set-AzContext -SubscriptionID <YourSubscriptionId>

Nastavení skupiny prostředků

Pokud nemáte existující skupinu prostředků, vytvořte novou skupinu prostředků pomocí příkazu New-AzResourceGroup . Zadejte název skupiny prostředků a umístění, které chcete použít. Příklad:

New-AzResourceGroup -Name MyDemoRG -Location "West US"

V případě úspěchu se zobrazí souhrn nové skupiny prostředků.

ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG

Otestování nasazení

Spuštěním rutiny Test-AzResourceGroupDeployment ověřte nasazení. Při testování nasazení zadejte parametry přesně tak, jako byste při provádění nasazení.

Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Vytvoření nasazení

Pokud chcete vytvořit nové nasazení, spusťte rutinu New-AzResourceGroupDeployment a po zobrazení výzvy zadejte potřebné parametry. Parametry zahrnují název nasazení, název vaší skupiny prostředků a cestu nebo adresu URL souboru šablony. Pokud není zadaný parametr Mode, použije se výchozí hodnota Přírůstkové. Další informace najdete v tématu Přírůstkové a úplné nasazení.

Následující příkaz vás vyzve k zadání tří parametrů v okně PowerShellu:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Pokud chcete místo toho zadat soubor parametrů, použijte následující příkaz:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json

Při spuštění rutiny nasazení můžete také použít vložené parametry. Příkaz vypadá takto:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"

Pokud chcete spustit úplné nasazení, nastavte parametr Mode na Hodnotu Dokončeno:

New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Ověření nasazení

Pokud se prostředky úspěšně nasadí, zobrazí se v okně PowerShellu souhrn nasazení:

DeploymentName    : MyDemoDeployment
ResourceGroupName : MyDemoRG
ProvisioningState : Succeeded
Timestamp         : 4/19/2017 10:38:30 PM
Mode              : Incremental
TemplateLink      :
Parameters        :
                    Name             Type                       Value
                    ===============  =========================  ==========
                    serviceBusNamespaceName  String             <namespaceName>
                    serviceBusQueueName  String                 <queueName>
                    serviceBusApiVersion  String                2017-04-01

Další kroky

Seznámili jste se se základními pracovními postupy a příkazy pro nasazení šablony Azure Resource Manageru. Podrobnější informace najdete na následujících odkazech:

Sdílet prostřednictvím