ingress就是从外部访问k8s集群的入口,将用户的URL请求转发到不同的service上。ingress相当于nginx反向代理服务器,它包括的规则定义就是URL的路由信息;它的实现需要部署Ingress controller(比如 traefik ingress-nginx 等),Ingress controller通过apiserver监听ingress和service的变化,并根据规则配置负载均衡并提供访问入口,达到服务发现的作用。
- 未配置ingress:
集群外部 -> NodePort -> K8S Service
- 配置ingress:
集群外部 -> Ingress -> K8S Service
-
注意:ingress 本身也需要部署
Ingress controller时使用以下几种方式让外部访问- 使用
NodePort方式 - 使用
hostPort方式 - 使用LoadBalancer地址方式
- 使用
-
以下讲解基于
Traefik,如果想要了解ingress-nginx的原理与实践,推荐阅读博客烂泥行天下的相关文章
Traefik 提供了一个简单好用 Ingress controller,下文侧重讲解 ingress部署和测试例子。请查看yaml配置 traefik-ingress.yaml,参考traefik 官方k8s例子
kubectl create -f /etc/ansible/manifests/ingress/traefik/traefik-ingress.yaml- 注意需要配置
RBAC授权 - 注意
trafik pod中80端口为 traefik ingress-controller的服务端口,8080端口为 traefik 的管理WEB界面;为后续配置方便指定80端口暴露NodePort端口为23456(对应于在hosts配置中NODE_PORT_RANGE范围内可用端口)
# kubectl get deploy -n kube-system traefik-ingress-controller
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
traefik-ingress-controller 1 1 1 1 4m
# kubectl get svc -n kube-system traefik-ingress-service
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
traefik-ingress-service NodePort 10.68.69.170 <none> 80:23456/TCP,8080:34815/TCP 4m- 可以看到
traefik-ingress-service服务端口80暴露的nodePort确实为23456
- 首先创建测试用K8S应用,并且该应用服务不用nodePort暴露,而是用ingress方式让外部访问
kubectl run test-hello --image=nginx:alpine --expose --port=80
##
# kubectl get deploy test-hello
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
test-hello 1 1 1 1 56s
# kubectl get svc test-hello
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
test-hello ClusterIP 10.68.124.115 <none> 80/TCP 1m- 然后为这个应用创建 ingress,
kubectl create -f /etc/ansible/manifests/ingress/test-hello.ing.yaml
# test-hello.ing.yaml内容
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
name: test-hello
spec:
rules:
- host: hello.test.com
http:
paths:
- path: /
backend:
serviceName: test-hello
servicePort: 80- 集群内部尝试访问:
curl -H Host:hello.test.com 10.68.69.170(traefik-ingress-service的服务地址)能够看到欢迎页面Welcome to nginx!; - 在集群外部尝试访问(假定集群一个NodeIP为 192.168.1.1):
curl -H Host:hello.test.com 192.168.1.1:23456,也能够看到欢迎页面Welcome to nginx!,说明ingress测试成功
kubectl create -f /etc/ansible/manifests/ingress/traefik/traefik-ui.ing.yaml
# traefik-ui.ing.yaml内容
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
name: traefik-web-ui
namespace: kube-system
spec:
rules:
- host: traefik-ui.test.com
http:
paths:
- path: /
backend:
serviceName: traefik-ingress-service
servicePort: 8080-
在集群外部可以使用
curl -H Host:traefik-ui.test.com 192.168.1.1:23456尝试访问WEB管理页面,返回<a href="/dashboard/">Found</a>.说明 traefik-ui的ingress配置生效了。 -
在客户端主机也可以通过修改本机
hosts文件,如上例子,增加两条记录:
192.168.1.1 hello.test.com
192.168.1.1 traefik-ui.test.com
打开浏览器输入域名 http://hello.test.com:23456 和 http://traefik-ui.test.com:23456 就可以访问k8s的应用服务了。
可选1: 使用LoadBalancer服务类型来暴露ingress,自有环境(非公有云)可以参考metallb文档
# 修改traefik-ingress 使用 LoadBalancer服务
$ sed -i 's/NodePort$/LoadBalancer/g' /etc/ansible/manifests/ingress/traefik/traefik-ingress.yaml
# 创建traefik-ingress
$ kubectl apply -f /etc/ansible/manifests/ingress/traefik/traefik-ingress.yaml
# 验证
$ kubectl get svc --all-namespaces |grep traefik
kube-system traefik-ingress-service LoadBalancer 10.68.163.243 192.168.1.241 80:23456/TCP,8080:37088/TCP 1m这时可以修改客户端本机 hosts文件:(如上例192.168.1.241)
192.168.1.241 hello.test.com
192.168.1.241 traefik-ui.test.com
打开浏览器输入域名 http://hello.test.com 和 http://traefik-ui.test.com可以正常访问。
- 利用 nginx/haproxy 等集群,可以做代理转发以去掉
23456这个端口。如果你的集群根据本项目部署了高可用方案,那么可以利用LB节点haproxy 来做,当然如果生产环境K8S应用已经部署非常多,建议还是使用独立的nginx/haproxy集群。
具体参考配置转发 ingress nodePort,如上配置访问集群MASTER_IP的80端口时,由haproxy代理转发到实际的node节点暴露的nodePort端口上了。这时可以修改客户端本机 hosts文件如下:(假定 MASTER_IP=192.168.1.10)
192.168.1.10 hello.test.com
192.168.1.10 traefik-ui.test.com
打开浏览器输入域名 http://hello.test.com 和 http://traefik-ui.test.com可以正常访问。