全部產品
Search
文件中心

ApsaraMQ for RabbitMQ:步驟二:建立資源

更新時間:Dec 27, 2024

一個新的應用接入雲訊息佇列 RabbitMQ 版服務端,您需要提前建立雲訊息佇列 RabbitMQ 版的相關資源,包括建立雲訊息佇列 RabbitMQ 版執行個體、建立Vhost、建立Exchange、建立Queue、綁定Exchange和Queue、建立使用者名稱密碼以及擷取執行個體存取點。調用訊息收發SDK時,您需要將這些資源資訊填寫到SDK參數中。

前提條件

若您使用RAM使用者建立資源,需要先為其授權,具體請參見步驟一:(可選)RAM使用者授權

建立執行個體

執行個體是一個獨立的雲訊息佇列 RabbitMQ 版資源實體,包含Vhost、Exchange、Queue等基本的資源要素。

  1. 登入雲訊息佇列 RabbitMQ 版控制台,然後在左側導覽列選擇实例列表

  2. 在頂部功能表列選擇地區,然後在实例列表頁面,單擊创建实例

  3. 在購買頁完成基本配置並勾選服務合約,然後單擊立即購買

  4. 根據提示完成支付。

    实例列表頁面的頂部功能表列,選擇地區,您可以看到建立的執行個體。

    說明
    • 專業版執行個體和企業版執行個體購買後,立即進入服务中狀態。

    • 鉑金版執行個體購買後,首先進入部署中狀態,待叢集分配後,再進入服务中狀態。

資源配置

1.建立Vhost

Vhost是指虛擬機器主機,用作邏輯隔離,分別管理各自的Exchange、Queue和Binding,使得應用安全地運行在不同的Vhost上,相互之間不會干擾。一個執行個體下可以有多個Vhost,一個Vhost裡面可以有若干個Exchange和Queue。Producer和Consumer串連雲訊息佇列 RabbitMQ 版需要指定一個Vhost。

  1. 登入雲訊息佇列 RabbitMQ 版控制台,然後在左側導覽列選擇实例列表

  2. 实例列表頁面的頂部功能表列選擇地區,然後在執行個體列表中,單擊目標執行個體名稱。

  3. 在左側導覽列,單擊Vhost 列表

  4. Vhost 列表頁面,單擊创建 Vhost

  5. 创建 Vhost面板的Vhost名称文字框,輸入Vhost名稱,然後單擊確定

2.建立Exchange

Producer將訊息發送到Exchange,由Exchange將訊息路由到一個或多個Queue中(或者丟棄)。Exchange根據Routing Key將訊息路由到Queue。不同類型的Exchange的路由規則不同。更多資訊,請參見Exchange

  1. 在該執行個體的左側導覽列,單擊Exchange 列表

  2. Exchange 列表頁面,在当前 Vhost右側的切换下拉式清單中,選擇Vhost,然後單擊创建 Exchange

  3. 创建 Exchange面板,輸入Exchange名稱,選擇Exchange类型,設定是否為Internal類型,然後單擊確定

    參數

    描述

    Exchange 名称

    Exchange名稱。以amq.開頭的為保留欄位,因此不能使用。例如:amq.test。

    类型

    Exchange類型。取值:

    • direct:該類型的路由規則會將訊息路由到Routing Key完全符合的Queue中。

    • topic:該類型與direct類型相似。Topic Exchange路由規則沒有Direct Exchange那麼嚴格,支援模糊比對和多條件匹配,即該類型Exchange使用Routing Key模式比對和字串比較的方式將訊息路由至綁定的Queue中。

    • fanout:該類型的路由規則非常簡單,會把所有發送到該Exchange的訊息路由到所有與它綁定的Queue中,相當於廣播功能。

    • headers:該類型與direct類型相似。Headers Exchange使用Headers屬性代替Routing Key進行路由匹配,在綁定Headers Exchange和Queue時,設定綁定屬性的索引值對;在向Headers Exchange發送訊息時,設定訊息的Headers屬性索引值對,使用訊息Headers屬性索引值對和綁定屬性索引值對比較的方式將訊息路由至綁定的Queue。

    • x-delayed-message:通過聲明該類Exchange,您可以自訂訊息的Header屬性x-delay來指定訊息延時投遞的時間段,單位為毫秒。訊息將在x-delay中定義的時間段後,根據路由規則被投遞到對應的Queue。路由規則取決於x-delayed-type中指定的Exchange路由類型。

    • x-consistent-hash:x-consistent-hash Exchange支援將Routing Key或Header值進行Hash計算,使用一致性雜湊演算法將訊息路由到不同的Queue上。

    x-delayed-type

    當Exchange類型為x-delayed-message時,需要配置此參數,以指定Exchange的路由類型。

    雜湊取值

    當Exchange類型為x-consistent-hash時,需要配置此參數,以指定Hash計算的輸入值為哪種類型。取值如下:

    • RoutingKey

    • Header 值:使用Header方式作為Hash計算輸入值時,您需要定義hash-header參數的取值。

    hash-header

    當Exchange類型為x-consistent-hash雜湊取值Header 值時,需要配置此參數,作為指定Hash計算的輸入值。

    Internal

    是否為Internal類型,預設值為。取值:

    • :內建類型,用於Exchange和Exchange之間的綁定。

    • :非內建類型,用於Exchange和Queue之間的綁定。

