dubbo-go

module
v3.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 17, 2023 License: Apache-2.0

README

Apache Dubbo-go

Build Status codecov go.dev reference Go Report Card license


中文 🇨🇳

Apache Dubbo-go, a Dubbo implementation written in Golang, is born to bridge the gap between Java/Dubbo and Go/X. Please visit our Dubbo official website for the quick start and documentation.

RPC invocation

Dubbo-go has supported many RPC protocols, like Triple, Dubbo, JSONRPC, gRPC, HTTP, HTTP2. The Triple, Dubbo and gRPC protocols supported security connections via TLS.

  • Triple is the supported protocol of Dubbo3 ecology, and is gRPC extended protocol based on HTTP2, which is compatible with gRPC service.In other words, on the basis of gRPC's reliable invocation, it adds Dubbo's service governance capability.
  • Dubbo protocol is tradition Dubbo ecology protocol, which is compatible with Dubbo 2.x, and is a good choice for cross-language invocation between GO and Java legacy service.
  • HTTP support: As you can see in the figure above, you can invoke Triple/Dubbo service using HTTP protocol through dubbo-go-pixiu gateway.

Service governance capability

Getting started

Tools

  • imports-formatter formatting dubbo-go project import code block.
  • dubbo-go-cli dubbo-go command line tools, by which you can define your own request pkg and gets rsp struct of your server, test your service as telnet and generate hessian.POJO register method body.
  • dubbo-go-cli-v2 new dubbo-go line tools, you can get services from register center, create a demo , create application templates, one-click installation of protoc-gen-go-triple and imports-formatter tools,and has the same features with dubbo-go-cli.
  • protoc-gen-go-triple tripe protocol pb file generation tool.
  • protoc-gen-dubbo3grpc dubbo3 grpc pb file generation tool.

If you want to know more about dubbogo tools, please visit https://github.com/apache/dubbo-go/blob/master/dubbogo-cli and read its readme carefully.

Intellij plugin

  • Windows: File > Settings > Plugins > Browse repositories... > Search for "Dubbo Go" > Install Plugin
  • MacOS: Preferences > Settings > Plugins > Browse repositories... > Search for "Dubbo Go" > Install Plugin
  • Manually:
    • Download the latest release and install it manually using Preferences > Plugins > Install plugin from disk...
    • From official jetbrains store from download
Features
Feature IDEA GoLand
Hessian2 Generator ✅️ ✅️
New Project/Module ✅️ ✅️
Project/module templates
Project/Module Template Progress
Sample ✅️
Empty Project ✅️
Empty project template middleware
Middleware Module Support
Web Service Gin ✅️
Memory Cache Redis ✅️
Database Gorm ✅️

If you want to know more about the Intellij Plugin for Dubbo-go, you may refer to https://gitee.com/changeden/intellij-plugin-dubbo-go-generator.

Ecosystem

  • Dubbo Ecosystem Entry - A GitHub group dubbo to gather all Dubbo relevant projects not appropriate in apache group yet.
  • dubbo-go-pixiu - A dynamic, high-performance API gateway solution for Dubbo and Http services.
  • dubbo-go-samples - Samples for Apache Dubbo-go.
  • dubbo-getty - A netty like asynchronous network I/O library which supports tcp/udp/websocket network protocol.
  • triple - A golang network package that based on http2, used by Dubbo-go 3.0.
  • dubbo-go-hessian2 - A golang hessian library used by Apache/dubbo-go.
  • gost - A go sdk for Apache Dubbo-go.

Contributing

Please visit CONTRIBUTING for details on submitting patches and the contribution workflow.

Reporting bugs

Please use the bug report template to report bugs, use the enhancement template to provide suggestions for improvement.

Contact

User List

If you are using apache/dubbo-go and think that it helps you or want to contribute code for Dubbo-go, please add your company to the user list to let us know your needs.

See more user cases

License

Apache Dubbo-go software is licenced under the Apache License Version 2.0. See the LICENSE file for details.

Directories

