kubernetes对外服务之Ingress

---

一、Ingress 简介

service的作用体现在两个方面:
1、对集群内部，它不断跟踪pod的变化，更新endpoint中对应pod的对象，提供了ip不断变化的pod的服务发现机制。
2、对集群外部，他类似负载均衡器，可以在集群内外部对pod进行访问。

在Kubernetes中，Pod的IP地址和service的ClusterIP仅可以在集群网络内部使用，对于集群外的应用是不可见的。为了使外部的应用能够访问集群内的服务，Kubernetes目前提供了以下几种方案：

●NodePort：将service暴露在节点网络上，NodePort背后就是Kube-Proxy，Kube-Proxy是沟通service网络、Pod网络和节点网络的桥梁。
测试环境使用还行，当有几十上百的服务在集群中运行时，NodePort的端口管理就是个灾难。因为每个端口只能是一种服务，默认端口范围只能是 30000-32767。

●LoadBalancer：通过设置LoadBalancer映射到云服务商提供的LoadBalancer地址。这种用法仅用于在公有云服务提供商的云平台上设置 Service 的场景。 受限于云平台，且通常在云平台部署LoadBalancer还需要额外的费用。
在service提交后，Kubernetes就会调用CloudProvider在公有云上为你创建一个负载均衡服务，并且把被代理的Pod的IP地址配置给负载均衡服务做后端。

●externalIPs：service允许为其分配外部IP，如果外部IP路由到集群中一个或多个Node上，Service会被暴露给这些externalIPs。通过外部IP进入到集群的流量，将会被路由到Service的Endpoint上。

●Ingress：只需一个或者少量的公网IP和LB，即可同时将多个HTTP服务暴露到外网，七层反向代理。
可以简单理解为service的service，它其实就是一组基于域名和URL路径，把用户的请求转发到一个或多个service的规则。

二、Ingress 组成

●ingress：
ingress是一个API对象，通过yaml文件来配置，ingress对象的作用是定义请求如何转发到service的规则，可以理解为配置模板。
ingress通过http或https暴露集群内部service，给service提供外部URL、负载均衡、SSL/TLS能力以及基于域名的反向代理。ingress要依靠 ingress-controller 来具体实现以上功能。

●ingress-controller：
ingress-controller是具体实现反向代理及负载均衡的程序，对ingress定义的规则进行解析，根据配置的规则来实现请求转发。

ingress-controller并不是k8s自带的组件，实际上ingress-controller只是一个统称，用户可以选择不同的ingress-controller实现，目前，由k8s维护的ingress-controller只有google云的GCE与ingress-nginx两个，其他还有很多第三方维护的ingress-controller，具体可以参考官方文档。但是不管哪一种ingress-controller，实现的机制都大同小异，只是在具体配置上有差异。

一般来说，ingress-controller的形式都是一个pod，里面跑着daemon程序和反向代理程序。daemon负责不断监控集群的变化，根据 ingress对象生成配置并应用新配置到反向代理，比如ingress-nginx就是动态生成nginx配置，动态更新upstream，并在需要的时候reload程序应用新配置。为了方便，后面的例子都以k8s官方维护的ingress-nginx为例。

Ingress-Nginx github 地址：https://github.com/kubernetes/ingress-nginx
Ingress-Nginx 官方网站：https://kubernetes.github.io/ingress-nginx/

总结：ingress-controller才是负责具体转发的组件，通过各种方式将它暴露在集群入口，外部对集群的请求流量会先到 ingress-controller， 而ingress对象是用来告诉ingress-controller该如何转发请求，比如哪些域名、哪些URL要转发到哪些service等等。

三、Ingress 工作原理

用户通过访问域名发送HTTP请求，这域名发送过来的过程要用DNS进行解析，才能找到访问入口（通常指负载均衡器），负载均衡器会帮忙把请求负载转发到Node节点上。

在Node节点上，就会使用Ingress处理服务请求，一种是 HostNetwork模式，也就是ingress-controller的控制器Pod与宿主机是共享命名空间的，将请求转发给Node节点就相当于转发到ingress上，根据ingress配置规则（通过域名或URL）把请求转发到业务Pod的Service上，再通过Service转发到端点下的业务Pod上。

