Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/apache/eventmesh

EventMesh is a new generation serverless event middleware for building distributed event-driven applications.
https://github.com/apache/eventmesh

cloud-native cqrs esb event-connector event-driven event-gateway event-governance event-mesh event-sourcing event-streaming hacktoberfest message-bus microservice multi-runtime pubsub serverless serverless-workflow

Last synced: 4 days ago
JSON representation

EventMesh is a new generation serverless event middleware for building distributed event-driven applications.

Host: GitHub
URL: https://github.com/apache/eventmesh
Owner: apache
License: apache-2.0
Created: 2019-09-16T03:04:56.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-11-03T18:32:53.000Z (2 months ago)
Last Synced: 2024-11-13T09:05:56.555Z (about 2 months ago)
Topics: cloud-native, cqrs, esb, event-connector, event-driven, event-gateway, event-governance, event-mesh, event-sourcing, event-streaming, hacktoberfest, message-bus, microservice, multi-runtime, pubsub, serverless, serverless-workflow
Language: Java
Homepage: https://eventmesh.apache.org/
Size: 67.3 MB
Stars: 1,616
Watchers: 67
Forks: 640
Open Issues: 208
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

my-awesome - apache/eventmesh - native,cqrs,esb,event-connector,event-driven,event-gateway,event-governance,event-mesh,event-sourcing,event-streaming,hacktoberfest,message-bus,microservice,multi-runtime,pubsub,serverless,serverless-workflow pushed_at:2025-01 star:1.6k fork:0.6k EventMesh is a new generation serverless event middleware for building distributed event-driven applications. (Java)

README

        











