ddmq

README

English | 中文

DDMQ is a distributed messaging product built by DiDi Infrastructure Team based on Apache RocketMQ. As a distributed messaging middleware, DDMQ provides low latency, high throughput and high available messaging service to many important large-scale distributed systems inside DiDi. DDMQ provides realtime messaging, delay-time messaging and transactional messaging to satisfy different scenarios. Through an easy-to-use Web Console and simple SDK Client, developers can experience producing and consuming messages in the most simple and stable way.

---

Features

• Messaging model: support both P2P and Pub/Sub messaging model

• Massive message storage, support both RocketMQ and Kafka as storage engine

• Low latency & High throughput

• Delay message, use RocksDB as storage engine

• Transactional message: provide transaction similar to X/Open XA

• Multiple language client SDK: provide client SDK in PHP, Java, Go, C/C++, Python

• Message transition and filter with user-defined Groovy script

• An easy-to-use Web Console

---

Architecture Overview

---

Modules

• carrera-common: common code for other modules, such as encapsulate zk operations.

• carrera-producer: message producer proxy with built-in Thrift Server, responsible for forwarding message from SDK client to broker.

• carrera-consumer: message consumer proxy with built-in Thrift Server, provide SDK PULL and HTTP PUSH for message consumption.

• carrera-chronos: delay message module, use RocksDB as storage engine.

• carrera-sdk: producer and consumer SDK, support Java/C/C++/Go/PHP/Python.

• rocketmq: based on RocketMQ (Ver 4.2.0)，add new features such as broker auto fail-over.

• carrera-console: a Spring-based User Web Console.

• carrera-monitor: consumer lag monitor and DDMQ cluster monitor.

• carrera-docker: provide a DDMQ docker image that runs in standalone mode.

---

Quick Start

We provide a standalone version of DDMQ as Docker image, read this for more information.

---

Deployment

Dependencies

• 64bit OS, Linux/Unix/Mac
• 64bit JDK 1.8+
• Maven 3.2.x
• MySQL 5.7.x
• Tomcat 7/8/9
• Zookeeper 3.4.x

Deployment Procedures

• Deploy MySQL & Zookeeper

  Install MySQL 5.7: https://dev.mysql.com/doc/mysql-installation-excerpt/5.7/en/

  Install Zookeeper 3.4.x: https://zookeeper.apache.org/doc/r3.1.2/zookeeperStarted.html

• Deploy RocketMQ

  Guide: RocketMQ

• Init MySQL Tables

  Guide: MySQL

• Deploy Console

  Guide: Console

• Init Zookeeper Node and Data

  call console api：

  • curl http://console_addr:8080/carrera/api/odin/internal/v4/initZkPath
  • curl http://console_addr:8080/carrera/api/odin/internal/v4/initAllZk

• Deploy Producer Proxy

  Guide: Deploy PProxy

• Deploy Consumer Proxy

  Guide: Deploy CProxy

• Deploy Chronos

  Guide: Deploy Chronos

---

Usage

• read DDMQ Console Manual for more information.

---

Contributing

Welcome to contribute by creating issues or sending pull requests. See Contributing Guide for guidelines.

---

Contact

Feel free to contact DDMQ developers via ddmq_open_source@didiglobal.com

---

License

DDMQ is licensed under the Apache License 2.0. See the LICENSE file.