如果用的是 NodePort 模式 的service，用户的请求通过负载均衡器转发到指定的 NodePort service 端口，通过 NodePort service 转发到 ingress-controller， ingress-controller根据 ingress资源配置的规则转发用户请求到指定的Service，再通过Service转发给端点中的业务Pod。

四、部署 nginx-ingress-controller

1、部署ingress-controller Pod及相关资源

mkdir /opt/ingress
cd /opt/ingress

官方下载地址：

wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.3.0/deploy/static/provider/cloud/deploy.yaml

上面可能无法下载，可用国内的 gitee

wget https://gitee.com/mirrors/ingress-nginx/raw/controller-v1.3.0/deploy/static/provider/cloud/deploy.yaml

五、Ingress 暴露服务的方式

●方式一：DaemonSet+HostNetwork+nodeSelector
用DaemonSet结合nodeselector来部署ingress-controller到特定的node上，然后使用HostNetwork直接把该pod与宿主机node的网络打通，直接使用宿主机的80/433端口就能访问服务。这时，ingress-controller所在的node机器就很类似传统架构的边缘节点，比如机房入口的nginx服务器。该方式整个请求链路最简单，性能相对NodePort模式更好。缺点是由于直接利用宿主机节点的网络和端口，一个node只能部署一个ingress-controller pod。 比较适合大并发的生产环境使用。

●方式二：Deployment+NodePort模式的Service
同样用deployment模式部署ingress-controller，并创建对应的service，但是type为NodePort。这样，ingress就会暴露在集群节点ip的特定端口上。由于nodeport暴露的端口是随机端口，一般会在前面再搭建一套负载均衡器来转发请求。该方式一般用于宿主机是相对固定的环境ip地址不变的场景。
NodePort方式暴露ingress虽然简单方便，但是NodePort多了一层NAT，在请求量级很大时可能对性能会有一定影响。

●方式三：Deployment+LoadBalancer 模式的 Service
如果要把ingress部署在公有云，那用这种方式比较合适。用Deployment部署ingress-controller，创建一个 type为 LoadBalancer 的 service 关联这组 pod。 大部分公有云，都会为 LoadBalancer 的 service 自动创建一个负载均衡器，通常还绑定了公网地址。只要把域名解析指向该地址，就实现了集群服务的对外暴露

5.1 方式一 DaemonSet+HostNetwork+nodeSelector

vim deploy.yaml 
...
apiVersion: apps/v1
# 修改 kind
#kind: Deployment
kind: DaemonSet
......
spec:
  ......
  template:
    ......
    spec:
      # 使用宿主机网络
      hostNetwork: true
      # 修改选择节点选择器
      nodeSelector:
        ingress: "true"
......

//修改镜像地址
image: registry.cn-hangzhou.aliyuncs.com/google_containers/nginx-ingress-controller:v1.3.0@sha256:d1707ca76d3b044ab8a28277a2466a02100ee9f58a86af1535a3edf9323ea1b5

image: registry.cn-hangzhou.aliyuncs.com/google_containers/kube-webhook-certgen:v1.1.1@sha256:64d8c73dca984af206adf9d6d7e46aa550362b1d7a01f3a0a91b20cc67868660

//给node02节点打上标签
kubectl label nodes node02 app=ingress
kubectl get nodes --show-labels

//启动 nginx-ingress-controller,如没拉取到可以试试重启集群
kubectl apply -f  deploy.yaml
kubectl get pods -n ingress-nginx -owide
kubectl get svc -n ingress-nginx

由于配置了 hostnetwork，nginx 已经在 node 主机本地监听 80/443/8181 端口。其中 8181 是 nginx-controller 默认配置的一个 default backend（Ingress 资源没有匹配的 rule 对象时，流量就会被导向这个 default backend）。
这样，只要访问 node 主机有公网 IP，就可以直接映射域名来对外网暴露服务了。如果要 nginx 高可用的话，可以在多个 node 上部署，并在前面再搭建一套 LVS+keepalived 做负载均衡。

//测试
kubectl create deployment myapp-test --image=soscscs/myapp:v1 --port=80 --replicas=2
kubectl get pods -owide

kubectl exec -it myapp-test-58d56846cd-xlzlq sh
cd /usr/share/nginx/html/
echo 'this is test001' >> index.html 
exit
kubectl exec -it myapp-test-58d56846cd-mk4lk sh
cd /usr/share/nginx/html/
echo 'this is test002' >> index.html
exit

//集群内部实现负载均衡
kubectl expose deployment myapp-test --name svc-test --port=80 --target-port=80

kubectl get svc

//集群外部访问
kubectl get ingressclasses   //查看ingress控制器类型
kubectl create ingress ingress-test --rule=www.test.com/=svc-test:80 --dry-run=client -o yaml > /root/ingress/ingress-demo.yaml  
vim ingress-demo.yaml
kubectl apply -f ingress-demo.yaml
kubectl get ingress

host 主机名可以是精确匹配，或者使用通配符来匹配，但通配符仅覆盖一个 DNS 标签

pathType 支持的路径类型有三种：
● Exact：精确匹配 URL 路径，且区分大小写。

● Prefix：基于以 / 分隔的 URL 路径前缀匹配。匹配区分大小写。如果路径的最后一个元素是请求路径中最后一个元素的子字符串，则不会匹配 （例如：/foo/bar 匹配 /foo/bar/baz, 但不匹配 /foo/barbaz）。

● ImplementationSpecific：对于这种路径类型，匹配方法取决于 IngressClass。具体实现可以将其作为单独的 pathType 处理或者与 Prefix 或 Exact 类型作相同处理。
具体可详见：https://kubernetes.io/zh-cn/docs/concepts/services-networking/ingress/#the-ingress-resource

本地打开hosts文件

选择ingress控制器部署所在node节点IP 设置域名解析，再通过浏览器访问成功

这里的service还是ClusterIP的类型，之所以可以在集群外部访问到，因为访问的是ingress,请求是通过域名 www.test.com 发送给 192.168.154.12 里ingress的端口号，通过 hostnetwork模式 使ingress的端口号接受请求，再根据ingress的规则转发到 svc-test:80 的两个端点上。

5.2 方式二 Deployment+NodePort模式的Service （不同域名实现代理转发）

vim deploy.yaml
kubectl apply -f deploy.yaml
kubectl get all -n ingress-nginx

kubectl create deployment myapp-demo --image=soscscs/myapp:v2 --port=80 --replicas=2
kubectl get pods -owide
kubectl exec -it myapp-demo-67599b76d4-4bwk8 sh
cd /usr/share/nginx/html/
echo 'this is demo1' >> index.html 
exit
kubectl exec -it myapp-demo-67599b76d4-7fr4n sh
cd /usr/share/nginx/html/
echo 'this is demo2' >> index.html 
exit

kubectl expose deployment myapp-demo --name svc-demo --port 8080 --target-port 80
kubectl get svc
curl 10.108.24.124:8080

vim ingress-demo.yaml 
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-test
  namespace: default
spec:
  ingressClassName: nginx
  rules:
  - host: www.bennet.com
    http:
      paths:
      - backend:
          service:
            name: svc-test
            port:
              number: 80
        path: /
        pathType: Prefix
  - host: www.accp.com
    http:
      paths:
      - backend:
          service:
            name: svc-demo
            port:
              number: 8080
        path: /
        pathType: Prefix

kubectl apply -f ingress-demo.yaml
kubectl get ingress

这里基于ingress实现了不同域名的虚拟主机应用

5.3 方式三 基于不同的URL路径转发至Service实现访问

kubectl get pods
kubectl exec -it myapp-demo-67599b76d4-4bwk8 sh
cd /usr/share/nginx/html/
mkdir demo
echo 'hello,this is demo01' >> demo/test.html
exit
kubectl exec -it myapp-demo-67599b76d4-7fr4n sh
cd /usr/share/nginx/html/
mkdir demo
echo 'hello,this is demo02' >> demo/test.html
exit
kubectl exec -it myapp-test-58d56846cd-mk4lk sh
cd /usr/share/nginx/html/
mkdir test
echo 'hello,this is test01' >> test/test.html
exit
kubectl exec -it myapp-test-58d56846cd-xlzlq sh
cd /usr/share/nginx/html/
mkdir test
echo 'hello,this is test02' >> test/test.html
exit

cd /opt/.ingress
cp ingress-demo.yaml ingress-demo1.yaml 
vim ingress-demo1.yaml 
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-demo
  namespace: default
