Hızlı Başlangıç: ARM şablonu kullanarak olay hub'ı oluşturma

Makale
03/08/2024

Bu hızlı başlangıçta, Azure Resource Manager şablonu (ARM şablonu) kullanarak bir olay hub'ı oluşturacaksınız. Bir olay hub'ı ile Event Hubs türünde bir ad alanı oluşturmak için bir ARM şablonu dağıtırsınız.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Azure Event Hubs'ı yeni kullanıyorsanız bkz . Event Hubs'a genel bakış ve Event Hubs özellikleri.

Şablonu gözden geçirme

Bu hızlı başlangıçta kullanılan şablon Azure Hızlı Başlangıç Şablonlarından alınmıştır.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "16940368634879422816"
    }
  },
  "parameters": {
    "projectName": {
      "type": "string",
      "metadata": {
        "description": "Specifies a project name that is used to generate the Event Hub name and the Namespace name."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specifies the Azure location for all resources."
      }
    },
    "eventHubSku": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Basic",
        "Standard"
      ],
      "metadata": {
        "description": "Specifies the messaging tier for Event Hub Namespace."
      }
    }
  },
  "variables": {
    "eventHubNamespaceName": "[format('{0}ns', parameters('projectName'))]",
    "eventHubName": "[parameters('projectName')]"
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces",
      "apiVersion": "2021-11-01",
      "name": "[variables('eventHubNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('eventHubSku')]",
        "tier": "[parameters('eventHubSku')]",
        "capacity": 1
      },
      "properties": {
        "isAutoInflateEnabled": false,
        "maximumThroughputUnits": 0
      }
    },
    {
      "type": "Microsoft.EventHub/namespaces/eventhubs",
      "apiVersion": "2021-11-01",
      "name": "[format('{0}/{1}', variables('eventHubNamespaceName'), variables('eventHubName'))]",
      "properties": {
        "messageRetentionInDays": 7,
        "partitionCount": 1
      },
      "dependsOn": [
        "[resourceId('Microsoft.EventHub/namespaces', variables('eventHubNamespaceName'))]"
      ]
    }
  ]
}

Şablonda tanımlanan kaynaklar şunlardır:

Daha fazla şablon örneği bulmak için bkz . Azure Hızlı Başlangıç Şablonları.

Şablonu dağıtma

Azure portalı kullanıcı arabirimini kullanma

Ortamınız önkoşulları karşılıyorsa ve ARM şablonlarını kullanma hakkında bilginiz varsa, Azure’a dağıtma düğmesini seçin. Şablon Azure portalında açılır.
Mevcut bir kaynak grubunu seçin veya bir kaynak grubu oluşturun ve seçin.
Bölgeyi seçin.
Proje için benzersiz bir ad girin. Bu ad, bir Event Hubs ad alanı ve ad alanında bir olay hub'ı için ad oluşturmak için kullanılır.
Gözden geçir ve oluştur’u seçin.
Gözden Geçir + oluştur sayfasında Oluştur'u seçin.

Azure Cloud Shell’i kullanma

Şablonu Azure Cloud Shell kullanarak dağıtmak için:

Aşağıdaki kod bloğundan Cloud Shell'i Aç'ı seçin ve ardından Azure Cloud Shell'de oturum açmak için yönergeleri izleyin.

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${projectName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-eventhub/azuredeploy.json"

New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -projectName $projectName

Write-Host "Press [ENTER] to continue ..."

Olay hub'ı oluşturmak birkaç dakika sürer.

PowerShell betiğini kopyalamak için Kopyala'yı seçin.
Kabuk konsoluna sağ tıklayın ve yapıştır'ı seçin.
Komutları çalıştırmak için ENTER tuşuna basın.

Dağıtımı doğrulama

Dağıtımı doğrulamak için kaynak grubunu Azure portalından açabilir veya aşağıdaki Azure PowerShell betiğini kullanabilirsiniz. Cloud Shell hala açıksa, ilk satırı (Okuma Konağı) kopyalamanız/çalıştırmanız gerekmez.

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"
$namespaceName = "${projectName}ns"

Get-AzEventHub -ResourceGroupName $resourceGroupName -Namespace $namespaceName

Write-Host "Press [ENTER] to continue ..."

Kaynakları temizleme

Artık Azure kaynakları gerekli değilse, kaynak grubunu silerek dağıttığınız kaynakları temizleyin. Cloud Shell hala açıksa, ilk satırı (Okuma Konağı) kopyalamanız/çalıştırmanız gerekmez.

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"

Remove-AzResourceGroup -ResourceGroupName $resourceGroupName

Write-Host "Press [ENTER] to continue ..."

Sonraki adımlar

Bu makalede, bir Event Hubs ad alanı ve ad alanında bir olay hub'ı oluşturdunuz. Olay hub'ından olay göndermeye (veya) olay almaya yönelik adım adım yönergeler için bkz . Olayları gönderme ve alma öğreticileri: