Traefik ingress

    主要功能包括

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

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

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

    部署Traefik

    以下配置文件可以在Traefik GitHub仓库中的找到。

    创建 ingress-rbac.yaml 用于 service account 认证:

    执行下面的命令创建 Traefik 角色绑定

    创建 Traefik Depeloyment

    1. ---
    2. apiVersion: v1
    3. kind: ServiceAccount
    4. metadata:
    5. name: traefik-ingress-controller
    6. namespace: kube-system
    7. ---
    8. kind: Deployment
    9. apiVersion: extensions/v1beta1
    10. metadata:
    11. name: traefik-ingress-controller
    12. namespace: kube-system
    13. labels:
    14. k8s-app: traefik-ingress-lb
    15. spec:
    16. replicas: 1
    17. selector:
    18. matchLabels:
    19. k8s-app: traefik-ingress-lb
    20. template:
    21. metadata:
    22. labels:
    23. k8s-app: traefik-ingress-lb
    24. name: traefik-ingress-lb
    25. spec:
    26. serviceAccountName: traefik-ingress-controller
    27. terminationGracePeriodSeconds: 60
    28. containers:
    29. - image: traefik
    30. name: traefik-ingress-lb
    31. args:
    32. - --web
    33. - --kubernetes
    34. ---
    35. kind: Service
    36. apiVersion: v1
    37. metadata:
    38. name: traefik-ingress-service
    39. spec:
    40. selector:
    41. k8s-app: traefik-ingress-lb
    42. ports:
    43. - protocol: TCP
    44. port: 80
    45. name: web
    46. - protocol: TCP
    47. port: 8080
    48. name: admin
    49. type: NodePort

    执行下面的命令创建 Traefik Deployment:

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

    1. $ kubectl -n kube-system get pod -l k8s-app=traefik-ingress-lb
    2. NAME READY STATUS RESTARTS AGE
    3. traefik-ingress-controller-7fbcc689f5-4bxgg 1/1 Running 0 3m
    4. $ kubectl -n kube-system get svc traefik-ingress-service
    5. NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
    6. traefik-ingress-service NodePort 10.0.73.148 <none> 80:32563/TCP,8080:30206/TCP 3m

    可以看到 Traefik Ingress 服务监听在 32563 (Ingress 入口) 和 30206 (UI)两个 NodePort上面,可以通过 <master-ip>:<nodePort> 来访问它们。

    除了直接创建 Deployment 方法,还可以使用 Helm 便捷部署 Traefik:

    1. $ helm install stable/traefik --name my-release --namespace kube-system
    2. # Watch the service status
    3. $ kubectl get svc my-release-traefik --namespace kube-system -w
    4. # Once EXTERNAL-IP is no longer <pending>, get external IP
    5. $ kubectl describe service my-release-traefik -n kube-system | grep Ingress | awk '{print $3}'

    UI Ingress

    最简单的 Ingress 就是创建一个 Traefik UI 的访问入口:

    1. apiVersion: v1
    2. kind: Service
    3. metadata:
    4. name: traefik-web-ui
    5. namespace: kube-system
    6. spec:
    7. selector:
    8. k8s-app: traefik-ingress-lb
    9. ports:
    10. - port: 80
    11. targetPort: 8080
    12. ---
    13. apiVersion: extensions/v1beta1
    14. kind: Ingress
    15. metadata:
    16. name: traefik-web-ui
    17. namespace: kube-system
    18. annotations:
    19. kubernetes.io/ingress.class: traefik
    20. spec:
    21. rules:
    22. - host: traefik-ui.minikube
    23. http:
    24. paths:
    25. - backend:
    26. serviceName: traefik-web-ui
    27. servicePort: 80

    配置完成后就可以创建 UI ingress:

    前面看到 Ingress Controller 服务监听在 32563 端口,可以通过下面的方式访问

    1. <a href="/dashboard/">Found</a>.

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

    kubernetes-dashboard

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

    1. kind: Ingress
    2. metadata:
    3. name: traefik-ingress
    4. spec:
    5. rules:
    6. - host: traefik.nginx.io
    7. http:
    8. paths:
    9. - path: /
    10. backend:
    11. serviceName: nginx
    12. servicePort: 80
    13. - host: traefik.frontend.io
    14. http:
    15. paths:
    16. - path: /
    17. backend:
    18. serviceName: frontend
    19. 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文件。

    在其中加入:

    所有访问这些地址的流量都会发送给172.20.0.115这台主机,就是我们启动traefik的主机。

    Traefik会解析http请求header里的Host参数将流量转发给Ingress配置里的相应service。

    修改hosts后就就可以在kubernetes集群外访问以上两个service,如下图: