快速入門

# 前言

本文檔為金蝶Apusic分散式訊息佇列for RabbitMQ（Apusic Distributed Message Queue，簡稱：ADMQ for RabbitMQ）的快速使用手冊，提供產品介紹，安裝部署產品的基本步驟及驗證方式。

# 適用對象

本文檔適用於IT資訊化業務負責人、研發經理、軟體專案經理、軟體架構師、維運工程師。

# 相關文件

了解更多ADMQ for RabbitMQ產品相關的資訊，請參閱以下ADMQ for RabbitMQ產品手冊文件集：

序號 手冊文件 說明
1 金蝶Apusic分散式訊息佇列for RabbitMQ 快速使用手冊 簡單介紹了如何快速上手使用ADMQ for RabbitMQ 。
2 金蝶Apusic分散式訊息佇列for RabbitMQ 安裝手冊 詳細介紹如何在各作業系統上安裝ADMQ for RabbitMQ，以及ADMQ for RabbitMQ服務啟停等操作。
3 金蝶Apusic分散式訊息佇列for RabbitMQ 訊息引擎使用者手冊 詳細介紹 ADMQ for RabbitMQ 訊息引擎相關功能的使用、配置、管理及配套工具的使用方法。
4 金蝶Apusic分散式訊息佇列for RabbitMQ 管控台使用者手冊 詳細介紹ADMQ for RabbitMQ管控台相關功能的使用和操作說明。
5 金蝶Apusic分散式訊息佇列for RabbitMQ 開發手冊 詳細介紹基於各開發語言進行ADMQ for RabbitMQ用戶端應用開發的說明。
6 金蝶Apusic分散式訊息佇列for RabbitMQ 遷移手冊 詳細介紹從RabbitMQ遷移到ADMQ for RabbitMQ的說明。
7 金蝶Apusic分散式訊息佇列for RabbitMQ 維運手冊 詳細介紹ADMQ for RabbitMQ的監控、維運、安全強化等維運說明。
8 金蝶Apusic分散式訊息佇列for RabbitMQ 效能最佳化手冊 詳細介紹ADMQ for RabbitMQ效能調校的說明。

# 技術支援

ADMQ for RabbitMQ產品提供全面的技術支援服務，您可以透過以下方式獲得技術支援：

  • 網址：www.apusic.com
  • 電話：400-855-5800
  • 信箱：support@apusic.com
  • 金蝶雲社區：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技術支援時，請提供如下資訊：

  1. 您的姓名

  2. 公司資訊與聯絡方式

  3. 作業系統及其版本

  4. 產品版本號

  5. 出現異常及錯誤的日誌、截圖等詳細資訊

# ADMQ 管控部署

# 一、準備工作

# 1.1 環境要求

  • 作業系統：CentOS 7+ / Ubuntu 18.04+，建議 4 核 8GB 以上

  • 網路：管控平台與 RabbitMQ 節點之間網路互通（埠：15672 管理埠、5672 服務埠）

# 1.2 安裝包

  • 取得管理控制台安裝包：admq-manager-V3.0.2.tar.gz（請聯絡技術支援獲取）

  • 將安裝包上傳至目標伺服器（如 /opt 目錄）

# 二、部署管理控制台

# 2.1 解壓安裝包

tar zxvf admq-manager-V3.0.2.tar.gz -C /opt/
cd /opt/admq-manager-V3.0.2
1
2

# 2.2 啟動控制台

bin/admq-service start
1

驗證啟動：

bin/admq-service status
1

看到 ADMQ Manager is running 即表示成功。

# 2.3 存取控制台

  • 瀏覽器存取：https://<控制台IP>:12306

  • 預設帳號：admq / 11111111（首次登入請修改密碼）

# 2.4 初始化預設配置

在伺服器執行：

bin/init all
1

# 三、部署 RabbitMQ 服務（在管理控制台操作）

# 3.1 上傳授權檔案

在【資源管理】-【License管理】上傳授權檔案

# 3.2 上傳軟體包

  1. 登入管理控制台，進入 資源管理 選單。

  2. 上傳：

    • 軟體包：admq-rabbitmq-<version>.tar.gz（平台預置或自訂）
  1. 等待上傳完成並驗證成功。

# 3.3 新增伺服器

在【資源管理】-【伺服器管理】新增伺服器，新增後會自動在伺服器上部署代理程式。

成功後可看到新增的記錄，會定時取得伺服器CPU、記憶體狀態，並取得授權特徵碼，如果申請正式授權，需要提供這裡的特徵碼資訊。

# 3.4 建立 RabbitMQ 服務

  1. 進入 叢集管理 → 叢集列表。

  2. 點選 快速部署 按鈕。

  1. 選擇中介軟體類型：ADMQ RabbitMQ。

  2. 選擇叢集模式：

    • 單機模式：單節點

    • 叢集模式：多節點，元資料共享

    • 映像模式：多節點，資料自動同步

  1. 點選 開始部署，後端會自動開始部署任務。

# 3.5 部署後狀態

  • 叢集列表顯示新接入的叢集，狀態為 "正常"。

# 四、業務側驗證

在叢集列表，點選右側的【進入業務功能】可以跳轉到資源管理頁面。

# 4.1 建立虛擬主機（vhost）

# 4.2 建立使用者

設定權限

# 4.3 建立交換器（Exchange）

在 test 下面新增交換器

# 4.4 建立佇列（Queue）

# 4.5 建立繫結（Binding）

要注意設定路由鍵

# 4.6 傳送測試訊息並消費驗證

在【資源管理】-【交換器管理】中選擇 ex01，點選【傳送訊息】

在【資源管理】-【佇列管理】，點選佇列名稱進入佇列詳情，點選【取得訊息】，可以看到訊息：

# 五、常見問題及處理

問題現象 可能原因 解決方法
測試連線失敗 網路不通或埠未開放 檢查防火牆、安全群組，確保 15672/5672 埠可達
啟動控制台報埠衝突 12306 埠被佔用 修改 config/application.properties 中的 server.port，重新啟動服務
建立資源時報 403 RabbitMQ 使用者權限不足 使用 administrator 標籤的使用者，或授予 .* 權限
訊息傳送後佇列無訊息 路由 key 不匹配或繫結錯誤 檢查交換器類型、路由 key 和繫結配置是否一致

# 技術支援

  • 電話：400-855-5800
  • 信箱：support@apusic.com
编辑页面 (opens new window)
#快速使用手册

← 管控台使用者手冊→