Trafik源代码阅读

Thu, May 26, 2016

Trafik介绍

其官网是这么介绍的：

Træfɪk is a modern HTTP reverse proxy and load balancer made to deploy microservices with ease. 
It supports several backends (Docker, Swarm, Mesos/Marathon, Consul, Etcd, Zookeeper, BoltDB, Rest API, file...) 
to manage its configuration automatically and dynamically.

翻译过来就是：Træfɪk是一个现代的HTTP反向代理和易用的微服务负载平衡器，支持多种后端服务，例如 Docker、 Swarm、 Mesos/Marathon、 Kubernetes、 Consul、 Etcd、 Zookeeper、 BoltDB、 Rest API、文件等等，可以自动地动态管理和加载各种配置。

特点如下：

快速，benchmark显示，能够达到nginx的85%的性能
没有依赖地狱，得益于Golang的特性，单个二进制文件就能运行
Rest API
监视后端，能够自动监听后端配置的变化。
配置的热重加载，无需重新启动进程或服务器
优雅地关闭Http连接
后端的断路器Circuit breaker
Round Robin rebalancer 负载平衡
Rest测量
包括小的官方docker
SSL后端支持
SSL前端支持
干净的AngularJS Web UI
支持Websocket
支持Http/2
如果网络错误重试请求
自动Https支持(Let’s Encrypt)

用法

最简单的用法当然是做一个HTTP反向代理用。

假设我们有一个HTTP服务 http://10.16.28.17:8091/echo, 我们用Trafik做为反向代理的配置 trafik.toml 如下：

logLevel = "DEBUG"

defaultEntryPoints = ["http"]

[entryPoints]
  [entryPoints.http]
  address = ":8080"

[file]
  [backends]
    [backends.httpecho]
      [backends.httpecho.servers.server1]
        url = "http://10.16.28.17:8091"
        weight = 1
  [frontends]
    [frontends.fe1]
    backend = "httpecho"
      [frontends.fe1.routes.rule1]
      rule = "Path:/echo"

参考Trafik官方文档说明，我们这个配置解释如下：

将Trafik的日志级别 logLevel 定义为 DEBUG
默认的接入点 defaultEntryPoints 定义为 http，并且其端口为 8080
然后在 [file] 段定义 backends 和 frontends，也就是Trafik的路由转发规则
backends段定义了一个后端服务，URL地址和权重都设置好了。
frontends段定义转发规则，即将URL路径为 /echo 的请求转发到合适的 backend 上。
然后我们可以用 curl 来测试转发是否正常： curl http://localhost:8080/echo -d xxxxxx

源码阅读

源码编译

按照官方文档的说明即可编译出来。其中几个需要的地方：

提前下载好 go-bindata 的源码并编译出二进制出来安装的 $PATH 路径下
提前下载好 glide 的源码并编译出二进制出来安装的 $PATH 路径下
如果在windows下编译的话，trafik依赖的一个 github.com/mailgun/log 库支持unix系统，需要做一下修改。将NewSysLogger函数修改如下：

func NewSysLogger(conf Config) (Logger, error) {
	debugW := os.Stdout
	infoW := os.Stdout
	warnW := os.Stdout
	errorW := os.Stdout

	sev, err := SeverityFromString(conf.Severity)
	if err != nil {
		return nil, err
	}

	return &sysLogger{sev, debugW, infoW, warnW, errorW}, nil
}

HTTP多路分发器：mux

github.com/gorilla/mux 是一个HTTP多路分发器，其原理也比较简单，就是实现了Golang标准库中的 net.http.Handler 接口，即如下：

type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

当mux注册到HTTP服务之后，所有的HTTP请求就会由标准库 net/http 转发到mux库中的 func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request) 函数中， mux.Router.ServeHTTP这个函数再进行自己的路由规则匹配和转发。

Trafik使用 github.com/gorilla/mux 库做路由转发。