Merelokasi topik sistem Azure Event Grid ke wilayah lain

Artikel ini membahas pendekatan, pedoman, dan praktik yang direkomendasikan untuk merelokasi topik sistem Event Grid ke wilayah lain.

Ada berbagai alasan mengapa Anda mungkin ingin memindahkan sumber daya Azure yang ada dari satu wilayah ke wilayah lain. Anda mungkin ingin:

• Manfaatkan wilayah Azure baru.
• Sebarkan fitur atau layanan yang hanya tersedia di wilayah tertentu.
• Memenuhi persyaratan kebijakan dan tata kelola internal.
• Selaras dengan merger dan akuisisi perusahaan
• Memenuhi persyaratan perencanaan kapasitas.

Berikut adalah langkah-langkah tingkat tinggi yang dibahas dalam artikel ini:

• Ekspor grup sumber daya yang berisi akun Azure Storage dan topik sistem terkait ke templat Resource Manager. Anda juga dapat mengekspor templat hanya untuk topik sistem. Jika Anda memilih rute ini, ingatlah untuk memindahkan sumber peristiwa Azure (dalam contoh ini, akun Azure Storage) ke wilayah lain sebelum memindahkan topik sistem. Kemudian, dalam templat yang diekspor untuk topik sistem, perbarui ID eksternal untuk akun penyimpanan di wilayah target.
• Ubah templat untuk menambahkan endpointUrl properti untuk mengarah ke webhook yang berlangganan topik sistem. Ketika topik sistem diekspor, langganannya (dalam hal ini, itu adalah webhook) juga diekspor ke templat, tetapi properti endpointUrl tidak disertakan. Jadi, Anda perlu memperbaruinya untuk mengarah ke titik akhir yang berlangganan topik tersebut. Selain itu, perbarui nilai properti location ke lokasi atau wilayah baru. Untuk jenis handler peristiwa lainnya, Anda hanya perlu memperbarui lokasi.
• Gunakan templat untuk menyebarkan domain ke wilayah target. Anda akan menentukan nama untuk akun penyimpanan dan topik sistem yang akan dibuat di wilayah target.
• Verifikasi penyebaran. Verifikasi bahwa webhook dipanggil saat Anda mengunggah file ke penyimpanan blob di wilayah target.
• Untuk menyelesaikan pemindahan, hapus sumber daya (sumber peristiwa dan topik sistem) dari wilayah sumber.

Prasyarat

• Lihat Mulai Cepat: Merutekan peristiwa penyimpanan Blob ke titik akhir web dengan portal Microsoft Azure di wilayah sumber. Langkah ini bersifat opsional. Lakukan untuk menguji langkah-langkah dalam artikel ini. Simpan akun penyimpanan dalam grup sumber daya terpisah dari App Service dan paket App Service.
• Pastikan bahwa layanan Event Grid tersedia di wilayah target. Lihat Produk tersedia menurut wilayah.

Siapkan

Untuk memulai, ekspor templat Resource Manager untuk grup sumber daya yang berisi sumber peristiwa sistem (akun Azure Storage) dan topik sistem terkait.

1. Masuk ke portal Azure.

2. Pilih Grup Sumber Daya di menu sebelah kiri. Kemudian, pilih grup sumber daya yang berisi sumber peristiwa tempat topik sistem dibuat. Dalam contoh berikut, ini adalah akun Azure Storage. Grup sumber daya berisi akun penyimpanan dan topik sistem terkait.

   

3. Di menu sebelah kiri, pilih Ekspor templat di Pengaturan, lalu pilih Unduh pada toolbar.

   

4. Temukan file .zip yang telah Anda unduh dari portal, dan unzip file tersebut ke folder pilihan Anda. File zip ini berisi templat dan parameter file JSON.

5. Buka template.json di editor pilihan Anda.

