RabbitMQ 管理プラグインによる接続
IBM Cloud® Messages for RabbitMQ デプロイメントは、デフォルトで RabbitMQ 管理プラグインが有効になっています。このプラグインによって、Web ブラウザー、API、またはコマンド・ラインから RabbitMQ にアクセスできるようになります。
RabbitMQ 管理 UI
デプロイメントの _「ダッシュボードの概要」_の 「接続」 から、 RabbitMQ 管理 UI を開きます。
URL 接続情報は、接続ストリングの「https」セクションにもあります。 RabbitMQ デプロイメントの Web アドレスは、接続ストリングの「composed」フィールドにあります。
Messages for RabbitMQ デプロイメントは自己署名証明書によって署名されているため、初めてページを開く際にセキュリティー警告が表示される場合があります。 指定された自己署名証明書を信頼するようにシステムを構成することができます。 この方法については、ご使用のブラウザーまたはご使用のシステムの資料を参照してください。
次に、ユーザー名とパスワードを入力するように求められます。 サインインすると、RabbitMQ デプロイメントの_概要_が表示されます。
デプロイメント上の任意のユーザーを使用して、UI にアクセスします。 一部の機能は、デプロイメントでプロビジョンされた admin ユーザーのみが使用できます。
詳しくは、 RabbitMQ 管理プラグイン のページを参照してください。
プライベート・エンドポイント経由の接続
Messages for RabbitMQ は、プライベートとパブリックの両方のクラウド・サービス・エンドポイントを提供します。 プライベート・ネットワーク上にないブラウザーから管理 UI にアクセスする場合は、IBM Cloud® データベースのプライベート・エンドポイントを介した接続の資料に記載されている追加の手順を実行する必要があります。
ご使用の環境をプライベート・エンドポイント・アクセス用に構成したら、ブラウザーから Messages for RabbitMQ 管理エンドポイント URL に移動できます。 例: https://bfdb-4263-8ad2-c9a4beaf4591.8f7bfc8f3faa4218afd56e0.databases.appdomain.cloud:323232
RabbitMQ 管理 HTTP API
管理プラグインは、RabbitMQ デプロイメント用の API も提供します。 基本エンドポイントは、ブラウザーの URL と同じ HTTP URL で、/api が付きます。 以下に例を示します。
https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/api/
API は application/json データを使用し、基本認証を必要とします。 デプロイメントで作成したどのユーザーでも UI にアクセスできます。 ただし、一部の機能は管理者ユーザーのみが使用できる場合があります。
資料や例がデプロイメントに含まれており、ブラウザー URL に /api/index.html を付けてアクセスできます。 以下に例を示します。
https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/api/index.html
rabbitmqadmin のインストール
rabbitmqadmin バイナリーは、ご使用のデプロイメントから直接使用できます。 ダウンロードおよびインストールの説明は、管理プラグインの /cli ページに記載されています。 以下に例を示します。
https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/cli
rabbitmqadmin は、RabbitMQ パッケージのローカルのフル・インストールでも使用できます。 ただし、ダウンロードしたパッケージのバージョンが、デプロイメントの RabbitMQ バージョンと一致しない場合は、接続できない場合があります。
rabbitmqadmin による接続
rabbitmqadmin 接続情報は、接続ストリングの「cli」セクションにあります。 参照用に、接続文字列の構成要素を次の表に示します。
| フィールド名 | 索引 | 説明 |
|---|---|---|
Bin |
接続を作成するための推奨バイナリー。この場合は rabbitmqadmin になります。 |
|
Composed |
デプロイメントへの接続を確立するための構成済みのコマンド。 このコマンドは、 Bin 実行可能ファイル、 Environment 変数設定を結合し、 Arguments を使用します。 |
|
Environment |
環境変数として設定したキーまたは値のリスト。 | |
Arguments |
0... | Bin フィールドに示されているコマンドに引数として渡される情報 |
Certificate |
Base64 | アプリケーションが適切なサーバーに接続することを確認するために使用する自己署名証明書。 base64 でエンコードされています。 |
Certificate |
名前 | 自己署名証明書に割り当てられた名前。 |
Type |
この接続情報を使用するパッケージのタイプ。この場合は cli です。 |
0...は、1 つの配列にこれらのエントリーが 1 つ以上ある可能性があることを示しています。
このサンプル・コマンドは、RabbitMQ 内のすべての交換をリストします。
rabbitmqadmin --username=admin --password=$PASSWORD --ssl --ssl-ca-cert-file=0b22f14b-7ba2-11e8-b8e9-568642342d40 --host=1a619c43-6415-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud --port=31797 list exchanges
rabbitmqadmin- コマンド本体です。--usernameおよび--password- 接続に使用するユーザーの認証情報。--ssl- 接続が TLS/SSL で保護されるようにします。--ssl-ca-cert-file=- 証明書のローカル・コピーへのパス。--host=-rabbitmqadminコマンドが接続するエンドポイントを指定するパラメーター。--port=- RabbitMQ サーバーが listen するポートを指定するパラメーター。list exchanges- RabbitMQ デプロイメントのデータベース・メンバーをリストするrabbitmqadminコマンド。
rabbitmqadmin の資料およびその他の例は、 RabbitMQ 管理コマンド・ライン・ツール のページにあります。
自己署名証明書の使用
- 接続情報の Base64 フィールドから証明書情報をコピーします。
- Base64 ストリングをテキストにデコードして、ファイルに保存します (提供される名前、または独自のファイル名を使用できます)。
--ssl-ca-cert-fileパラメーターへのパスを指定します。
デプロイメントのデコードされた証明書を、CLI プラグインを使用してコマンド ibmcloud cdb deployment-cacert "your-service-name" で表示することもできます。 これにより、base64 がテキストにデコードされます。 コマンドの出力をファイルにコピーして保存し、このファイルのパスを --ssl-ca-cert-file パラメーターに指定します。