[![CI status](https://img.shields.io/github/actions/workflow/status/apache/eventmesh/ci.yml?logo=github&style=for-the-badge)](https://github.com/apache/eventmesh/actions/workflows/ci.yml)

[![CodeCov](https://img.shields.io/codecov/c/gh/apache/eventmesh/master?logo=codecov&style=for-the-badge)](https://codecov.io/gh/apache/eventmesh)

[![Code Quality: Java](https://img.shields.io/lgtm/grade/java/g/apache/eventmesh.svg?logo=lgtm&logoWidth=18&style=for-the-badge)](https://lgtm.com/projects/g/apache/eventmesh/context:java)

[![Total Alerts](https://img.shields.io/lgtm/alerts/g/apache/eventmesh.svg?logo=lgtm&logoWidth=18&style=for-the-badge)](https://lgtm.com/projects/g/apache/eventmesh/alerts/)

[![License](https://img.shields.io/github/license/apache/eventmesh?style=for-the-badge)](https://www.apache.org/licenses/LICENSE-2.0.html)

[![GitHub Release](https://img.shields.io/github/v/release/apache/eventmesh?style=for-the-badge)](https://github.com/apache/eventmesh/releases)

[![Slack Status](https://img.shields.io/badge/slack-join_chat-blue.svg?logo=slack&style=for-the-badge)](https://join.slack.com/t/the-asf/shared_invite/zt-1y375qcox-UW1898e4kZE_pqrNsrBM2g)

  

[📦 Documentation](https://eventmesh.apache.org/docs/introduction) |

[📔 Examples](https://github.com/apache/eventmesh/tree/master/eventmesh-examples) |

[⚙️ Roadmap](https://eventmesh.apache.org/docs/roadmap) |

[🌐 简体中文](README.zh-CN.md)



# Apache EventMesh

**Apache EventMesh** is a new generation serverless event middleware for building distributed [event-driven](https://en.wikipedia.org/wiki/Event-driven_architecture) applications.

### EventMesh Architecture

![EventMesh Architecture](resources/eventmesh-architecture-5.png)

### EventMesh K8S deployment

![EventMesh Operator](resources/eventmesh-operator.png)

## Features

Apache EventMesh has a vast amount of features to help users achieve their goals. Let us share with you some of the key features EventMesh has to offer:

- Built around the [CloudEvents](https://cloudevents.io) specification.

- Rapidty extendsible interconnector layer [connectors](https://github.com/apache/eventmesh/tree/master/eventmesh-connectors) using [openConnect](https://github.com/apache/eventmesh/tree/master/eventmesh-openconnect) such as the source or sink of Saas, CloudService, and Database etc.

- Rapidty extendsible storage layer such as [Apache RocketMQ](https://rocketmq.apache.org), [Apache Kafka](https://kafka.apache.org), [Apache Pulsar](https://pulsar.apache.org), [RabbitMQ](https://rabbitmq.com), [Redis](https://redis.io).

- Rapidty extendsible meta such as [Consul](https://consulproject.org/en/), [Nacos](https://nacos.io), [ETCD](https://etcd.io) and [Zookeeper](https://zookeeper.apache.org/).

- Guaranteed at-least-once delivery.

- Deliver events between multiple EventMesh deployments.

- Event schema management by catalog service.

- Powerful event orchestration by [Serverless workflow](https://serverlessworkflow.io/) engine.

- Powerful event filtering and transformation.

- Rapid, seamless scalability.

- Easy Function develop and framework integration.

## Roadmap

Please go to the [roadmap](https://eventmesh.apache.org/docs/roadmap) to get the release history and new features of Apache EventMesh.

## Subprojects

- [EventMesh-site](https://github.com/apache/eventmesh-site): Apache official website resources for EventMesh.

- [EventMesh-workflow](https://github.com/apache/eventmesh-workflow): Serverless workflow runtime for event Orchestration on EventMesh.

- [EventMesh-dashboard](https://github.com/apache/eventmesh-dashboard): Operation and maintenance console of EventMesh.

- [EventMesh-catalog](https://github.com/apache/eventmesh-catalog): Catalog service for event schema management using AsyncAPI.

- [EventMesh-go](https://github.com/apache/eventmesh-go): A go implementation for EventMesh runtime.

## Quick start

This section of the guide will show you the steps to deploy EventMesh from [Local](#run-eventmesh-runtime-locally), [Docker](#run-eventmesh-runtime-in-docker), [K8s](#run-eventmesh-runtime-in-kubernetes).  

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):

```shell

sudo docker pull apache/eventmesh:latest

```

#### 2. Run and Manage EventMesh Container

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:

```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

```

Run `kubectl get pods` 、`kubectl get crd | grep eventmesh-operator.eventmesh`to see the status of the deployed eventmesh-operator.

```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

```

#### 2. Deploy EventMesh Runtime

Execute the following command to deploy runtime, connector-rocketmq (To delete, simply replace `create` with `delete`):  

```shell

$ make create

```

Run `kubectl get pods` to see if the deployment was successful.

```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

```

## Contributing

[![GitHub repo Good Issues for newbies](https://img.shields.io/github/issues/apache/eventmesh/good%20first%20issue?style=flat&logo=github&logoColor=green&label=Good%20First%20issues)](https://github.com/apache/eventmesh/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) [![GitHub Help Wanted issues](https://img.shields.io/github/issues/apache/eventmesh/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20issues)](https://github.com/apache/eventmesh/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub Help Wanted PRs](https://img.shields.io/github/issues-pr/apache/eventmesh/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20PRs)](https://github.com/apache/eventmesh/pulls?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub repo Issues](https://img.shields.io/github/issues/apache/eventmesh?style=flat&logo=github&logoColor=red&label=Issues)](https://github.com/apache/eventmesh/issues?q=is%3Aopen)

Each contributor has played an important role in promoting the robust development of Apache EventMesh. We sincerely appreciate all contributors who have contributed code and documents.

- [Contributing Guideline](https://eventmesh.apache.org/community/contribute/contribute)

- [Good First Issues](https://github.com/apache/eventmesh/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)

## CNCF Landscape





Apache EventMesh enriches the CNCF Cloud Native Landscape.



## License

Apache EventMesh is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html).

## Community

| WeChat Assistant                                        | WeChat Public Account                                  | Slack                                                                                                                                               |

|---------------------------------------------------------|--------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|

|  |  | [Join Slack Chat](https://join.slack.com/t/the-asf/shared_invite/zt-1y375qcox-UW1898e4kZE_pqrNsrBM2g)(Please open an issue if this link is expired) |

Bi-weekly meeting : [#Tencent meeting](https://meeting.tencent.com/dm/wes6Erb9ioVV) : 346-6926-0133

Bi-weekly meeting record : [bilibili](https://space.bilibili.com/1057662180)

### Mailing List

| Name        | Description                                             | Subscribe                                                  | Unsubscribe                                                    | Archive                                                                          |

|-------------|---------------------------------------------------------|------------------------------------------------------------|----------------------------------------------------------------|----------------------------------------------------------------------------------|

| Users       | User discussion                                         | [Subscribe](mailto:[email protected])   | [Unsubscribe](mailto:[email protected])   | [Mail Archives](https://lists.apache.org/[email protected])   |

| Development | Development discussion (Design Documents, Issues, etc.) | [Subscribe](mailto:[email protected])     | [Unsubscribe](mailto:[email protected])     | [Mail Archives](https://lists.apache.org/[email protected])     |

| Commits     | Commits to related repositories                         | [Subscribe](mailto:[email protected]) | [Unsubscribe](mailto:[email protected]) | [Mail Archives](https://lists.apache.org/[email protected]) |

| Issues      | Issues or PRs comments and reviews                      | [Subscribe](mailto:[email protected])  | [Unsubscribe](mailto:[email protected])  | [Mail Archives](https://lists.apache.org/[email protected])  |