Traefik ingress

Traefik 是一款开源的反向代理与负载均衡工具,它监听后端的变化并自动更新服务配置。Traefik 最大的优点是能够与常见的微服务系统直接整合,可以实现自动化动态配置。目前支持 Docker、Swarm,Marathon、Mesos、Kubernetes、Consul、Etcd、Zookeeper、BoltDB 和 Rest API 等后端模型。

Traefik Ingress - 图1

主要功能包括

  • Golang编写,部署容易
  • 快(nginx的85%)
  • 支持众多的后端(Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd等)
  • 内置Web UI、Metrics和Let’s Encrypt支持,管理方便
  • 自动动态配置
  • 集群模式高可用
  • 支持 Proxy Protocol

Ingress简介

简单的说,ingress就是从kubernetes集群外访问集群的入口,将用户的URL请求转发到不同的service上。Ingress相当于nginx、apache等负载均衡反向代理服务器,其中还包括规则定义,即URL的路由信息,路由信息的刷新由 Ingress controller 来提供。

Ingress Controller 实质上可以理解为是个监视器,Ingress Controller 通过不断地跟 kubernetes API 打交道,实时的感知后端 service、pod 等变化,比如新增和减少 pod,service 增加与减少等;当得到这些变化信息后,Ingress Controller 再结合下文的 Ingress 生成配置,然后更新反向代理负载均衡器,并刷新其配置,达到服务发现的作用。

Helm 部署 Traefik

  1. # Setup domain, user and password first.
  2. $ export USER=user
  3. $ export DOMAIN=ingress.feisky.xyz
  4. $ htpasswd -c auth $USER
  5. New password:
  6. Re-type new password:
  7. Adding password for user user
  8. $ PASSWORD=$(cat auth| awk -F: '{print $2}')
  9. # Deploy with helm.
  10. helm install stable/traefik --name --namespace kube-system --set rbac.enabled=true,acme.enabled=true,dashboard.enabled=true,acme.staging=false,acme.email=admin@$DOMAIN,dashboard.domain=ui.$DOMAIN,ssl.enabled=true,acme.challengeType=http-01,dashboard.auth.basic.$USER=$PASSWORD

稍等一会,traefik Pod 就会运行起来:

  1. $ kubectl -n kube-system get pod -l app=traefik
  2. NAME READY STATUS RESTARTS AGE
  3. traefik-65d8dc4489-k97cg 1/1 Running 0 5m
  4. $ kubectl -n kube-system get ingress
  5. NAME HOSTS ADDRESS PORTS AGE
  6. traefik-dashboard ui.ingress.feisky.xyz 80 25m
  7. $ kubectl -n kube-system get svc traefik
  8. NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
  9. traefik LoadBalancer 10.0.206.26 172.20.0.115 80:31662/TCP,443:32618/TCP 24m

通过配置 DNS 解析(CNAME 记录域名到 Ingress Controller 服务的外网IP)、修改 /etc/hosts 添加域名映射(见下述测试部分)或者使用 xip.io (参考 minikube ingress 使用方法)等方法,就可以通过配置的域名直接访问所需服务了。比如上述的 Dashboard 服务可以通过域名 ui.ingress.feisky.xyz 来访问:

kubernetes-dashboard

上图中,左侧黄色部分部分列出的是所有的rule,右侧绿色部分是所有的backend。

Ingress 示例

下面来看一个更复杂的示例。创建名为traefik-ingress的 ingress,文件名traefik.yaml

  1. apiVersion: extensions/v1beta1
  2. kind: Ingress
  3. metadata:
  4. name: traefik-ingress
  5. annotations:
  6. kubernetes.io/ingress.class: traefik
  7. spec:
  8. rules:
  9. - host: traefik.nginx.io
  10. http:
  11. paths:
  12. - path: /
  13. backend:
  14. serviceName: nginx
  15. servicePort: 80
  16. - host: traefik.frontend.io
  17. http:
  18. paths:
  19. - path: /
  20. backend:
  21. serviceName: frontend
  22. servicePort: 80

其中,

  • backend中要配置 default namespace 中启动的 service 名字
  • path就是URL地址后的路径,如traefik.frontend.io/path
  • host 最好使用 service-name.filed1.filed2.domain-name 这种类似主机名称的命名方式,方便区分服务

根据你自己环境中部署的 service 名称和端口自行修改,有新 service 增加时,修改该文件后可以使用kubectl replace -f traefik.yaml来更新。

测试

在集群的任意一个节点上执行。假如现在我要访问nginx的”/“路径。

  1. $ curl -H Host:traefik.nginx.io http://172.20.0.115/
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <title>Welcome to nginx!</title>
  6. <style>
  7. body {
  8. width: 35em;
  9. margin: 0 auto;
  10. font-family: Tahoma, Verdana, Arial, sans-serif;
  11. }
  12. </style>
  13. </head>
  14. <body>
  15. <h1>Welcome to nginx!</h1>
  16. <p>If you see this page, the nginx web server is successfully installed and
  17. working. Further configuration is required.</p>
  18. <p>For online documentation and support please refer to
  19. <a href="http://nginx.org/">nginx.org</a>.<br/>
  20. Commercial support is available at
  21. <a href="http://nginx.com/">nginx.com</a>.</p>
  22. <p><em>Thank you for using nginx.</em></p>
  23. </body>
  24. </html>

如果你需要在 kubernetes 集群以外访问就需要设置 DNS,或者修改本机的hosts文件在其中加入:

  1. 172.20.0.115 traefik.nginx.io
  2. 172.20.0.115 traefik.frontend.io

所有访问这些地址的流量都会发送给 172.20.0.115 这台主机,就是我们启动traefik的主机。Traefik会解析http请求header里的Host参数将流量转发给Ingress配置里的相应service。

traefik-nginx

traefik-guestbook

参考文档