3.建立Queue

Queue是指隊列,雲訊息佇列 RabbitMQ 版的訊息都會被投入到一個或多個Queue中。

  1. 在該執行個體的左側導覽列,單擊Queue 列表

  2. Queue 列表頁面,在当前 Vhost右側的切换下拉式清單中,選擇Vhost,單擊创建 Queue

  3. 创建 Queue面板,在Queue 名称文字框輸入Queue的名稱,選擇是否為Auto Delete類型,單擊高级选项,設定Queue的參數,然後單擊確定

    參數

    描述

    說明

    Queue 名称

    Queue的名稱

    • 只能包含字母、數字、短劃線(-)、底線(_)、半形句號(.)、井號(#)、正斜線(/)、at符號(@)。

    • 長度限制在1~255字元。

    • 建立後無法修改,只能刪除重建。

    • 以amq.開頭的為保留欄位,因此不能使用。例如:amq.test。

    Auto Delete

    最後一個Consumer取消訂閱後,Queue是否自動刪除。

    • true:在訂閱該Queue訊息的最後一個Consumer取消訂閱該Queue的訊息後,自動刪除該Queue。

    • false:在訂閱該Queue訊息的最後一個Consumer取消訂閱該Queue的訊息後,不自動刪除該Queue。

    高级选项

    Queue的參數設定,可用於設定死信Exchange、死信Routing Key和訊息存活時間。

    • DeadLetterExchange:指定死信訊息發送的目標Exchange。

    • DeadLetterRoutingKey:指定死信訊息的Routing Key,即死信Exchange會將訊息發送至匹配該死信Routing Key所對應的Queue。

    • MessageTTL:訊息存活時間,單位毫秒(ms)。在指定時間內未被成功消費的訊息會變成死信訊息,該訊息將會被發送到死信Exchange。更多資訊,請參見訊息存活時間

4.建立綁定關係

  1. Queue 列表頁面,選擇指定Queue,在其操作列單擊详情

  2. Queue 详情頁面單擊被绑定信息頁簽,單擊添加被绑定

  3. 添加被绑定面板,選擇源Exchange,在Routing Key文字框輸入Routing Key,然後單擊确定

    說明

    若被綁定的Exchange的類型為x-consistent-hash時,Routing Key表示綁定的Queue的權重,只能設定為整數,取值範圍為[1~20]。

後續步驟

步驟三:調用SDK收發訊息

相關文檔

除了控制台,您還可以通過雲訊息佇列 RabbitMQ 版的API建立相關資源。