新手入门 - 《Traefik 中文文档手册》

概览
快速上手
获取
- 二进制文件
- Docker
测试

Træfɪk 是一个为了让部署微服务更加便捷而诞生的现代HTTP反向代理、负载均衡工具。它支持多种后台 (Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd, Zookeeper, BoltDB, Rest API, file…) 来自动化、动态的应用它的配置文件设置。

概览

假设你已经在你的基础设施上部署了一堆微服务。你可能使用了一个服务发现系统（例如 etcd 或 consul）或者一个资源管理框架（swarm，Mesos/Marathon）来管理所有这些服务。如果你想让你的用户去从互联网访问你的某些微服务，你就必需使用虚拟hosts或前缀路径来配置一个反向代理：

域名 api.domain.com 将指向你的私有网络中的微服务 api
路径 domain.com/web 将指向你的私有网络中的微服务 web
域名 backoffice.domain.com 将指向你的私有网络中的微服务 backoffice ，在你的多台实例之间负载均衡
但一个微服务的结构时动态的。。。服务在会经常被添加、移除、杀死或更新，可能一天之内就会发生许多次。

传统的反向代理原生不支持动态配置。你不可能轻易的通过热更新更改它们的配置。

这时，Træfɪk就诞生了。

Træfɪk 可以监听你的服务发现、管理API，并且每当你的微服务被添加、移除、杀死或更新都会被感知，并且可以自动生成它们的配置文件。指向到你服务的路由将会被直接创建出来。

运行它并忘记它吧！

快速上手

你可以通过这个 Katacoda 教程快速感受Traefik是如何在多个Docker容器间负载均衡的。

这里有一个 Ed Robinson 在 ContainerCamp UK 会议中的演讲。你将从中发现 Træfɪk 的基本特性并看到更多Træfɪk与Kubernetes的示例。

这里有一个 Emile Vauge 在法国 Devoxx France 2016 会议中的演讲。你将从中发现 Træfɪk 的基本特性并看到更多Træfɪk与Docker， Mesos/Marathon 和 Let’s Encrypt的示例。

获取

二进制文件

从版本下载页面下载最新的可执行文件并以这个示例配置文件运行：

./traefik -c traefik.toml

Docker

通过Docker镜像：

docker run -d -p 8080:8080 -p 80:80 -v $PWD/traefik.toml:/etc/traefik/traefik.toml traefik

测试

你可以简单的通过Docker compose测试 Træfɪk, 将这个 docker-compose.yml 文件放在名称叫做 traefik的目录下：

version: '2'
services:
  proxy:
    image: traefik
    command: --web --docker --docker.domain=docker.localhost --logLevel=DEBUG
    networks:
      - webgateway
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /dev/null:/traefik.toml
networks:
  webgateway:
    driver: bridge

在名称叫做 traefik 的目录下运行：

docker-compose up -d

在浏览器中你可以打开 http://localhost:8080 来访问 Træfɪk 的控制后台来发现下面的魔法。

现在, 创建一个名称为test 的目录，并在目录中使用以下内容创建一个 docker-compose.yml 文件：

version: '2'
services:
  whoami:
    image: emilevauge/whoami
    networks:
      - web
    labels:
      - "traefik.backend=whoami"
      - "traefik.frontend.rule=Host:whoami.docker.localhost"
networks:
  web:
    external:
      name: traefik_webgateway

然后, 在 test 目录下按顺序执行以下命令：

docker-compose up -d
docker-compose scale whoami=2

最后, 测试 test_whoami_1 和 test_whoami_2这两个服务之间的负载均衡：

$ curl -H Host:whoami.docker.localhost http://127.0.0.1
Hostname: ef194d07634a
IP: 127.0.0.1
IP: ::1
IP: 172.17.0.4
IP: fe80::42:acff:fe11:4
GET / HTTP/1.1
Host: 172.17.0.4:80
User-Agent: curl/7.35.0
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 172.17.0.1
X-Forwarded-Host: 172.17.0.4:80
X-Forwarded-Proto: http
X-Forwarded-Server: dbb60406010d
$ curl -H Host:whoami.docker.localhost http://127.0.0.1
Hostname: 6c3c5df0c79a
IP: 127.0.0.1
IP: ::1
IP: 172.17.0.3
IP: fe80::42:acff:fe11:3
GET / HTTP/1.1
Host: 172.17.0.3:80
User-Agent: curl/7.35.0
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 172.17.0.1
X-Forwarded-Host: 172.17.0.3:80
X-Forwarded-Proto: http
X-Forwarded-Server: dbb60406010d