Apache Dubbo-go English

Apache Dubbo Go 语言实现

证书

Apache License, Version 2.0

发布日志

v1.4.0 - 2020年3月17日

v1.3.0 - 2020年3月1日

v1.2.0 - 2019年11月15日

v1.1.0 - 2019年9月7日捐献给Apache之后的第一次release

v1.0.0 - 2019年5月29日兼容dubbo v2.6.5 版本

工程架构

基于dubbo的extension模块和分层的代码设计(包括 protocol layer, registry layer, cluster layer, config 等等)。我们的目标是：你可以对这些分层接口进行新的实现，并通过调用 extension 模块的“ extension.SetXXX ”方法来覆盖 dubbo-go [同 go-for-apache-dubbo ]的默认实现，以完成自己的特殊需求而无需修改源代码。同时，欢迎你为社区贡献有用的拓展实现。

框架设计

关于详细设计请阅读 code layered design

功能列表

实现列表:

角色端
- Consumer
- Provider
传输协议
- HTTP
- TCP
序列化协议
- JsonRPC V2
- Hessian V2
协议
- Dubbo
- Jsonrpc2.0
- gRPC
- RESTful
路由器
- Condition router
- Health check router
注册中心
- ZooKeeper
- etcd v3
- nacos
- consul
- k8s
动态配置中心与服务治理配置器
- Zookeeper
- apollo
- nacos
集群策略
- Failover
- Failfast
- Failsafe/Failback
- Available
- Broadcast
- Forking
负载均衡策略
- Random
- RoundRobin
- LeastActive
- ConsistentHash
过滤器
- Echo Health Check
- 服务熔断&降级
- TokenFilter
- AccessLogFilter
- TpsLimitFilter
- ExecuteLimitFilter
- Auth/Sign
- Metrics filter
- Tracing filter
调用
- 泛化调用
监控
- Opentracing API
- Prometheus
Tracing
其他功能支持:
- 启动时检查
- 服务直连
- 多服务协议
- 多注册中心
- 多服务版本
- 服务分组

开发中列表:

元数据中心 (dubbo v2.7.x)
服务发现 (dubbo v2.7.x)

你可以通过访问 roadmap 知道更多关于 dubbo-go 的信息。

feature

文档

https://dubbogo.github.io/dubbo-go-website (完善中)

快速开始

dubbo-samples/golang这个项目的事例展示了如何使用 dubbo-go 。请仔细阅读 dubbo-samples/golang/README.md 学习如何处理配置并编译程序。

运行单测

准备

Mac/Linux

sh ./before_ut.sh

Windows

before_ut.bat

执行

go test ./...

# coverage
go test ./... -coverprofile=coverage.txt -covermode=atomic

编译

请移步 dubbo-samples/golang

如何贡献

如果您愿意给 Apache/dubbo-go 贡献代码或者文档，我们都热烈欢迎。具体请参考 contribution intro。

性能测试

性能测试项目是 dubbo-go-benchmark。

关于 dubbo-go 性能测试报告，请阅读 dubbo benchmarking report & jsonrpc benchmarking report。

User List

若你正在使用 apache/dubbo-go 且认为其有用或者向对其做改进，请忝列贵司信息于用户列表，以便我们知晓之。

ctrip Excellent Health Technology Group tuya