spec:
  ingressClassName: nginx
  rules:
  - host: www.bennet.com
    http:
      paths:
      - backend:
          service:
            name: svc-test
            port:
              number: 80
        path: /test
        pathType: Prefix
      - backend:
          service:
            name: svc-demo
            port:
              number: 8080
        path: /demo
        pathType: Prefix

kubectl apply -f ingress-demo1.yaml 
kubectl get ingress
kubectl get svc -n ingress-nginx

六、Ingress HTTPS 代理访问

mkdir -p /opt/ingress-nodeport/https
cd /opt/ingress-nodeport/https
#创建ssl证书
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout tls.key -out tls.crt -subj "/CN=nginxsvc/O=nginxsvc"

#创建 secret 资源进行存储
kubectl create secret tls tls-secret 

kubectl get secret

cd /opt/ingress
vim ingress-demo2.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-demo2
  namespace: default
spec:
  ingressClassName: nginx
  tls:
  - hosts:
    - www.bennet.com
    secretName: tls-secret
  rules:
  - host: www.bennet.com
    http:
      paths:
      - backend:
          service:
            name: svc-demo
            port:
              number: 8080
        path: /
        pathType: Prefix

kubectl apply -f ingress-demo2.yaml
kubectl get svc -n ingress-nginx

七、Nginx 进行 BasicAuth 网页身份认证

此示例显示了如何使用包含使用htpasswd生成的文件的密码在入口规则中添加身份验证。重要的是生成的文件被命名为auth(实际上——这个秘密有一个密钥data.auth ),否则入口控制器返回503。

mkdir /opt/ingress-nodeport/basic-auth
cd　/opt/ingress-nodeport/basic-auth

//生成用户密码认证文件，创建 secret 资源进行存储
yum -y install httpd-tools
htpasswd -c auth zhangsan			#认证文件名必须为 auth
htpasswd auth lisi
kubectl create secret generic basic-auth --from-file=auth
kubectl get secrets

//创建 ingress 资源
vim ingress-auth.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-test
  namespace: default
  annotations:
    #设置认证类型basic
    nginx.ingress.kubernetes.io/auth-type: basic
	#设置secret资源名称basic-auth
    nginx.ingress.kubernetes.io/auth-secret: basic-auth
	#设置认证窗口提示信息
    nginx.ingress.kubernetes.io/auth-realm: 'Authentication Required - everyone'
spec:
  ingressClassName: nginx
  rules:
  - host: www.accp.com
    http:
      paths:
      - backend:
          service:
            name: svc-test
            port:
              number: 80
        path: /
        pathType: Prefix
        
kubectl apply -f ingress-auth.yaml
kubectl get svc -n ingress-nginx

八、基于 Nginx 重写访问路径

metadata.annotations 配置说明
● nginx.ingress.kubernetes.io/rewrite-target: <字符串> #必须重定向流量的目标URI
● nginx.ingress.kubernetes.io/ssl-redirect: <布尔值> #指示位置部分是否仅可访问SSL(当Ingress包含证书时，默认为true)
● nginx.ingress.kubernetes.io/force-ssl-redirect: <布尔值> #即使Ingress未启用TLS，也强制重定向到HTTPS
● nginx.ingress.kubernetes.io/app-root: <字符串> #定义Controller必须重定向的应用程序根，如果它在’/'上下文中
● nginx.ingress.kubernetes.io/use-regex: <布尔值> #指示Ingress上定义的路径是否使用正则表达式

vim ingress-rewrite.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-rewrite
  namespace: default
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: http://www.accp.com:32525/test/test.html
spec:
  ingressClassName: nginx
  tls:
  - hosts:
    - www.bennet.com
    secretName: tls-secret
  rules:
  - host: www.bennet.com
    http:
      paths:
      - backend:
          service:
            name: svc-demo
            port:
              number: 8080
        path: /
        pathType: Prefix

kubectl apply -f ingress-rewrite.yaml 
kubectl get ingress
kubectl get svc -n ingress-nginx

九、总结

• ingress是k8s集群的请求入口，可以理解为对多个service的再次抽象
• 通常说的ingress一般包括ingress资源对象及ingress-controller两部分组成
• ingress-controller有多种实现，社区原生的是ingress-nginx，根据具体需求选择
• ingress自身的暴露有多种方式，需要根据基础环境及业务类型选择合适的方式