Skip to content

homepage: refresh Quick Start to the v2 contract (memory-storage default, CloudEvents publish, clientId subscribe) - #267

Merged
xwm1992 merged 1 commit into
apache:masterfrom
qqeasonchen:homepage/v2-quickstart
Sep 22, 2026
Merged

xwm1992 merged 1 commit into
apache:masterfrom
qqeasonchen:homepage/v2-quickstart

Conversation

@qqeasonchen

Copy link
Copy Markdown
Contributor

Homepage Quick Start refresh to the v2 contract. (The same change was pushed to the #266 branch minutes after it was squash-merged and missed it — resubmitted here on top of master 9002a7ef5. Content is byte-identical.)

Before → After

Old (v1.x API) New (v2 contract)
Start — docker run -d -p 10105:10105 -p 10106:10106 apache/eventmesh — memory storage by default, zero broker; GET :10106/admin/health
Publish POST /eventmesh/publish/TEST-TOPIC-HTTP-ASYNC + {name, pass} body POST /events/publish?topic=orders + CloudEvents 1.0 body (Content-Type: application/cloudevents+json, 202 Accepted = durable in the WAL)
Subscribe POST /eventmesh/subscribe/local webhook + consumerGroup POST /events/subscribe (clientId + mode, no consumer groups — EventMesh tracks offsets) + long-poll /events/poll + explicit /events/ack (at-least-once); SSE/WS noted
Storage tagline "RocketMQ, Kafka, AutoMQ" in-memory WAL default; RocketMQ 4.x/5.x + Kafka for production
Misc "Download v1.12.0" button label; Subscribe nav → community page label de-versioned; nav → /docs/quickstart/getting-started

Mirrors docs/quickstart/getting-started.md @ apache/eventmesh develop 624585d23.

- docker run (memory storage default, ports 10105/10106) + /admin/health
- publish: POST /events/publish?topic= with CloudEvents 1.0 body (202 Accepted)
- subscribe: /events/subscribe (clientId+mode) + poll + ack (at-least-once)
- storage tagline: in-memory WAL default, RocketMQ/Kafka for production
- drop stale v1.12.0 button label; fix Subscribe nav link

Mirrors apache/eventmesh develop docs/quickstart/getting-started.md @624585d23.
(Originally pushed to the apache#266 branch after it was merged; resubmitted here.)
@qqeasonchen

Copy link
Copy Markdown
Contributor Author

cc @MajorHe1 — you merged #266 (which landed the agent-tools page + Beta sync from the same branch); this is the homepage Quick Start refresh that was pushed to that branch minutes after your squash-merge and missed it. CI green (docusaurus build pass). Before/after table in the PR body; content mirrors apache/eventmesh develop docs/quickstart/getting-started.md @624585d23.

@xwm1992
xwm1992 merged commit 5a8203c into apache:master Sep 22, 2026
1 check 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.

2 participants