IBM Cloud Docs
RabbitMQ 관리 플러그인에 연결

RabbitMQ 관리 플러그인에 연결

IBM Cloud® Messages for RabbitMQ 배치에는 웹 브라우저, API 또는 명령행에서 RabbitMQ에 액세스할 수 있도록 하는 RabbitMQ 관리 플러그인이 기본적으로 사용으로 설정되어 있습니다.

RabbitMQ 관리 UI

배치의 _대시보드 개요_에 있는 연결 에서 RabbitMQ 관리 UI를 여십시오.

열린 RabbitMQ 관리 UI
그림 1. RabbitMQ 관리 UI
를 열기 위한 링크

URL 연결 정보는 연결 문자열의 "https" 섹션에도 있습니다. RabbitMQ 배치의 웹 주소는 연결 문자열의 "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도 제공합니다. 기본 엔드포인트는 /api를 포함하는 브라우저 URL와 동일한 HTTP URL입니다. 예를 들어, 다음과 같습니다. https://1a619c43-6425-4abb-8df0-0c7b1b3a3001.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31797/api/

API는 application/json 데이터를 사용하며 기본 인증을 요구합니다. 배치에서 작성한 데이터를 사용하여 UI에 액세스할 수 있습니다. 그러나 일부 기능은 관리자만 사용할 수 있습니다.

/api/index.html이 포함된 브라우저 URL에서 문서 및 예제가 배치와 함께 제공됩니다. 예를 들어, 다음과 같습니다. 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" 섹션에 있습니다. 이 표에는 참조에 대한 분석이 포함되어 있습니다.

표 1. 랍비 mqadmin/cli 연결 정보
필드 이름 Index 설명
Bin 연결을 작성하기 위해 권장되는 바이너리입니다. 이 경우 rabbitmqadmin입니다.
Composed 배치에 대한 연결을 설정하는 형식화된 명령. 명령은 Bin 실행 파일, Environment 변수 설정을 결합하고 Arguments 를 사용합니다.
Environment 환경 변수로 설정한 키 또는 값 목록입니다.
Arguments 0... Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다.
Certificate Base64 애플리케이션이 적합한 서버에 연결되었는지 확인하는 데 사용되는 자체 서명된 인증서입니다. 이는 base64로 인코딩됩니다.
Certificate 이름 자체 서명된 인증서에 할당된 이름입니다.
Type 이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 cli입니다.
  • 0... 배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.

이 예제 명령은 RabbitMQ에 있는 모든 exchange를 나열합니다.

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 서버가 청취하는 포트를 지정하는 매개변수입니다.
  • list exchanges - RabbitMQ 배치의 데이터베이스 멤버를 나열하는 rabbitmqadmin 명령입니다.

rabbitmqadmin 에 대한 문서 및 기타 예제는 RabbitMQ Management Command-Line Tool 페이지에 있습니다.

자체 서명된 인증서 사용

  1. 연결 정보의 Base64 필드에서 연결 정보를 복사하십시오.
  2. Base64 문자열을 텍스트로 디코딩하여 파일에 저장하십시오. (제공되는 이름 또는 자체 파일 이름을 사용할 수 있습니다.)
  3. 경로를 --ssl-ca-cert-file 매개변수에 제공하십시오.

ibmcloud cdb deployment-cacert "your-service-name" 명령을 사용하여 CLI 플러그인으로 배치에 대한 디코딩된 인증서를 표시할 수도 있습니다. base64를 텍스트로 디코딩합니다. 명령의 출력을 복사하여 파일에 저장하고 파일의 경로를 --ssl-ca-cert-file 매개변수에 제공하십시오.