79 lines
6.4 KiB
Markdown
79 lines
6.4 KiB
Markdown
# Apache Dubbo Project
|
||
|
||
[](https://github.com/apache/dubbo/actions/workflows/build-and-test-pr.yml)
|
||
[](https://codecov.io/gh/apache/dubbo)
|
||
|
||
|
||
[](http://isitmaintained.com/project/apache/dubbo "Average time to resolve an issue")
|
||
[](http://isitmaintained.com/project/apache/dubbo "Percentage of issues still open")
|
||
[](https://twitter.com/intent/tweet?text=Apache%20Dubbo%20is%20a%20high-performance%2C%20java%20based%2C%20open%20source%20RPC%20framework.&url=http://dubbo.apache.org/&via=ApacheDubbo&hashtags=rpc,java,dubbo,micro-service)
|
||
[](https://twitter.com/intent/follow?screen_name=ApacheDubbo)
|
||
[](https://gitter.im/alibaba/dubbo?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
||
|
||
Apache Dubbo is an easy-to-use Web and RPC framework that provides multiple
|
||
language implementations(Java, [Go](https://github.com/apache/dubbo-go), [Rust](https://github.com/apache/dubbo-rust), [Node.js](https://github.com/apache/dubbo-js), [Web](https://github.com/apache/dubbo-js)) for communication, service discovery, traffic management,
|
||
observability, security, tools, and best practices for building enterprise-ready microservices.
|
||
|
||
Visit [the official website](https://dubbo.apache.org/) for more information.
|
||
|
||
## Architecture
|
||
|
||
|
||
* Consumer and provider communicate with each other using RPC protocol like triple, tcp, rest, etc.
|
||
* Consumers automatically trace provider instances registered in registries(Zookeeper, Nacos) and distribute traffic among them by following traffic strategies.
|
||
* Rich features for monitoring and managing the cluster with dynamic configuration, metrics, tracing, security, and visualized console.
|
||
|
||
## Getting started
|
||
Follow the instructions below to learn how to:
|
||
|
||
### Programming with lightweight RPC API
|
||
[5 minutes step-by-step guide](https://dubbo.apache.org/zh-cn/overview/quickstart/rpc/java)
|
||
|
||
Dubbo supports building RPC services with only a few lines of code while depending only on a lightweight SDK (<10MB). The protocol on the wire can be [Triple](https://dubbo.apache.org/zh-cn/overview/reference/protocols/triple/)(fully gRPC compatible and HTTP-friendly), Dubbo2(TCP), REST, or any protocol of your choice.
|
||
|
||
|
||
### Building a microservice application with Spring Boot
|
||
[5 minutes step-by-step guide](https://dubbo.apache.org/zh-cn/overview/quickstart/microservice)
|
||
|
||
It's highly recommended to start your microservice application with the Spring Boot Starter `dubbo-spring-boot-starter` provided by Dubbo. With only a single dependency and yaml file, and optionally a bunch of other useful spring boot starters, you can enable all of the Dubo features like service discovery, observability, tracing, etc.
|
||
|
||
Next, learn how to [deploy](https://dubbo.apache.org/zh-cn/overview/tasks/deploy/), [monitor](https://dubbo.apache.org/zh-cn/overview/tasks/observability/), and [manage the traffic](https://dubbo.apache.org/zh-cn/overview/tasks/traffic-management/) of your Dubbo application and cluster.
|
||
|
||
## More Features
|
||
Get more details by visiting the links below to get your hands dirty with some well-designed tasks on our website.
|
||
|
||
* [Launch a Dubbo project](https://dubbo.apache.org/zh-cn/overview/tasks/develop/template/)
|
||
* [RPC protocols](https://dubbo.apache.org/zh-cn/overview/core-features/protocols/)
|
||
* [Traffic management](https://dubbo.apache.org/zh-cn/overview/core-features/traffic/)
|
||
* [Service discovery](https://dubbo.apache.org/zh-cn/overview/core-features/service-discovery/)
|
||
* [Observability](https://dubbo.apache.org/zh-cn/overview/core-features/observability/)
|
||
* [Extensibility](https://dubbo.apache.org/zh-cn/overview/core-features/extensibility/)
|
||
* [Security](https://dubbo.apache.org/zh-cn/overview/core-features/security/)
|
||
* [Visualized console and control plane](https://dubbo.apache.org/zh-cn/overview/reference/admin/)
|
||
* [Kubernetes and Service mesh](https://dubbo.apache.org/zh-cn/overview/core-features/service-mesh/)
|
||
|
||
## Which Dubbo version should I use?
|
||
| **Dubbo3** | **JDK** | **Dependencies** | **Description** |
|
||
| --- | --- | --- | --- |
|
||
| 3.3.0-beta| 1.8 ～ 17 | [dependency list](https://github.com/apache/dubbo/blob/3.3/dubbo-dependencies-bom/pom.xml#L94) | **- Unstable version** <br/> **- Features** <br/> - Triple - gRPC and cURL compatible.<br/> - Rest-style programming support.<br/> - Spring Boot Starters. |
|
||
| 3.2.5 | 1.8 ～ 17 | [dependency list](https://github.com/apache/dubbo/blob/dubbo-3.2.5/dubbo-dependencies-bom/pom.xml#L94) | **- Stable version (active)** <br/> **- Features** <br/> - Out-of-box metrics and tracing support.<br/> - Threadpool Isolation<br/> - 30% performance<br/> - Native Image|
|
||
| 3.1.11 | 1.8 ～ 11 | [dependency list](https://github.com/apache/dubbo/blob/dubbo-3.2.11/dubbo-dependencies-bom/pom.xml#L94) | **Stable version (not active)** |
|
||
|
||
| **Dubbo2** | **JDK** | **Dependencies** | **Description** |
|
||
| --- | --- | --- | --- |
|
||
| 2.7.23 | 1.8 | [dependency list](https://github.com/apache/dubbo/blob/dubbo-2.7.23/dubbo-dependencies-bom/pom.xml#L92) | EOL |
|
||
| 2.6.x, 2.5.x | 1.6 ～ 1.7 | | EOL |
|
||
|
||
## Contributing
|
||
See [CONTRIBUTING](https://github.com/apache/dubbo/blob/master/CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
|
||
|
||
## Contact
|
||
* WeChat: apachedubbo
|
||
* DingTalk group: 37290003945
|
||
* Mailing list: [guide](https://dubbo.apache.org/zh-cn/contact/)
|
||
* Twitter: [@ApacheDubbo](https://twitter.com/ApacheDubbo)
|
||
* Security issues: please mail to [us](mailto:security@dubbo.apache.org) privately.
|
||
|
||
## License
|
||
Apache Dubbo is licensed under the Apache License Version 2.0. See the [LICENSE](https://github.com/apache/dubbo/blob/master/LICENSE) file for details.
|