Sebelum menggunakan SDK untuk mengirim dan menerima pesan, Anda harus membuat sumber daya di ApsaraMQ for RocketMQ, termasuk instance ApsaraMQ for RocketMQ, topik, dan grup konsumen. Anda juga perlu mendapatkan titik akhir dari instance tersebut. Informasi tentang sumber daya ini harus ditentukan dalam kode SDK saat digunakan.
Sebelum Anda memulai
Informasi latar belakang
ApsaraMQ for RocketMQ memungkinkan Anda membuat sumber daya melalui konsol ApsaraMQ for RocketMQ atau dengan memanggil operasi API. Topik ini menjelaskan cara membuat sumber daya melalui konsol.
Jika ingin membuat sumber daya menggunakan operasi API, lihat topik-topik berikut:
Batasan
Wilayah
Pastikan bahwa instance ApsaraMQ for RocketMQ berada di wilayah yang sama dengan VPC dan vSwitch yang dibuat pada bagian "Prasyarat".
Konvensi Penamaan
Untuk informasi tentang konvensi penamaan instance ApsaraMQ for RocketMQ, topik, dan grup konsumen, lihat Kuota dan Batasan.
Tipe Pesan Topik
Tipe pesan topik harus sesuai dengan tipe pesan yang dikirim dan diterima oleh topik tersebut. Sebagai contoh, jika Anda membuat topik untuk mengirim dan menerima pesan normal, topik tersebut hanya dapat digunakan untuk tujuan tersebut. Untuk informasi lebih lanjut, lihat Catatan Penggunaan.
Membuat instance
Masuk ke Konsol ApsaraMQ for RocketMQ. Di panel navigasi sebelah kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou).
Di halaman Instances, klik Create Instance. Di panel Create Message Queue for Apache RocketMQ Instance, atur parameter Instance Version menjadi V5.0 dan konfigurasikan parameter Billing Method. Lalu, klik OK.
ApsaraMQ for RocketMQ mendukung metode penagihan berikut:
Langganan: Pembayaran di muka diperlukan berdasarkan spesifikasi komputasi dan durasi langganan (dalam bulan) yang dipilih untuk instance.
Bayar sesuai pemakaian: Biaya dibayar setelah pemakaian berdasarkan spesifikasi komputasi yang dipilih untuk instance dan durasi penggunaan aktual (dalam jam).
Serverless: Anda akan dikenakan biaya berdasarkan jumlah total panggilan API yang dilakukan untuk menerima dan mengirimkan pesan.
Catatan
Untuk informasi tentang item yang dapat ditagih dan skenario dari berbagai metode penagihan, lihat Ikhtisar Penagihan.
Di halaman pembelian, pilih spesifikasi instance dan klik Buy Now. Ikuti petunjuk di layar untuk menyelesaikan pembayaran.
Tabel berikut memberikan contoh cara mengonfigurasi parameter di halaman pembelian. Untuk informasi tentang spesifikasi yang ditampilkan di halaman pembelian, lihat Pemilihan Instance.
Parameter yang dikonfigurasi untuk instance serverless
Parameter
Contoh
Primary Edition
Edisi Standar
Billing Method
Metode penagihan. Pay-by-Request secara otomatis ditentukan.
Message Storage Capacity
Ruang yang digunakan untuk menyimpan pesan. Anda tidak perlu menentukan kapasitas penyimpanan. Anda akan dikenakan biaya untuk ruang penyimpanan berdasarkan penggunaan aktual.
VPC ID
vpc-bp1cg09dua6sgh0******
Nilai parameter ini adalah ID VPC yang Anda buat di bagian "Sebelum Anda memulai" dari topik ini.
PentingSetelah Anda membuat instance ApsaraMQ for RocketMQ, Anda tidak dapat mengubah VPC tempat instance tersebut diterapkan. Jika Anda ingin mengubah VPC tempat instance ApsaraMQ for RocketMQ diterapkan, Anda harus melepaskan instance tersebut dan membeli instance baru.
VSwitch ID
vsw-bp1vqb0p9nz3irz******
Nilai parameter ini adalah ID vSwitch yang Anda buat di bagian "Sebelum Anda memulai" dari topik ini.
Anda harus memilih dua ID vSwitch untuk instance ApsaraMQ for RocketMQ serverless.
PentingSetelah Anda membuat instance ApsaraMQ for RocketMQ, Anda tidak dapat mengubah vSwitch yang terkait dengan instance tersebut. Jika Anda ingin mengubah vSwitch yang terkait dengan instance ApsaraMQ for RocketMQ, Anda harus melepaskan instance tersebut dan membeli instance baru.
Internet Access
Nonaktifkan
CatatanDalam contoh ini, klien terhubung ke broker ApsaraMQ for RocketMQ di VPC. Secara default, akses Internet dinonaktifkan. Jika Anda ingin mengakses ApsaraMQ for RocketMQ melalui Internet, atur parameter ini menjadi Enable.
Metode Pengukuran Jaringan Internal
Metode pengukuran lalu lintas jaringan internal. Pay-by-Traffic secara otomatis ditentukan.
Anda hanya dapat mengakses instance ApsaraMQ for RocketMQ serverless di VPC.
Resource Group
Grup sumber daya tempat instance ApsaraMQ for RocketMQ serverless milik. Dalam contoh ini, grup sumber daya default dipilih.
Security Group
Grup keamanan yang Anda buat di bagian "Sebelum Anda memulai" dari topik ini.
Parameter yang dikonfigurasi untuk instance langganan atau bayar sesuai pemakaian
Parameter
Contoh
Primary Edition
Edisi Standar
Sub-category Edition
Edisi Kluster Ketersediaan Tinggi (Direkomendasikan untuk Lingkungan Produksi)
Computing Specification
rmq.s2.2xlarge
VPC ID
vpc-bp1cg09dua6sgh0******
Nilai parameter ini adalah ID VPC yang Anda buat di bagian "Sebelum Anda memulai" dari topik ini.
PentingSetelah Anda membuat instance ApsaraMQ for RocketMQ, Anda tidak dapat mengubah VPC tempat instance tersebut diterapkan. Jika Anda ingin mengubah VPC tempat instance ApsaraMQ for RocketMQ diterapkan, Anda harus melepaskan instance tersebut dan membeli instance baru.
VSwitch ID
vsw-bp1vqb0p9nz3irz******
Nilai parameter ini adalah ID vSwitch yang Anda buat di bagian "Sebelum Anda memulai" dari topik ini.
PentingSetelah Anda membuat instance ApsaraMQ for RocketMQ, Anda tidak dapat mengubah vSwitch yang terkait dengan instance tersebut. Jika Anda ingin mengubah vSwitch yang terkait dengan instance ApsaraMQ for RocketMQ, Anda harus melepaskan instance tersebut dan membeli yang baru.
Internet Access
Nonaktifkan
CatatanDalam contoh ini, klien terhubung ke broker ApsaraMQ for RocketMQ di VPC. Secara default, akses Internet dinonaktifkan. Jika Anda ingin mengakses ApsaraMQ for RocketMQ melalui Internet, atur parameter ini menjadi Enable.
Resource Group
Grup sumber daya tempat instance ApsaraMQ for RocketMQ milik. Dalam contoh ini, grup sumber daya default dipilih.
Disk Encryption
Nonaktifkan
CatatanFitur enkripsi disk didukung hanya untuk instance ApsaraMQ for RocketMQ Edisi Platinum Perusahaan 5.x.
Disk Encryption Key
key-hzz66c8207****
CatatanID kunci yang digunakan untuk enkripsi disk di wilayah tempat instance diterapkan. Parameter ini diperlukan hanya jika Anda mengatur parameter Disk Encryption menjadi Enable.
Memperoleh titik akhir instance
Di halaman Instances, klik nama instance yang ingin Anda kelola.
Di bagian TCP Endpoint pada halaman Instance Details, lihat titik akhir instance.
Titik Akhir VPC: Digunakan untuk mengakses instance ApsaraMQ for RocketMQ di VPC. Ini adalah titik akhir default yang disediakan oleh ApsaraMQ for RocketMQ.
Titik Akhir Publik: Digunakan untuk mengakses ApsaraMQ for RocketMQ melalui Internet. Titik akhir publik hanya ditampilkan jika akses Internet diaktifkan.
Memperoleh nama pengguna dan kata sandi instance
Dalam contoh ini, otentikasi cerdas digunakan untuk menjelaskan cara memperoleh nama pengguna dan kata sandi instance ApsaraMQ for RocketMQ.
Jika ingin menggunakan otentikasi berbasis daftar kontrol akses (ACL), Anda harus membuat pengguna ACL, memberikan izin yang diperlukan kepada pengguna ACL, dan memperoleh nama pengguna serta kata sandi pengguna ACL. Untuk informasi lebih lanjut, lihat Otentikasi Pengguna.
Saat menghubungkan klien ke broker ApsaraMQ for RocketMQ, apakah akan menentukan nama pengguna dan kata sandi instance ditentukan oleh metode akses.
Jika mengakses broker ApsaraMQ for RocketMQ melalui Internet, Anda harus menentukan nama pengguna dan kata sandi instance.
Jika mengakses broker ApsaraMQ for RocketMQ di VPC, Anda hanya perlu menentukan nama pengguna dan kata sandi jika instance tersebut adalah instance serverless dan fitur otentikasi bebas di VPC dinonaktifkan untuk instance tersebut. Dalam kasus lain, sistem secara otomatis mengidentifikasi klien berdasarkan titik akhir VPC yang digunakan klien.
Di halaman Instances, klik nama instance yang ingin Anda kelola.
Di panel navigasi sebelah kiri halaman yang muncul, klik Access Control.
Klik tab Intelligent Authentication untuk melihat nama pengguna dan kata sandi instance.
Membuat topik
Di halaman Instances, klik nama instance yang ingin Anda kelola.
Di panel navigasi sebelah kiri, klik Topics. Pada halaman Topics yang terbuka, klik Create Topic.
Di panel Create Topic, masukkan nama topik dan deskripsi, atur parameter Message Type menjadi Normal Message, lalu klik OK.
Membuat grup konsumen
Di halaman Instances, klik nama instance yang ingin Anda kelola.
Di panel navigasi sebelah kiri, klik Groups. Di halaman Groups yang muncul, klik Create Group.
Di panel Create Group, konfigurasikan parameter Group ID dan klik OK. Anda dapat menggunakan nilai default untuk parameter lainnya di panel.