All Products
Search
Document Center

ApsaraMQ for RabbitMQ:Migrating metadata

Last Updated:Jun 21, 2026

Anda dapat memigrasikan metadata ke cloud dengan mengekspornya dari kluster RabbitMQ open source dan mengimpornya ke instans ApsaraMQ for RabbitMQ. Setelah impor berhasil, ApsaraMQ for RabbitMQ menggunakan metadata tersebut untuk membuat vhost, antrian (queue), exchange, dan binding yang sesuai di instans ApsaraMQ for RabbitMQ tujuan. Anda dapat mengekspor metadata untuk semua vhost atau hanya untuk vhost tertentu dari kluster RabbitMQ open source.

Prasyarat

  • Aktifkan plug-in management RabbitMQ.

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

    Catatan

    Kami merekomendasikan memilih instans khusus Serverless. Tipe instans ini mendukung autentikasi dan izin versi open source, sehingga memungkinkan migrasi yang mulus dari RabbitMQ open source.

Latar Belakang

Metadata kluster RabbitMQ mencakup informasi seperti pengguna (user), vhost, antrian (queue), exchange, routing key, izin (permission), dan parameter. Metadata ini disimpan di database internal kluster RabbitMQ dan direplikasi secara otomatis ke semua node. Metadata pada setiap node dalam kluster identik.

Batasan

Batasan yang berlaku berbeda-beda tergantung pada model autentikasi dan pengelolaan izin instans. Kami merekomendasikan menggunakan instans dengan model autentikasi dan pengelolaan izin open source untuk migrasi Anda.

  • Pengelolaan autentikasi dan izin open source

    • Karena adanya perbedaan tertentu antara RabbitMQ open source dan ApsaraMQ for RabbitMQ, metadata rabbit_version, parameters, global_parameters, dan policies tidak didukung untuk diimpor ke instans ApsaraMQ for RabbitMQ dan secara otomatis diabaikan selama proses impor.

    • Mengimpor pengguna guest tidak didukung. Jika metadata berisi pengguna guest, pengguna tersebut beserta izinnya akan diabaikan selama impor.

    • Anda dapat mengimpor pengguna tanpa kata sandi, tetapi mereka tidak dapat membuat koneksi.

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

  • Resource Access Management (RAM)

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

Ekspor metadata dari RabbitMQ open source

Anda dapat mengekspor metadata untuk semua vhost atau hanya untuk vhost tertentu.

Konsol open source

  1. Buka konsol RabbitMQ open source di browser web.

    URL konsol RabbitMQ open source: http://<Alamat IP RabbitMQ Anda>:15672/

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

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

    Opsi berikut tersedia dalam daftar Virtual host:

    • All: Mengekspor metadata untuk semua vhost.

    • Vhost name: Mengekspor metadata untuk vhost yang ditentukan.

  4. Simpan file metadata yang diunduh ke komputer lokal Anda.

API open source

  1. Buka terminal Anda.

  2. Jalankan perintah yang sesuai untuk mengekspor file metadata.

    • Ekspor metadata untuk semua vhost

      wget --user <Username RabbitMQ Anda> --password <Password RabbitMQ Anda> http://<Alamat IP RabbitMQ Anda>:15672/api/definitions -O <Path untuk menyimpan file metadata Anda>
    • Ekspor metadata untuk vhost tertentu

      wget --user <Username RabbitMQ Anda> --password <Password RabbitMQ Anda> http://<Alamat IP RabbitMQ Anda>:15672/api/definitions -O <Path untuk menyimpan file metadata Anda> --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. Lalu, di pojok kiri atas halaman, klik Create Task.

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

    Parameter

    Deskripsi

    Contoh

    Instance

    Instans tujuan untuk migrasi metadata.

    amqp-cn-7mz2cjgk****

    Import Method

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

    • Vhost: Mengimpor metadata dari vhost tertentu RabbitMQ open source ke vhost pada instans ApsaraMQ for RabbitMQ.

    Vhost

    vhost

    vhost tujuan dalam instans ApsaraMQ for RabbitMQ. Parameter ini hanya muncul jika Anda mengatur Import Method ke Vhost.

    test-vhost****

    Metadata

    File metadata yang akan diimpor. Klik Select File, pilih file metadata dari komputer lokal Anda, lalu klik Open.

    Catatan

    Ukuran file metadata tidak boleh melebihi 20 MB.

    rabbit_mq-amqp-load-test011122063****

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

    • Lihat metadata yang diimpor

      1. Pada halaman Migration to Cloud, temukan tugas yang dituju dan klik nama instans pada kolom Destination Instance.

      2. Di panel navigasi sebelah kiri, klik Vhosts. Temukan vhost yang dituju dan klik Details pada kolom Actions untuk melihat informasi detail tentang vhost tersebut.

        Untuk informasi selengkapnya, lihat Lihat detail koneksi vhost.

    • Lihat detail tugas yang gagal

      1. Pada halaman Migration to Cloud, temukan tugas yang dituju dan klik Details pada kolom Actions.

        Atau, pada halaman Migration to Cloud, Anda juga dapat mengklik jumlah metadata yang telah disinkronkan untuk tugas tersebut.

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