Migrate open source RabbitMQ metadata to the cloud - ApsaraMQ for RabbitMQ: Central de Documentação do Alibaba Cloud

Migre metadados para a nuvem exportando-os do seu cluster RabbitMQ open source e importando-os em uma instância do ApsaraMQ for RabbitMQ. Após a importação bem-sucedida, o ApsaraMQ for RabbitMQ utiliza os metadados para criar os vhosts, filas, exchanges e bindings correspondentes na instância de destino do ApsaraMQ for RabbitMQ. Exporte metadados de todos os vhosts ou de um vhost específico do seu cluster RabbitMQ open source.

Pré-requisitos

Ative o plug-in de gerenciamento do RabbitMQ.
Crie uma instância do ApsaraMQ for RabbitMQ e um vhost para usar como destino da migração. Para mais informações, consulte Criar uma instância e Criar um vhost.

Nota
Recomendamos selecionar uma instância Serverless dedicada. Esse tipo de instância oferece suporte à autenticação e às permissões do open source, permitindo uma migração fluida a partir do RabbitMQ open source.

Informações gerais

Os metadados de um cluster RabbitMQ incluem informações como usuários, vhosts, filas, exchanges, routing keys, permissões e parâmetros. Esses metadados são armazenados no banco de dados interno do cluster RabbitMQ e replicados automaticamente em todos os nós. Os metadados em cada nó do cluster são idênticos.

Limitações

As limitações variam conforme o modelo de autenticação e gerenciamento de permissões da instância. Recomendamos utilizar uma instância com o modelo de autenticação e permissões do open source para a migração.

Autenticação e gerenciamento de permissões do open source
- Devido a certas diferenças entre o RabbitMQ open source e o ApsaraMQ for RabbitMQ, os metadados rabbit_version, parameters, global_parameters e policies não têm suporte para importação em instâncias do ApsaraMQ for RabbitMQ e são ignorados automaticamente durante o processo.
- A importação do usuário guest não tem suporte. Caso os metadados contenham o usuário guest, ele e suas permissões serão ignorados durante a importação.
- Usuários sem senha podem ser importados, mas não conseguirão estabelecer uma conexão.
- Como o ApsaraMQ for RabbitMQ não oferece suporte ao gerenciamento de permissões por tags de usuário, o atributo tags presente nos dados de users não será importado.
Resource Access Management (RAM)

Devido às diferenças no gerenciamento de permissões entre o RabbitMQ open source e o Resource Access Management (RAM) da Alibaba Cloud, os metadados rabbit_version, users, permissions, parameters, global_parameters e policies não podem ser importados em uma instância do ApsaraMQ for RabbitMQ e são ignorados automaticamente durante a importação.

Exportar metadados do RabbitMQ open source

Exporte metadados de todos os vhosts ou de um vhost específico.

Open source console

Em um navegador web, abra o console RabbitMQ open source.

URL do console RabbitMQ open source: http://<Your RabbitMQ IP address>:15672/
Na página de login, insira seu nome de usuário no campo Username e sua senha no campo Password, e clique em Login.
Na aba Overview, clique em Export definitions. Na lista suspensa Virtual host, selecione All ou o nome de um vhost específico e clique em Download broker definitions.
As seguintes opções estão disponíveis na lista Virtual host:
- All: exporta os metadados de todos os vhosts.
- Vhost name: exporta os metadados do vhost especificado.
Salve o arquivo de metadados baixado no seu computador local.

Open source API

Abra o terminal.

Execute o comando adequado para exportar o arquivo de metadados.

Exportar metadados de todos os vhosts

wget --user <Your RabbitMQ username> --password <Your RabbitMQ password> http://<Your RabbitMQ IP address>:15672/api/definitions -O <Path to save your metadata file>

Exportar metadados de um vhost específico

wget --user <Your RabbitMQ username> --password <Your RabbitMQ password> http://<Your RabbitMQ IP address>:15672/api/definitions -O <Path to save your metadata file> --vhost <Vhost name>

Importar metadados no ApsaraMQ for RabbitMQ

Acesse o console do ApsaraMQ for RabbitMQ. No painel de navegação à esquerda, clique em Migration to Cloud.
Na página Migration to Cloud, selecione uma região na barra de navegação superior. Em seguida, no canto superior esquerdo da página, clique em Create Task.

No painel Create Task, configure os parâmetros e clique em OK.

Parameter	Description	Example
Instance	A instância de destino para a migração de metadados.	amqp-cn-7mz2cjgk****
Import Method	ALL: importa todos os metadados de vhost do RabbitMQ open source para uma instância do ApsaraMQ for RabbitMQ. Vhost: importa os metadados de um vhost específico do RabbitMQ open source para um vhost da instância do ApsaraMQ for RabbitMQ.	Vhost
vhost	O vhost de destino na instância do ApsaraMQ for RabbitMQ. Este parâmetro aparece somente quando você defina Import Method como Vhost.	test-vhost****
Metadata	O arquivo de metadados a ser importado. Clique em Select File, escolha o arquivo de metadados no seu computador local e clique em Open. Nota O arquivo de metadados não pode ultrapassar 20 MB.	rabbit_mq-amqp-load-test011122063****

Após crie uma tarefa de migração, visualize os detalhes dos metadados importados e as causas de eventuais falhas.

Visualizar os metadados importados
1. Na página Migration to Cloud, localize a tarefa desejada e clique no nome da instância na coluna Destination Instance.
2. No painel de navegação à esquerda, clique em Vhosts. Localize o vhost desejado e clique em Details na coluna Actions para ver as informações detalhadas do vhost.
  
  Para mais informações, consulte Visualizar detalhes de conexão do vhost.
Visualizar os detalhes de uma tarefa com falha
1. Na página Migration to Cloud, localize a tarefa desejada e clique em Details na coluna Actions.
  
  Como alternativa, na página Migration to Cloud, clique na contagem de metadados sincronizados da tarefa desejada.
2. Na página Migration Details, clique na aba Vhost, Exchange, Queue ou Binding para ver o motivo da falha.