Fabio 是一个 HTTP 和 TCP 反向代理,它使用来自 Consul 的数据进行自我配置 。
传统的负载均衡器和反向代理需要配置一个配置文件。该配置包含代理向上游服务转发的主机名和路径。这个过程可以使用像 consul-template 这样的工具来自动 生成配置文件并触发重新加载。
Fabio 的工作原理是不同的,因为一旦发生变化,无需重新启动或重新加载,Fabio 就直接从存储在 Consul 中的数据更新其路由表。
当你在 Consul 注册一个服务时,你需要添加一个标签来宣布上游服务接受的路径,例如,urlprefix-/user 或者 urlprefix-/order,fabio将完成剩下的工作。
consul 的安装参考 consul 测试。
启动 consul:
- $ consul agent -dev (-dev表示开发模式)
-
屏幕显示一些日志,表示consul安装并启动。验证 consul,需要进入另外一个终端,ssh 登录到刚启动了 consul 的这台机器,执行:
- $ consul members
- $ curl localhost:8500/v1/catalog/nodes (8500是consul的HTTP API端口)
-
会显示当前节点信息。如果上述命令正确执行就表示 consul 已经安装成功。上述命令行和 HTTP API 的功能相同。
设置 golang 路径:
- $ export GOPATH=/go
- $ go get github.com/magiconair/fabio-example
-
要等一会儿到 /go 目录下去看,发现 /go/bin 目录下多了一个 fabio-example 的可执行程序。
- $ ./fabio-example --help
- Usage of ./fabio-example:
- -addr string
- host:port of the service (default "127.0.0.1:5000")
- -name string
- name of the service (default "fabio-example")
- -prefix string
- comma-sep list of host/path prefixes to register
- $ ./fabio-example -name svc-a -prefix /foo
-
调用 consul 的 HTTP API 获取服务 svc-a 的元数据:
- $ curl http://localhost:8500/v1/catalog/service/svc-a
- [
- {
- "Node": "block3",
- "Address": "127.0.0.1",
- "TaggedAddresses": {
- "lan": "127.0.0.1",
- "wan": "127.0.0.1"
- },
- "ServiceID": "svc-a-127.0.0.1:5000",
- "ServiceName": "svc-a",
- "ServiceTags": [
- "urlprefix-/foo"
- ],
- "ServiceAddress": "127.0.0.1",
- "ServicePort": 5000,
- "ServiceEnableTagOverride": false,
- "CreateIndex": 7,
- "ModifyIndex": 8
- }
- ]
-
需要注意的是 svc-a 服务的tag:urlprefix-/foo,这个 tag 符合 fabio 的路由定义约定,会被当作 fabio 的路由定义。安装 fabio 后再测试上述路由定义约定。
安装地址是:https://github.com/eBay/fabio/releases
- $ wget https://github.com/eBay/fabio/releases/download/v1.3.7/fabio-1.3.7-go1.7.4-linux_amd64
- $ chmod +x fabio-1.3.7-go1.7.4-linux_amd64
- $ ln -s fabio-1.3.7-go1.7.4-linux_amd64 /usr/local/bin/fabio
-
用 chmod 将下载的程序修改为可执行,然后在可执行目录 /usr/local/bin 下定义了一个软符号链接 fabio。用默认值启动fabio:
- $ fabio
-
会提示 consul: connection to "localhost:8500" in datacenter "dc1"。这表明 fabio 已经找到了本地的 consul 服务。
consul已经安装在宿主机,并监听了8500端口。运行fabio:
- docker run --net="host" fabiolb/fabio
-
之所以使用docker的host网络模式启动fabio,是因为fabio依赖宿主机的consul服务(端口8500)。
现在consul、fabio-excample、fabio各占了一个终端,现在打开第4个终端,执行:
- $ curl localhost:9999/foo
- Serving /foo from svc-a on 127.0.0.1:5000
-
9999 端口是 fabio 的代理(proxy)端口。fabio 将 9999 端口收到的 /foo 路径下的请求,根据路由策略 (tag:urlprefix-/foo) 发往 127.0.0.1:5000 端口的 svc-a 服务。
在本机的 8080 端口上运行着一个 composer-playground 服务。在该服务上随便找一个URL充当健康检查URL(貌似只要响应状态码是200即可):
- curl localhost:8080/config.json
-
为了将该服务注册到 consul,定义了一个 consul 配置文件 /etc/consul.d/playground.json:
- {
- "service": {
- "name": "playground",
- "tags": [
- "urlprefix-/playground"
- ],
- "address": "localhost",
- "port": 8080,
- "check": {
- "id": "api",
- "name": "playground health check",
- "http": "http://localhost:8080/config.json",
- "method": "GET",
- "interval": "10s",
- "timeout": "2s"
- }
- }
- }
-
注意:向 Fabio 注册的服务必须在 consul 中定义健康检查,而且必须是PASSING状态,否则Fabio会拒绝反向代理该服务。 重启consul代理和Fabio:
- consul agent -dev -config-dir=/etc/consul.d
- fabio
-
测试 Fabio 的反向代理:
- curl localhost:9999/playground
-
如果 Fabio 工作正常,会返回 composer-playground 的首页。