Skip to content

[Studio] feat: add docker compose test cluster with message trace for local debugging - #655

Merged
lizhimins merged 1 commit into
apache:rocketmq-studiofrom
lizhimins:feat-deploy-rocketmq
Jul 29, 2026
Merged

[Studio] feat: add docker compose test cluster with message trace for local debugging#655
lizhimins merged 1 commit into
apache:rocketmq-studiofrom
lizhimins:feat-deploy-rocketmq

Conversation

@lizhimins

Copy link
Copy Markdown
Member

Summary

  • Add deploy/rocketmq/: build an image from the Apache RocketMQ develop branch source (multi-stage Dockerfile, build.sh auto-selects Aliyun mirrors for apt/Maven when running in China) and launch a local test cluster via docker compose: NameServer + 2 Brokers (cluster rocketmq-studio, brokers rocketmq-studio-0/1, 1C2G each) + Proxy (remoting 8080 / gRPC 8081).
  • Message trace enabled end to end: brokers set traceOn=true / traceTopicEnable=true; bundled producer/consumer containers send and receive at 1 TPS through the proxy with enableMsgTrace=true and message keys, so RMQ_SYS_TRACE_TOPIC always has live trace data for Studio debugging.
  • Add .claude/skills/deploy-rocketmq skill: step-by-step deployment guide plus verified mqadmin usage for clusterList, queryMsgByUniqueKey, queryMsgTraceById, and queryMsgByKey.

Test plan

  • ./build.sh builds apache-rocketmq:develop from the develop branch (Aliyun mirror auto-detection verified in a CN environment)
  • docker compose up -d brings up all 6 containers; clusterList shows both brokers ACTIVATED under rocketmq-studio
  • Producer logs continuous SEND_OK at 1 TPS and consumer consumes matching messages via proxy:8080
  • queryMsgByUniqueKey / queryMsgTraceById / queryMsgByKey all return expected data, including Pub/Sub trace records
  • Fresh redeploy (docker compose down -v && up -d) verified end to end

@lizhimins lizhimins changed the title feat: add docker compose test cluster with message trace for local debugging [Studio] feat: add docker compose test cluster with message trace for local debugging Jul 29, 2026
@lizhimins
lizhimins merged commit 95f37df into apache:rocketmq-studio Jul 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant