Merge pull request #102 from xiaoliu10/dispose_old_configuration_mode

compatible old configuration mode

Former-commit-id: 1750d33cc6801c6ddf638388a8197ecff9399aa1 [formerly 9233d08d8c9f04fae972fe755de0138f059713d5 [formerly 32395f0064fc5a6c39718a832d7d97ad31a39c21]]
Former-commit-id: 48fcadaad37ea097301edfb2b3ce17de256c2fa4 [formerly 9233d08d8c9f04fae972fe755de0138f059713d5]
Former-commit-id: 00f8d0c3a6d58bff536ad0fcbab6d3e691aaa31a [formerly b5b72a413fbf4b08bb1e7f9cb764d4349931e4e6]
Former-commit-id: 4899a9ba2a26af8f5171ea9d41cb2d3c378d85da
tree: 26bc91175c610d00e2fa508e0144f180cca72107
  1. .github/
  2. cmd/
  3. configs/
  4. docs/
  5. pkg/
  6. samples/
  7. .gitignore
  8. .travis.yml
  9. before_ut.sh
  10. before_validate_license.sh
  11. go.mod
  12. go.sum
  13. LICENSE
  14. Makefile
  15. README.md
  16. README_CN.md
  17. start.sh
README.md

Build Status

中文

Introduction

dubbo-go-proxy is a gateway that mainly focuses on providing gateway solution to your Dubbo and RESTful services.

It supports HTTP-to-Dubbo and HTTP-to-HTTP proxy and more protocols will be supported in the near future.

Get Start

Start proxy

  1. Build the binary with make build
  2. Start the proxy with make start

Quick Guide

dubbo-go-proxy supports to invoke 2 protocols:

  1. Http
  2. Dubbo

Features

  1. You can customize your own dubbo-go-proxy with plugin.
  2. Multiple default filters to manage your APIs.
  3. Dubbo and HTTP proxies.
  4. Customizable request parameters mapping.
  5. Automatically recognizes RPC services from service registration center and exposes it in HTTP protocol.
  6. Sidecar or centralized deployment(Planning)
  7. Dubbo protocol's rate-limiting in Istio environment(Planning)

Architecture Diagram

image

Flow Diagram

image

Teams

Components

Proxy

Data panel

Admin

Control Panel

Concepts

Downstream

Downstream is the requester who sends request to and expecting the response from dubbo-go-proxy. (Eg.Postman client, Browser)

Upstream

The service that receive requests and send responses to dubbo-go-proxy. (Eg. Dubbo server)

Listener

The way that the dubbo-go-proxy exposes services to upstream clients. It could be configured to multiple listeners for one dubbo-go-proxy.

Cluster

Cluster is a set of upstream services that logically similar, such as dubbo cluster. Proxy can identifies the cluster members through service discovery and proactively probes their healthiness so that the proxy can route the requests to proper cluster member base on load balancing strategies.

Api

API is the core concept of the dubbo-go-proxy, all the upstream services will be configured and exposed through API.

Client

The actual caller of the upstream services.

Router

Router routes the HTTP request to proper upstream services according to the API configs.

Context

The context of a request in dubbo-go-proxy includes almost all information to get response from upstream services. It will be used in almost all process in the dubbo-go-proxy, especially the filter chain.

Filter

Filter manipulate the incoming requests. It is extensible for the users.

Contact Us

The project is under intensively iteration, you are more than welcome to use, suggest and contribute codes. DingDing Group: 31363295

License

Apache License, Version 2.0