Path Synopsis
cluster/adaptivesvc
Package adaptivesvc implements adaptive service cluster strategy.
Package adaptivesvc implements adaptive service cluster strategy.
cluster/available
Package available implements Available cluster strategy.
Package available implements Available cluster strategy.
cluster/base
Package base implements invoker for the manipulation of cluster strategy.
Package base implements invoker for the manipulation of cluster strategy.
cluster/broadcast
Package broadcast implements Broadcast cluster strategy.
Package broadcast implements Broadcast cluster strategy.
cluster/failback
Package failback implements Failback cluster strategy.
Package failback implements Failback cluster strategy.
cluster/failfast
Package failfast implements Failfast cluster strategy.
Package failfast implements Failfast cluster strategy.
cluster/failover
Package failover implements Failover cluster strategy.
Package failover implements Failover cluster strategy.
cluster/failsafe
Package failsafe implements Failsafe cluster strategy.
Package failsafe implements Failsafe cluster strategy.
cluster/forking
Package forking implements forking cluster strategy.
Package forking implements forking cluster strategy.
cluster/zoneaware
Package zoneaware implements zoneaware cluster strategy.
Package zoneaware implements zoneaware cluster strategy.
cluster_impl
Package cluster_impl is for being compatible with older dubbo-go, please use `imports` package.
Package cluster_impl is for being compatible with older dubbo-go, please use `imports` package.
loadbalance/consistenthashing
Package consistenthashing implements ConsistentHash load balance strategy.
Package consistenthashing implements ConsistentHash load balance strategy.
loadbalance/leastactive
Package leastactive implements LeastActive load balance strategy.
Package leastactive implements LeastActive load balance strategy.
loadbalance/p2c
Package p2c implements p2c load balance strategy.
Package p2c implements p2c load balance strategy.
loadbalance/random
Package random implements Random load balance strategy.
Package random implements Random load balance strategy.
loadbalance/roundrobin
Package roundrobin implements RoundRobin load balance strategy.
Package roundrobin implements RoundRobin load balance strategy.
metrics
Package mock_metrics is a generated GoMock package.
Package mock_metrics is a generated GoMock package.
Package config defines the Dubbo-go config, which carries ApplicationConfig、 RegisterConfig、ProtocolConfig、RouterConfig and MetadataReportConfig etc.
Package config defines the Dubbo-go config, which carries ApplicationConfig、 RegisterConfig、ProtocolConfig、RouterConfig and MetadataReportConfig etc.
Package config_center defines interfaces to be implemented by Config Center driver.
Package config_center defines interfaces to be implemented by Config Center driver.
file
Package file implements config center around file system.
Package file implements config center around file system.
nacos
Package nacos implements config center around Nacos.
Package nacos implements config center around Nacos.
zookeeper
Package zookeeper implements config center around zookeeper.
Package zookeeper implements config center around zookeeper.
Package filter defines the functions of a filter.
Package filter defines the functions of a filter.
accesslog
Package accesslog providers logging filter.
Package accesslog providers logging filter.
adaptivesvc
Package adaptivesvc providers AdaptiveService filter.
Package adaptivesvc providers AdaptiveService filter.
auth
Package auth providers authorization filter.
Package auth providers authorization filter.
echo
Package echo providers health check filter.
Package echo providers health check filter.
exec_limit
Package exec_limit provides a filter for limiting the number of in-progress request and it's thread-safe.
Package exec_limit provides a filter for limiting the number of in-progress request and it's thread-safe.
filter_impl
Package filter_impl is for being compatible with older dubbo-go, please use `imports` package.
Package filter_impl is for being compatible with older dubbo-go, please use `imports` package.
generic
Package generic provides generic invoke filter.
Package generic provides generic invoke filter.
graceful_shutdown
Package graceful_shutdown provides a filter for shutting down gracefully.
Package graceful_shutdown provides a filter for shutting down gracefully.
handler
Package filter is a generated GoMock package.
Package filter is a generated GoMock package.
hystrix
Package hystrix provides hystrix filter.
Package hystrix provides hystrix filter.
metrics
Package metrics provides metrics collection filter.
Package metrics provides metrics collection filter.
otel/trace
Package trace instruments dubbogo with open-telemetry (https://github.com/open-telemetry/opentelemetry-go).
Package trace instruments dubbogo with open-telemetry (https://github.com/open-telemetry/opentelemetry-go).
seata
Package seata provides a filter when use seata-golang, use this filter to transfer xid.
Package seata provides a filter when use seata-golang, use this filter to transfer xid.
sentinel
Package sentinel provides a filter when using sentinel.
Package sentinel provides a filter when using sentinel.
token
Package token provides token filter.
Package token provides token filter.
tps
Package tps provides a filter for limiting the requests by TPS.
Package tps provides a filter for limiting the requests by TPS.
tps/limiter
Package filter is a generated GoMock package.
Package filter is a generated GoMock package.
tps/strategy
Package filter is a generated GoMock package.
Package filter is a generated GoMock package.
tracing
Package tracing provides tracing collection filter.
Package tracing provides tracing collection filter.
zap
metadata
Package metrics define interfaces for metrics collection.
Package metrics define interfaces for metrics collection.
dubbo
Package dubbo implements dubbo rpc protocol.
Package dubbo implements dubbo rpc protocol.
dubbo3
Package dubbo3 implements dubbo3.0 rpc protocol.
Package dubbo3 implements dubbo3.0 rpc protocol.
dubbo3/health
Package health provides a service that exposes server's health and it must be imported to enable support for client-side health checks.
Package health provides a service that exposes server's health and it must be imported to enable support for client-side health checks.
dubbo3/reflection
Package reflection implements server reflection service.
Package reflection implements server reflection service.
grpc
Package grpc implements grpc rpc protocol.
Package grpc implements grpc rpc protocol.
jsonrpc
Package jsonrpc implements json rpc protocol.
Package jsonrpc implements json rpc protocol.
mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
rest
Package rest implements restful rpc protocol.
Package rest implements restful rpc protocol.
Package registry defines interfaces to be implemented by service register and service discovery driver.
Package registry defines interfaces to be implemented by service register and service discovery driver.
directory
Package directory implements registry around file system.
Package directory implements registry around file system.
etcdv3
Package etcdv3 implements registry around etcd.
Package etcdv3 implements registry around etcd.
nacos
Package nacos implements registry around Nacos.
Package nacos implements registry around Nacos.
polaris
Package polaris implements registry around polaris.
Package polaris implements registry around polaris.
xds
zookeeper
Package zookeeper implements registry around zookeeper.
Package zookeeper implements registry around zookeeper.
Package remoting provides facilities for decoding and encoding, client and server.
Package remoting provides facilities for decoding and encoding, client and server.
xds
xds
balancer
Package balancer installs all the xds balancers.
Package balancer installs all the xds balancers.
balancer/cdsbalancer
Package cdsbalancer implements a balancer to handle CDS responses.
Package cdsbalancer implements a balancer to handle CDS responses.
balancer/clusterimpl
Package clusterimpl implements the xds_cluster_impl balancing policy.
Package clusterimpl implements the xds_cluster_impl balancing policy.
balancer/clustermanager
Package clustermanager implements the cluster manager LB policy for xds.
Package clustermanager implements the cluster manager LB policy for xds.
balancer/clusterresolver
Package clusterresolver contains EDS balancer implementation.
Package clusterresolver contains EDS balancer implementation.
balancer/loadstore
Package loadstore contains the loadStoreWrapper shared by the balancers.
Package loadstore contains the loadStoreWrapper shared by the balancers.
balancer/orca
Package orca implements Open Request Cost Aggregation.
Package orca implements Open Request Cost Aggregation.
balancer/priority
Package priority implements the priority balancer.
Package priority implements the priority balancer.
balancer/ringhash
Package ringhash implements the ringhash balancer.
Package ringhash implements the ringhash balancer.
client
package client implements a full fledged gRPC client for the xDS API used by the xds resolver and balancer implementations.
package client implements a full fledged gRPC client for the xDS API used by the xds resolver and balancer implementations.
client/bootstrap
Package bootstrap provides the functionality to initialize certain aspects of an xDS client by reading a bootstrap file.
Package bootstrap provides the functionality to initialize certain aspects of an xDS client by reading a bootstrap file.
client/controller
Package controller contains implementation to connect to the control plane.
Package controller contains implementation to connect to the control plane.
client/controller/version
Package version defines APIs to deal with different versions of xDS.
Package version defines APIs to deal with different versions of xDS.
client/controller/version/v2
Package v2 provides xDS v2 transport protocol specific functionality.
Package v2 provides xDS v2 transport protocol specific functionality.
client/controller/version/v3
Package v3 provides xDS v3 transport protocol specific functionality.
Package v3 provides xDS v3 transport protocol specific functionality.
client/load
Package load provides functionality to record and maintain load data.
Package load provides functionality to record and maintain load data.
client/pubsub
Package pubsub implements a utility type to maintain resource watchers and the updates.
Package pubsub implements a utility type to maintain resource watchers and the updates.
client/resource
Package internal contains functions/structs shared by xds balancers/resolvers.
Package internal contains functions/structs shared by xds balancers/resolvers.
client/resource/version
Package version defines constants to distinguish between supported xDS API versions.
Package version defines constants to distinguish between supported xDS API versions.
clusterspecifier
Package clusterspecifier contains the ClusterSpecifier interface and a registry for storing and retrieving their implementations.
Package clusterspecifier contains the ClusterSpecifier interface and a registry for storing and retrieving their implementations.
credentials/certprovider/pemfile
Package pemfile provides a file watching certificate provider plugin implementation which works for files with PEM contents.
Package pemfile provides a file watching certificate provider plugin implementation which works for files with PEM contents.
csds
Package csds implements features to dump the status (xDS responses) the xds_client is using.
Package csds implements features to dump the status (xDS responses) the xds_client is using.
httpfilter
Package httpfilter contains the HTTPFilter interface and a registry for storing and retrieving their implementations.
Package httpfilter contains the HTTPFilter interface and a registry for storing and retrieving their implementations.
httpfilter/fault
Package fault implements the Envoy Fault Injection HTTP filter.
Package fault implements the Envoy Fault Injection HTTP filter.
httpfilter/rbac
Package rbac implements the Envoy RBAC HTTP filter.
Package rbac implements the Envoy RBAC HTTP filter.
httpfilter/router
Package router implements the Envoy Router HTTP filter.
Package router implements the Envoy Router HTTP filter.
internal
Package internal contains gRPC-internal code, to avoid polluting the godoc of the top-level grpc package.
Package internal contains gRPC-internal code, to avoid polluting the godoc of the top-level grpc package.
resolver
Package resolver implements the xds resolver, that does LDS and RDS to find the cluster to use.
Package resolver implements the xds resolver, that does LDS and RDS to find the cluster to use.
server
Package server contains internal server-side functionality used by the public facing xds package.
Package server contains internal server-side functionality used by the public facing xds package.
utils/backoff
Package backoff implement the backoff strategy for gRPC.
Package backoff implement the backoff strategy for gRPC.
utils/balancer/stub
Package stub implements a balancer for testing purposes.
Package stub implements a balancer for testing purposes.
utils/balancergroup
Package balancergroup implements a utility struct to bind multiple balancers into one balancer.
Package balancergroup implements a utility struct to bind multiple balancers into one balancer.
utils/balancerload
* * Copyright 2019 gRPC authors.
* * Copyright 2019 gRPC authors.
utils/buffer
Package buffer provides an implementation of an unbounded buffer.
Package buffer provides an implementation of an unbounded buffer.
utils/credentials/xds
Package xds contains non-user facing functionality of the xds credentials.
Package xds contains non-user facing functionality of the xds credentials.
utils/envconfig
Package envconfig contains grpc settings configured by environment variables.
Package envconfig contains grpc settings configured by environment variables.
utils/grpclog
Package grpclog (internal) defines depth logging for grpc.
Package grpclog (internal) defines depth logging for grpc.
utils/grpcrand
Package grpcrand implements math/rand functions in a concurrent-safe way with a global random source, independent of math/rand's global source.
Package grpcrand implements math/rand functions in a concurrent-safe way with a global random source, independent of math/rand's global source.
utils/grpcsync
Package grpcsync implements additional synchronization primitives built upon the sync package.
Package grpcsync implements additional synchronization primitives built upon the sync package.
utils/grpcutil
Package grpcutil provides utility functions used across the gRPC codebase.
Package grpcutil provides utility functions used across the gRPC codebase.
utils/hierarchy
Package hierarchy contains functions to set and get hierarchy string from addresses.
Package hierarchy contains functions to set and get hierarchy string from addresses.
utils/matcher
Package matcher contains types that need to be shared between code under google.golang.org/grpc/xds/...
Package matcher contains types that need to be shared between code under google.golang.org/grpc/xds/...
utils/pretty
Package pretty defines helper functions to pretty-print structs for logging.
Package pretty defines helper functions to pretty-print structs for logging.
utils/rbac
Package rbac provides service-level and method-level access control for a service.
Package rbac provides service-level and method-level access control for a service.
utils/resolver
Package resolver provides internal resolver-related functionality.
Package resolver provides internal resolver-related functionality.
utils/resolver/passthrough
Package passthrough implements a pass-through resolver.
Package passthrough implements a pass-through resolver.
utils/resolver/unix
Package unix implements a resolver for unix targets.
Package unix implements a resolver for unix targets.
utils/serviceconfig
Package serviceconfig contains utility functions to parse service config.
Package serviceconfig contains utility functions to parse service config.
utils/transport/networktype
Package networktype declares the network type to be used in the default dialer.
Package networktype declares the network type to be used in the default dialer.
utils/wrr
Package wrr contains the interface and common implementations of wrr algorithms.
Package wrr contains the interface and common implementations of wrr algorithms.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL