This is an automated email from the ASF dual-hosted git repository.
mikexue pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/eventmesh.git
The following commit(s) were added to refs/heads/master by this push:
new 0c0f30eb5 Update README.md (#5198)
0c0f30eb5 is described below
commit 0c0f30eb5f4079139dbf44fed903697f152c31ee
Author: Eason Chen <[email protected]>
AuthorDate: Wed Apr 30 16:39:16 2025 +0800
Update README.md (#5198)
---
README.md | 134 +++++++++++++++++++++-----------------------------------------
1 file changed, 46 insertions(+), 88 deletions(-)
diff --git a/README.md b/README.md
index b9975018d..cb582fe2e 100644
--- a/README.md
+++ b/README.md
@@ -67,48 +67,6 @@ This section of the guide will show you the steps to deploy
EventMesh from [Loca
This section guides the launch of EventMesh according to the default
configuration, if you need more detailed EventMesh deployment steps, please
visit the [EventMesh official
document](https://eventmesh.apache.org/docs/introduction).
-### Deployment Event Store
-
-> EventMesh supports [multiple Event
Stores](https://eventmesh.apache.org/docs/roadmap#event-store-implementation-status),
the default storage mode is `standalone`, and does not rely on other event
stores as layers.
-
-### Run EventMesh Runtime locally
-
-#### 1. Download EventMesh
-
-Download the latest version of the Binary Distribution from the [EventMesh
Download](https://eventmesh.apache.org/download/) page and extract it:
-
-```shell
-wget
https://dlcdn.apache.org/eventmesh/1.10.0/apache-eventmesh-1.10.0-bin.tar.gz
-tar -xvzf apache-eventmesh-1.10.0-bin.tar.gz
-cd apache-eventmesh-1.10.0
-```
-
-#### 2. Run EventMesh
-
-Execute the `start.sh` script to start the EventMesh Runtime server.
-
-```shell
-bash bin/start.sh
-```
-
-View the output log:
-
-```shell
-tail -n 50 -f logs/eventmesh.out
-```
-
-When the log output shows server `state:RUNNING`, it means EventMesh Runtime
has started successfully.
-
-You can stop the run with the following command:
-
-```shell
-bash bin/stop.sh
-```
-
-When the script prints `shutdown server ok!`, it means EventMesh Runtime has
stopped.
-
-### Run EventMesh Runtime in Docker
-
#### 1. Pull EventMesh Image
Use the following command line to download the latest version of
[EventMesh](https://hub.docker.com/r/apache/eventmesh):
@@ -117,67 +75,67 @@ Use the following command line to download the latest
version of [EventMesh](htt
sudo docker pull apache/eventmesh:latest
```
-#### 2. Run and Manage EventMesh Container
+#### 2. Run EventMesh Runtime
Use the following command to start the EventMesh container:
```shell
sudo docker run -d --name eventmesh -p 10000:10000 -p 10105:10105 -p
10205:10205 -p 10106:10106 -t apache/eventmesh:latest
```
-
-
-Enter the container:
-
-```shell
-sudo docker exec -it eventmesh /bin/bash
-```
-
-view the log:
-
+#### 3. Creating Topics
+Creating a topic is the first step in using EventMesh. You need to send an
HTTP POST request to create a topic.
+Example Request
```shell
-cd logs
-tail -n 50 -f eventmesh.out
-```
-
-### Run EventMesh Runtime in Kubernetes
-
-#### 1. Deploy operator
-
-Run the following commands(To delete a deployment, simply replace `deploy`
with `undeploy`):
-
-```shell
-$ cd eventmesh-operator && make deploy
+POST /eventmesh/topic/create HTTP/1.1
+Host: localhost:10105
+Content-Type: application/json
+
+{
+ "topic": "example-topic"
+}
```
-
-Run `kubectl get pods` 、`kubectl get crd | grep
eventmesh-operator.eventmesh`to see the status of the deployed
eventmesh-operator.
+#### 4. Subscribing to Topics
+After creating a topic, you can subscribe to it to receive messages. EventMesh
provides two subscription methods: local subscription and remote subscription.
```shell
-$ kubectl get pods
-NAME READY STATUS RESTARTS AGE
-eventmesh-operator-59c59f4f7b-nmmlm 1/1 Running 0 20s
-
-$ kubectl get crd | grep eventmesh-operator.eventmesh
-connectors.eventmesh-operator.eventmesh 2024-01-10T02:40:27Z
-runtimes.eventmesh-operator.eventmesh 2024-01-10T02:40:27Z
+POST /eventmesh/subscribe/local HTTP/1.1
+Host: localhost:10105
+Content-Type: application/json
+{
+ "url": "http://localhost:8080/callback",
+ "consumerGroup": "example-consumer-group",
+ "topic": [
+ {
+ "topic": "example-topic",
+ "mode": "CLUSTERING",
+ "type": "SYNC"
+ }
+ ]
+}
```
-
-#### 2. Deploy EventMesh Runtime
-
-Execute the following command to deploy runtime, connector-rocketmq (To
delete, simply replace `create` with `delete`):
-
+#### 5. Sending Messages
+EventMesh provides multiple message sending methods, including asynchronous
sending, synchronous sending, and batch sending.
```shell
-$ make create
+POST /eventmesh/publish HTTP/1.1
+Host: localhost:10105
+Content-Type: application/json
+eventmesh-message-topic: example-topic
+{
+ "content": "Hello, EventMesh!"
+}
```
-
-Run `kubectl get pods` to see if the deployment was successful.
-
+#### 6. Unsubscribing
+When you no longer need to receive messages for a topic, you can unsubscribe.
```shell
-NAME READY STATUS RESTARTS AGE
-connector-rocketmq-0 1/1 Running 0 9s
-eventmesh-operator-59c59f4f7b-nmmlm 1/1 Running 0 3m12s
-eventmesh-runtime-0-a-0 1/1 Running 0 15s
+POST /eventmesh/unsubscribe/local HTTP/1.1
+Host: localhost:10105
+Content-Type: application/json
+{
+ "url": "http://localhost:8080/callback",
+ "consumerGroup": "example-consumer-group",
+ "topics": ["example-topic"]
+}
```
-
## Contributing
[](https://github.com/apache/eventmesh/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
[](https://github.com/apache/eventmesh
[...]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]