All Products
Search
Document Center

ApsaraMQ for RabbitMQ:Migrasikan metadata ke cloud

Last Updated:Nov 10, 2025

Migrasikan metadata dari kluster RabbitMQ open source ke instans ApsaraMQ for RabbitMQ Alibaba Cloud dengan mengekspor lalu mengimpornya. Setelah impor berhasil, ApsaraMQ for RabbitMQ membuat vhost, antrian, exchange, dan binding yang sesuai di instans tujuan ApsaraMQ for RabbitMQ. RabbitMQ open source mendukung ekspor metadata untuk semua vhost atau untuk vhost tertentu.

Prasyarat

  • Aktifkan plug-in manajemen RabbitMQ.

  • Buat instans ApsaraMQ for RabbitMQ dan vhost sebagai tujuan migrasi. Untuk informasi selengkapnya, lihat Buat instans dan Buat vhost.

    Catatan

    Pilih instans tipe Serverless. Tipe instans ini mendukung model verifikasi identitas dan izin open source, sehingga memungkinkan migrasi mulus dari RabbitMQ open source ke cloud.

Informasi latar belakang

Metadata kluster RabbitMQ mencakup informasi seperti pengguna, vhost, antrian, exchange, kunci routing, izin, dan parameter. Metadata ini disimpan dalam database internal kluster dan direplikasi secara otomatis ke semua node. Oleh karena itu, semua node dalam kluster memiliki metadata yang sama.

Batasan

Batasan bervariasi tergantung pada model verifikasi identitas dan pengelolaan izin instans. Untuk migrasi yang berhasil, pilih instans yang menggunakan model verifikasi identitas dan pengelolaan izin open source.

  • Verifikasi identitas dan pengelolaan izin open source

    • Karena ketidakcocokan antara RabbitMQ open source dan ApsaraMQ for RabbitMQ, metadata rabbit_version, parameters, global_parameters, atau policies secara otomatis diabaikan selama impor dan tidak dapat diimpor ke instans ApsaraMQ for RabbitMQ.

    • Pengguna guest tidak dapat diimpor. Jika Anda mencoba mengimpor pengguna guest, pengguna tersebut beserta izinnya tidak akan dibuat.

    • Pengguna tanpa kata sandi dapat diimpor, tetapi mereka tidak dapat terhubung ke atau mengakses instans tersebut.

    • Karena ApsaraMQ for RabbitMQ tidak mendukung pengelolaan izin berdasarkan tag pengguna, properti tags dalam data users tidak diimpor.

  • Resource Access Management (RAM)

    Karena pengelolaan izin RabbitMQ open source berbeda dengan Resource Access Management (RAM), metadata rabbit_version, users, permissions, parameters, global_parameters, dan policies secara otomatis diabaikan selama proses impor dan tidak dapat diimpor ke instans ApsaraMQ for RabbitMQ.

Ekspor metadata RabbitMQ open source

Anda dapat mengekspor metadata semua vhost atau vhost tertentu dari kluster RabbitMQ open source.

Ekspor dari konsol RabbitMQ open source

  1. Buka konsol RabbitMQ open source di browser.

    URL konsol RabbitMQ open source adalah: http://<alamat_ip_rabbitmq_anda>:15672/

  2. Pada halaman login, masukkan nama pengguna Anda di kotak teks Username dan kata sandi Anda di kotak teks Password, lalu klik Login.

  3. Pada tab Overview, klik Export definitions. Dari daftar Virtual host, pilih All atau nama vhost tertentu, lalu klik Download broker definitions.

    Tabel berikut menjelaskan opsi dalam daftar Virtual host.

    • All: Mengekspor metadata untuk semua vhost.

    • Vhost name: Mengekspor metadata untuk vhost tertentu.

    image

  4. Simpan file metadata yang diunduh ke komputer Anda.

Ekspor menggunakan API HTTP RabbitMQ open source

  1. Buka terminal.

  2. Jalankan perintah berikut untuk mengekspor file metadata kluster RabbitMQ.

    • Untuk mengekspor metadata semua vhost:

      wget --user <nama_pengguna_rabbitmq_anda> --password <kata_sandi_rabbitmq_anda> http://<alamat_ip_rabbitmq_anda>:15672/api/definitions -O <jalur/untuk/menyimpan/file_metadata>
    • Untuk mengekspor metadata vhost tertentu:

      wget --user <nama_pengguna_rabbitmq_anda> --password <kata_sandi_rabbitmq_anda> http://<alamat_ip_rabbitmq_anda>:15672/api/definitions -O <path/to/save/metadata_file> --vhost <nama_vhost>

Impor metadata ke ApsaraMQ for RabbitMQ

  1. Login ke ApsaraMQ for RabbitMQ console. Di panel navigasi sebelah kiri, klik Migration to Cloud.

  2. Pada halaman Migration to Cloud, pilih wilayah di bilah navigasi atas dan klik Create Task di pojok kiri atas.

  3. Pada panel Create Task, atur parameter dan klik OK.

    Parameter

    Deskripsi

    Contoh

    Instance

    Nama instans tujuan tempat metadata akan dimigrasikan.

    amqp-cn-7mz2cjgk****

    Import Method

    • ALL: mengimpor metadata semua vhost dari kluster RabbitMQ open source ke instans ApsaraMQ for RabbitMQ.

    • Vhost: mengimpor metadata vhost tertentu dari kluster RabbitMQ open source ke vhost instans ApsaraMQ for RabbitMQ.

    Vhost

    vhost

    vhost dalam instans ApsaraMQ for RabbitMQ tempat Anda ingin memigrasikan metadata. Parameter ini ditampilkan saat Anda mengatur Import Method ke Vhost.

    test-vhost****

    Metadata

    File metadata yang akan dimigrasikan. Klik Select File, pilih file metadata lokal, lalu klik Open.

    Catatan

    Ukuran file metadata tidak boleh melebihi 20 MB.

    rabbit_mq-amqp-load-test011122063****

    Setelah membuat tugas migrasi metadata, Anda dapat melihat detail metadata serta penyebab kegagalan tugas (jika ada).

    • Lihat detail metadata yang berhasil diimpor

      1. Pada halaman Migration to Cloud, temukan tugas tersebut dan klik nama instansnya di kolom Destination Instance.

      2. Di panel navigasi sebelah kiri, klik Vhosts. Temukan vhost tujuan dan klik Details di kolom Actions.

        Untuk informasi selengkapnya, lihat Lihat detail koneksi vhost.

    • Lihat detail tugas yang gagal

      1. Pada halaman Migration to Cloud, temukan tugas tersebut, lalu di kolom Actions, klik Details.

        Atau, pada halaman Migration to Cloud, temukan instans tujuan dan klik jumlah metadata yang telah disinkronkan.

      2. Pada halaman Migration Details, klik tab Vhost, Exchange, Queue, atau Binding untuk melihat penyebab kegagalan.