6. URL untuk Webhook tidak diekspor ke templat. Jadi, lakukan langkah-langkah berikut:

   1. Dalam file templat, cari WebHook.

   2. Di bagian Properti, tambahkan karakter koma (,) di akhir baris terakhir. Contohnya, "preferredBatchSizeInKilobytes": 64.

   3. Tambahkan properti endpointUrl dengan nilai yang diatur ke URL Webhook Anda seperti yang ditunjukkan dalam contoh berikut.

      "destination": {
          "properties": {
              "maxEventsPerBatch": 1,
              "preferredBatchSizeInKilobytes": 64,
              "endpointUrl": "https://mysite.azurewebsites.net/api/updates"
          },
          "endpointType": "WebHook"
      }
      

      Catatan

      Untuk jenis handler peristiwa lainnya, semua properti diekspor ke templat. Anda hanya perlu memperbarui properti location ke wilayah target seperti yang ditunjukkan di langkah berikut ini.

7. Perbarui location untuk sumber daya akun penyimpanan ke wilayah atau lokasi target. Untuk mendapatkan kode lokasi, lihat lokasi Azure. Kode untuk suatu wilayah adalah nama kawasan tanpa spasi, misalnya, West US sama dengan westus.

   "type": "Microsoft.Storage/storageAccounts",
   "apiVersion": "2019-06-01",
   "name": "[parameters('storageAccounts_spegridstorage080420_name')]",
   "location": "westus",
   

8. Ulangi langkah untuk location memperbarui sumber daya topik sistem dalam templat.

   "type": "Microsoft.EventGrid/systemTopics",
   "apiVersion": "2020-04-01-preview",
   "name": "[parameters('systemTopics_spegridsystopic080420_name')]",
   "location": "westus",
   

9. Simpan templat.

Menyebarkan ulang

Terapkan templat untuk membuat akun penyimpanan dan topik sistem untuk akun penyimpanan di wilayah target.

1. Di portal Microsoft Azure, pilih Buat sumber daya.
2. Di Cari Marketplace Azure, ketikkan penyebaran templat, lalu tekan ENTER.
3. Pilih Penyebaran templat.
4. Pilih Buat.
5. Pilih Buat template Anda sendiri di editor.
6. Pilih Muat file, lalu ikuti petunjuk untuk memuat file template.json yang telah Anda unduh di bagian terakhir.
7. Pilih Simpan untuk menyimpan templat.
8. Pada halaman Penyebaran kustom, ikuti langkah-langkah berikut.

   1. Pilih langganan Azure.

   2. Pilih grup sumber daya yang ada di wilayah target atau buat grup sumber daya.

   3. Untuk Wilayah, pilih wilayah target. Jika Anda memilih grup sumber daya yang ada, pengaturan ini bersifat baca-saja.

   4. Untuk nama topik sistem, masukkan nama untuk topik sistem yang akan dikaitkan dengan akun penyimpanan.

   5. Untuk nama akun penyimpanan, masukkan nama untuk akun penyimpanan yang akan dibuat di wilayah target.

      

   6. Pilih Tinjau + buat di bagian bawah halaman.

   7. Pada halaman Tinjau + buat, tinjau pengaturan, dan pilih Buat.

Verifikasi

1. Setelah penyebaran berhasil, pilih Buka sumber daya grup.
2. Pada halaman Grup sumber daya, verifikasi bahwa sumber peristiwa (dalam contoh ini, akun Azure Storage) dan topik sistem dibuat.
3. Unggah file ke kontainer di penyimpanan Azure Blob, dan verifikasi bahwa webhook telah menerima peristiwa tersebut. Untuk informasi selengkapnya, lihat Mengirim peristiwa ke titik akhir Anda.

Membuang dan membersihkan

Untuk menyelesaikan pemindahan, hapus grup sumber daya yang berisi akun penyimpanan dan topik sistem terkait di wilayah sumber.

Jika Anda ingin memulai kembali, hapus grup sumber daya di wilayah target, dan ulangi langkah-langkah di bagian Persiapkan dan Buat Ulang di artikel ini.

Untuk menghapus grup sumber daya (sumber atau target) dengan menggunakan portal Microsoft Azure:

1. Di jendela pencarian di bagian atas portal Microsoft Azure, ketik Grup sumber daya, dan pilih Grup sumber daya dari hasil pencarian.

2. Pilih grup sumber daya yang akan dihapus, dan pilih Hapus dari toolbar.

   

3. Pada halaman konfirmasi, masukkan nama grup sumber daya, dan pilih Hapus.

Konten terkait

• Merelokasi topik kustom di seluruh wilayah.
• Merelokasi domain di seluruh wilayah.
• Memindahkan sumber daya ke grup sumber daya atau langganan baru.