すべてのプロダクト
Search

このプロダクト

    :オープンソース RabbitMQ クラスターのメタデータを Alibaba Cloud に移行する

    ドキュメントセンター

    :オープンソース RabbitMQ クラスターのメタデータを Alibaba Cloud に移行する

    最終更新日:Mar 14, 2025

    このトピックでは、オープンソース RabbitMQ クラスターのメタデータを ApsaraMQ for RabbitMQ インスタンスまたは ApsaraMQ for RabbitMQ インスタンス上の vhost に移行する方法について説明します。

    前提条件

    • 移行するメタデータがエクスポートされていること。詳細については、「すべての vhost または特定の vhost のメタデータをエクスポートする」をご参照ください。

    • ApsaraMQ for RabbitMQ インスタンスと、メタデータの移行先となる vhost が作成されていること。

      • オープンソース RabbitMQ クラスター内のすべての vhost のメタデータを移行するには、ApsaraMQ for RabbitMQ インスタンスを作成します。詳細については、「インスタンスの管理」をご参照ください。

      • オープンソース RabbitMQ クラスター内の特定の vhost のメタデータを移行するには、ApsaraMQ for RabbitMQ インスタンスと、そのインスタンス内に vhost を作成します。詳細については、「インスタンスの作成」および「vhost の作成」をご参照ください。

    背景情報

    オープンソース RabbitMQ クラスターのメタデータには、クラスターのユーザー、vhost、キュー、exchange、バインディングキー、権限、およびパラメーターに関する情報が含まれます。オープンソース RabbitMQ クラスターのメタデータは、クラスターの内部データベースに保存され、クラスターのすべてのノード間で自動的に複製されます。

    各ノードにはメタデータのレプリカがあります。1 つのノードのメタデータが変更されると、すべてのノードのメタデータが更新されます。このようにして、クラスターの各ノードからエクスポートされたメタデータファイルは同じになります。

    オープンソース RabbitMQ クラスターのメタデータをバックアップするには、メタデータを JSON ファイルにエクスポートし、そのファイルを別のオープンソース RabbitMQ クラスターにインポートします。

    クラウドへのメタデータの移行とは、オープンソース RabbitMQ クラスターのメタデータを ApsaraMQ for RabbitMQ インスタンスに移行するプロセスです。ApsaraMQ for RabbitMQ は、Alibaba Cloud が提供するフルマネージドメッセージキューサービスです。このサービスは、オープンソース RabbitMQ と互換性があります。オープンソース RabbitMQ クラスターのメタデータをエクスポートし、ApsaraMQ for RabbitMQ インスタンスにインポートできます。その後、ApsaraMQ for RabbitMQ は、インポートされたメタデータに基づいて、ApsaraMQ for RabbitMQ インスタンスに対応する vhost、キュー、exchange、およびバインディングを作成します。

    オープンソース RabbitMQ クラスター内のすべての vhost のメタデータを ApsaraMQ for RabbitMQ インスタンスにインポートすることも、オープンソース RabbitMQ クラスター内の特定の vhost のメタデータを ApsaraMQ for RabbitMQ インスタンス内の vhost にインポートすることもできます。

    使用上の注意

    • オープンソース RabbitMQ クラスター上のすべての vhost のメタデータをインポートする場合は、インポートする JSON 形式のメタデータファイルに、vhost データと、exchange、queue、binding データ（vhost 情報が含まれる）が含まれていることを確認してください。詳細については、「A+sample+JSON+file.json」をご参照ください。

    • インポートされたメタデータファイル内の vhost、exchange、キュー、およびバインディングのデータは、ApsaraMQ for RabbitMQ のリソースクォータの制限と、リソースの命名に使用できる文字の制限に準拠している必要があります。詳細については、「制限」をご参照ください。

    • ApsaraMQ for RabbitMQ インスタンスは、一度に 1 つのタスクしか実行できません。前のタスクが完了したら、インスタンスの新しいタスクを作成できます。

    メタデータの互換性

    オープンソース RabbitMQ と ApsaraMQ for RabbitMQ のアクセス制御メカニズムなどの違いにより、オープンソース RabbitMQ クラスターの特定のメタデータを ApsaraMQ for RabbitMQ インスタンスにインポートすることはできません。インポートできないメタデータは、オープンソース RabbitMQ クラスターのメタデータを ApsaraMQ for RabbitMQ インスタンスにインポートするときに自動的に無視されます。次の表に、オープンソース RabbitMQ クラスターと ApsaraMQ for RabbitMQ インスタンス間のメタデータの互換性を示します。

    メタデータ

    説明

    互換性

    rabbit_version

    オープンソース RabbitMQ クラスターのバージョン。

    いいえ

    users

    オープンソース RabbitMQ クラスターのユーザー。

    いいえ

    重要

    RabbitMQ クラスターのメタデータファイルにユーザーのデータが含まれている場合は、クラスターのメタデータを ApsaraMQ for RabbitMQ インスタンスに移行した後、Resource Access Management ( RAM ) を使用して対応するユーザー管理メカニズムを実装できます。詳細については、「RAM ユーザーの作成」をご参照ください。

    vhosts

    オープンソース RabbitMQ クラスター内の vhost。

    はい

    permissions

    オープンソース RabbitMQ クラスター内の vhost を管理するためにユーザーに付与される権限。

    いいえ

    重要

    RabbitMQ クラスターのユーザーに vhost を管理する権限が付与されている場合は、クラスターのメタデータを ApsaraMQ for RabbitMQ インスタンスに移行した後、RAM を使用して vhost を管理するために必要な権限をユーザーに付与できます。詳細については、「RAM ポリシー」をご参照ください。

    parameters

    オープンソース RabbitMQ クラスターの実行時パラメーター。

    いいえ

    global_parameters

    オープンソース RabbitMQ クラスターのグローバル実行時パラメーター。

    いいえ

    policies

    オープンソース RabbitMQ クラスターの vhost 実行時パラメーター。パラメーターには、vhost 内の exchange とキューに使用できるオプションパラメーターが含まれます。

    いいえ

    重要

    RabbitMQ クラスターが vhost 実行時パラメーターに基づいて構成されている場合は、ApsaraMQ for RabbitMQ コンソールで exchange とキューを作成するときに、対応するオプションパラメーターを指定できます。exchange またはキューを作成した後、オプションパラメーターを変更することはできません。exchange またはキューのオプションパラメーターを変更するには、exchange またはキューを削除し、別の exchange またはキューを作成する必要があります。詳細については、「exchange の作成」および「キューの作成」をご参照ください。

    queues

    オープンソース RabbitMQ クラスターのキュー。

    はい

    exchanges

    オープンソース RabbitMQ クラスターの exchange。

    はい

    bindings

    オープンソース RabbitMQ クラスターの exchange とキュー間のバインディング。

    はい

    メタデータの移行

    1. ApsaraMQ for RabbitMQ コンソール にログインします。左側のナビゲーションペインで、クラウドへの移行 をクリックします。

    2. クラウドへの移行 ページで、上部のナビゲーションバーでリージョンを選択し、左上隅にある タスクの作成 をクリックします。

    3. タスクの作成 パネルで、パラメーターを構成し、[OK] をクリックします。

      パラメーター

      説明

      例

      インスタンス

      メタデータの移行先となるインスタンスの名前。

      amqp-cn-7mz2cjgk****

      インポートモード

      オープンソース RabbitMQ クラスター内のすべての vhost のメタデータを ApsaraMQ for RabbitMQ インスタンスにインポートするか、オープンソース RabbitMQ クラスター内の特定の vhost のメタデータを ApsaraMQ for RabbitMQ インスタンス内の vhost にインポートするかを指定します。有効な値：

      • すべて: オープンソース RabbitMQ クラスター内のすべての vhost のメタデータを ApsaraMQ for RabbitMQ インスタンスにインポートします。

      • vhost: オープンソース RabbitMQ クラスター内の特定の vhost のメタデータを ApsaraMQ for RabbitMQ インスタンス内の vhost にインポートします。

      vhost

      vhost

      メタデータの移行先となる vhost。 このパラメーターは、インポートモード パラメーターが vhost に設定されている場合にのみ使用できます。

      test-vhost****

      メタデータ

      移行するメタデータファイル。メタデータファイルを移行するには、ファイルの選択 をクリックし、オンプレミスデバイスに保存されているメタデータファイルを選択して、[開く] をクリックします。

      説明

      メタデータファイルのサイズは 20 MB を超えることはできません。

      rabbit_mq-amqp-load-test011122063****

      クラウドへの移行 ページに、作成された移行タスクが表示され、タスクステータスを確認できます。

      インポートされたメタデータと、タスクが失敗した原因を確認する方法については、「関連操作」をご参照ください。

    関連操作

    メタデータを移行するタスクを作成した後、インポートされたメタデータの詳細を表示できます。タスクが失敗した場合は、失敗の原因を表示できます。

    • インポートされたメタデータを表示する

      1. クラウドへの移行 ページで、管理する移行タスクを見つけ、ターゲットインスタンス 列のインスタンス名をクリックします。

      2. 左側のナビゲーションペインで、vHost リスト をクリックします。 vhost ページで、メタデータを移行した vhost を見つけ、操作 列の 詳細 をクリックして、vhost の詳細を表示します。

        詳細については、「vhost に確立された接続に関する情報を表示する」をご参照ください。

    • タスクが失敗した原因を表示する

      1. クラウドへの移行 ページで、管理する移行タスクを見つけ、操作 列の 詳細 をクリックします。

        次の操作を実行することもできます。クラウドへの移行 ページで、管理する移行タスクを見つけ、[同期対象の vhost]、[同期対象の exchange]、[同期対象のキュー]、または [同期対象のバインディング] 列の値をクリックします。

      2. 移行詳細 ページで、[失敗した vhost]、[失敗した exchange]、[失敗したキュー]、および [失敗したバインディング] タブをクリックして、失敗の原因を表示します。