Mulai cepat: Membuat hub acara dengan menggunakan templat ARM

  • Artikel

Dalam mulai cepat ini, Anda membuat hub acara dengan menggunakan templat Azure Resource Manager (templat ARM). Anda menyebarkan templat ARM untuk membuat namespace layanan jenis Azure Event Hubs, dengan satu hub acara.

Prasyarat

  • Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
  • Jika Anda baru menggunakan Azure Event Hubs, lihat Gambaran umum Azure Event Hubs dan fitur Azure Event Hubs.

Meninjau templat

Templat yang digunakan di mulai cepat ini berasal dari Templat Mulai Cepat Azure.

{
  "$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'))]"
      ]
    }
  ]
}

Sumber daya yang ditentukan di dalam templat meliputi:

Untuk menemukan sampel templat lainnya, lihat Templat Mulai Cepat Azure.

Menyebarkan templat

Menggunakan antarmuka pengguna portal Azure

  1. Jika lingkungan Anda telah memenuhi prasyarat dan Anda terbiasa menggunakan templat ARM, pilih tombol Sebarkan ke Azure. Templat terbuka di portal Azure.

    Button to deploy the Resource Manager template to Azure.

  2. Pilih grup sumber daya yang sudah ada atau buat grup sumber daya dan pilih grup sumber daya tersebut.

  3. Pilih wilayah.

  4. Masukkan nama unik untuk proyek. Nama ini digunakan untuk menghasilkan nama untuk namespace layanan Azure Event Hubs dan pusat aktivitas di namespace layanan.

  5. Pilih Tinjau + buat.

  6. Pada halaman Tinjau + buat, pilih Buat.

Menggunakan Azure Cloud Shell

Untuk menyebarkan templat menggunakan Azure Cloud Shell:

  1. Pilih Buka Cloud Shell dari blok kode berikut, lalu ikuti instruksi untuk masuk ke Azure Cloud Shell.

    $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 ..."

    Dibutuhkan beberapa saat untuk membuat pusat aktivitas.

  2. Pilih Salin untuk menyalin skrip PowerShell.

  3. Klik kanan konsol shell lalu pilih Tempel.

  4. Tekan ENTER untuk menjalankan perintah.

Memvalidasi penyebaran

Untuk memverifikasi penyebaran, Anda bisa membuka grup sumber daya dari portal Microsoft Azure, atau menggunakan skrip Azure PowerShell berikut ini. Jika Cloud Shell masih terbuka, Anda tidak perlu menyalin/menjalankan baris pertama (Read-Host).

$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 ..."

Membersihkan sumber daya

Saat sumber daya Azure tidak lagi diperlukan, bersihkan sumber daya yang Anda sebarkan dengan menghapus grup sumber daya. Jika Cloud Shell masih terbuka, Anda tidak perlu menyalin/menjalankan baris pertama (Read-Host).

$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 ..."

Langkah berikutnya

Dalam artikel ini, Anda membuat namespace layanan Azure Event Hubs, dan hub acara di namespace layanan. Untuk instruksi langkah demi langkah untuk mengirim peristiwa ke (atau) menerima peristiwa dari pusat aktivitas, lihat tutorial Mengirim dan menerima peristiwa: