將 RocksMQ 用作 Milvus 訊息佇列

RocksMQ 是一套隨 Milvus 捆綁提供的內嵌式訊息佇列（WAL），僅適用於Milvus Standalone 版本。在較早的 Milvus 版本中，它曾是預設的獨立執行模式訊息佇列；而在 Milvus 3.x 版本中，Milvus Standalone 預設使用內嵌式Woodpecker。

版本相容性

• 僅限獨立執行模式— Milvus 分散式（叢集）不支援 RocksMQ。請參閱訊息佇列相容性對照表。
• RocksMQ 隨 Milvus 一併提供，因此無需另行安裝。
• 在較早版本的 Milvus 中，它曾是預設的獨立執行模式訊息佇列，但在 Milvus 3.x 中已被內建的 Woodpecker 取代。

使用 Docker 部署搭配 RocksMQ 的 Milvus 獨立執行模式

安裝

請參照《在 Docker 中執行 Milvus》。在 Milvus 3.x 中，獨立模式的預設值為 Woodpecker，因此請明確將訊息佇列類型切換為 RocksMQ。初始化腳本會在首次執行start 時建立新的user.yaml ，因此請在首次啟動後設定類型，然後執行restart 以套用設定（執行restart 可保留user.yaml 中的資料）：

mkdir milvus-rocksmq && cd milvus-rocksmq
curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh

# 1. First start — boots the container and writes a default user.yaml
bash standalone_embed.sh start

# 2. Set the message queue to RocksMQ
cat > user.yaml <<'EOF'
mq:
  type: rocksmq
EOF

# 3. Restart to apply the change
bash standalone_embed.sh restart

設定

若要調整 RocksMQ，請在 `user.yaml ` 檔案中新增 `rocksmq ` 區段，並重新啟動服務：

mq:
  type: rocksmq
rocksmq:
  path: /var/lib/milvus/rdb_data   # where messages are stored
  lrucacheratio: 0.06              # rocksdb cache memory ratio
  rocksmqPageSize: 67108864        # 64 MB, size of each message page
  retentionTimeInMinutes: 4320     # 3 days
  retentionSizeInMB: 8192          # 8 GB
  compactionInterval: 86400        # 1 day, trigger rocksdb compaction
  compressionTypes: [0, 0, 7, 7, 7]

bash standalone_embed.sh restart

解除安裝

bash standalone_embed.sh stop
bash standalone_embed.sh delete

注意事項

• 從 2.5.x 升級至 2.6.x： 訊息佇列限制：升級至 Milvus v3.0.0 時，必須維持當前的訊息佇列選擇。升級過程中不支援在不同的訊息佇列系統之間切換。未來版本將支援變更訊息佇列系統。 由於 2.6.x 將獨立執行模式的預設值變更為 Woodpecker，若您希望繼續使用 RocksMQ，請在升級前於 user.yaml 中將mq.type: rocksmq 鎖定。
• 若要變更正在運作的實例所使用的訊息佇列，請參閱《從 RocksMQ 切換至 Woodpecker》。

後續發展

• Woodpecker（預設訊息佇列）
• 從 RocksMQ 切換至 Woodpecker