k8s 对外服务之 Ingress

王zk0526

已于 2024-06-05 08:26:44 修改

阅读量974

点赞数 31

文章标签： kubernetes 容器云原生

于 2024-06-04 18:46:09 首次发布

本文链接：https://blog.csdn.net/fhjtg/article/details/139415280

版权

一、Ingress 相关知识

1.1 Ingress的简介

service的作用体现在两个方面：

对集群内部，它不断跟踪 pod 的变化，更新endpoint中对应pod的对象，提供了ip不断变化的pod的服务发现机制；
对集群外部，他类似负载均衡器，可以在集群内外部对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地址配置给负载均衡服务做后端。

LB 云端的负载均衡器

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

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

1.2 Ingress 组成

●ingress： nginx配置文件
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:Ingress-NGINX Controller for Kubernetes - GitCode
Ingress-Nginx 官方网站：Welcome - Ingress-Nginx Controller

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

1.3 Ingress-Nginx 的工作原理

（1）ingress-controller通过和 kubernetes APIServer 交互，动态的去感知集群中ingress规则变化，
（2）然后读取它，按照自定义的规则，规则就是写明了哪个域名对应哪个service，生成一段nginx配置，
（3）再写到nginx-ingress-controller的pod里，这个ingress-controller的pod里运行着一个Nginx服务，控制器会把生成的 nginx配置写入 /etc/nginx.conf文件中，
（4）然后reload一下使配置生效。以此达到域名区分配置和动态更新的作用。

1.4 新生代Ingress-controller （Traefik）

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

Ingress-nginx和Ingress-Traefik的简单对比
ingress-nginx

使用nginx作为前端负载均衡，通过ingress controller不断的和kubernetes api交互，实时获取后端service，pod等的变化，然后动态更新nginx配置，并刷新使配置生效，达到服务发现的目的。

Ingress-traefik:

traefik本身设计的就能够实时跟kubernetes api交互，感知后端service，pod等的变化，自动更新配置并重载。相对来说traefik更快速方便，同时支持更多的特性，使反向代理，负载均衡更直接更便捷。（GO语言编写的，原生支持K8S等云原生应用，兼容性更好，但并发能力是 ingress-nginx 的6成）

1.5 Ingress 的暴露方式

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

●方式二：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，在请求量级很大时可能对性能会有一定影响。

以下是实验的结果图：

客户端 --->域名访问:NodePort --->ingress-service ---> ingress controller（pod） ---> 业务应用service --->业务的应用 pod
          域名可以解析成nodeportIP 或者 负载均衡VIP

二、部署DaemonSet+HostNetwork暴露Ingress

方式二：DaemonSet+HostNetwork+nodeSelector

2.1 部署nginx-Ingress-controller

(1) 部署ingress-controller pod及相关资源

mkdir /opt/ingress
cd /opt/ingress

官方下载地址：
wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.25.0/deploy/static/mandatory.yaml

上面可能无法下载，可用国内的 gitee
wget https://gitee.com/mirrors/ingress-nginx/raw/nginx-0.25.0/deploy/static/mandatory.yaml
wget https://gitee.com/mirrors/ingress-nginx/raw/nginx-0.30.0/deploy/static/mandatory.yaml


#mandatory.yaml文件中包含了很多资源的创建，包括namespace、ConfigMap、role，ServiceAccount等等所有部署ingress-controller需要的资源。

(2) 如果采用nginx-0.25.0版本，需要了解的官方变动更新

如果下载0.25版本需要修改以下内容

vim mandatory.yaml
......
apiVersion: rbac.authorization.k8s.io/v1beta1
#RBAC相关资源从1.17版本开始改用rbac.authorization.k8s.io/v1，rbac.authorization.k8s.io/v1beta1在1.22版本即将弃用
kind: ClusterRole
metadata:
  name: nginx-ingress-clusterrole
  labels:
    app.kubernetes.io/name: ingress-nginx
    app.kubernetes.io/part-of: ingress-nginx
rules:
  - apiGroups:
      - ""
    resources:
      - configmaps
      - endpoints
      - nodes
      - pods
      - secrets
    verbs:
      - list
      - watch
  - apiGroups:
      - ""
    resources:
      - nodes
    verbs:
      - get
  - apiGroups:
      - ""
    resources:
      - services
    verbs:
      - get
      - list
      - watch
  - apiGroups:
      - "extensions"
      - "networking.k8s.io"    # （0.25版本）增加 networking.k8s.io Ingress 资源的 api 
    resources:
      - ingresses
    verbs:
      - get
      - list
      - watch
  - apiGroups:
      - ""
    resources:
      - events
    verbs:
      - create
      - patch
  - apiGroups:
      - "extensions"
      - "networking.k8s.io"   # （0.25版本）增加 networking.k8s.io/v1 Ingress 资源的 api 
    resources:
      - ingresses/status
    verbs:
      - update

2.2 DaemonSet+HostNetwork+nodeSelector 具体的部署过程

步骤一：下载安放ingress-controller pod及相关资源

mkdir /opt/ingress
cd /opt/ingress

#如果为了方便，我们可直接采用nginx-0.30.0的版本.如果是nginx-0.25.0，可以按照上面的方式进行修改
wget https://gitee.com/mirrors/ingress-nginx/raw/nginx-0.30.0/deploy/static/mandatory.yaml

步骤二：为node02节点添加标签

这一步的做法是因为 DaemonSet控制器配置时，会为每个node节点部署一个pod节点，这里我只想做一个ingress-controller

指定 nginx-ingress-controller 运行在 node02 节点
kubectl label node node02 ingress=true

kubectl get nodes --show-labels



修改 Deployment 为 DaemonSet ，指定节点运行，并开启 hostNetwork 网络

vim mandatory.yaml
...
apiVersion: apps/v1
# 修改 kind
# kind: Deployment
kind: DaemonSet
metadata:
  name: nginx-ingress-controller
  namespace: ingress-nginx
  labels:
    app.kubernetes.io/name: ingress-nginx
    app.kubernetes.io/part-of: ingress-nginx
spec:
# 删除Replicas
# replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: ingress-nginx
      app.kubernetes.io/part-of: ingress-nginx
  template:
    metadata:
      labels:
        app.kubernetes.io/name: ingress-nginx
        app.kubernetes.io/part-of: ingress-nginx
      annotations:
        prometheus.io/port: "10254"
        prometheus.io/scrape: "true"
    spec:
      # 使用主机网络
      hostNetwork: true
      # 选择节点运行
      nodeSelector:
        ingress: "true"
      serviceAccountName: nginx-ingress-serviceaccount
......

步骤三：所有node节点上传 nginx-ingress-controller 镜像压缩包并且进行加载

镜像压缩包 ingree.contro.tar.gz

cd /opt/ingress
tar zxvf ingree.contro.tar.gz
docker load -i ingree.contro.tar

步骤四：启动 nginx-ingress-controller，并检查该pod的运行状况

kubectl apply -f mandatory.yaml
 
//nginx-ingress-controller 已经运行 node02 节点
kubectl get pod -n ingress-nginx -o wide
 
 
kubectl get cm,daemonset -n ingress-nginx -o wide
 
 
//到 node02 节点查看
netstat -lntp | grep nginx
  
 
由于配置了 hostnetwork，nginx 已经在 node 主机本地监听 80/443/8181 端口。其中 8181 是
 nginx-controller 默认配置的一个 default backend（Ingress 资源没有匹配的 rule 对象时，
流量就会被导向这个 default backend）。
这样，只要访问 node 主机有公网 IP，就可以直接映射域名来对外网暴露服务了。如果要 nginx 
高可用的话，可以在多个 node上部署，并在前面再搭建一套 LVS+keepalived 做负载均衡。

步骤五：创建 ingress 规则

(1) 创建一个业务pod 和 svc 资源

vim nginx-app.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: nginx-app
  name: nginx-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx-app
  template:
    metadata:
      labels:
        app: nginx-app
    spec:
      containers:
      - image: nginx:1.18
        name: nginx
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: nginx-app
  name: nginx-app
spec:
  type: ClusterIP
  ports:
  - port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx-app


kubectl apply -f nginx-app.yaml

(2) 创建Ingress资源

方法一：（extensions/v1beta1 Ingress 在1.22版本即将弃用）
vim ingress-app.yaml
#apiVersion: extensions/v1beta1    #指定了 Ingress 资源所属的 API 组和版本
apiVersion: networking.k8s.io/v1     #推荐使用 apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-app-ingress    #定义了 Ingress 的名称
spec:                        #这部分定义了 Ingress 的具体配置和规则。
  rules:                    #定义了 Ingress 的路由规则，用于决定如何将请求转发到后端服务
  - host: www.benet.com      #指定了一个主机名（域名），所有针对 www.benet.com 的请求将被这个 Ingress 规则处理
    http:                #这部分定义了 HTTP 相关的路由规则
      paths:
      - path: /      #指定了一个路径规则，所有对根路径 / 的请求将被路由到指定的后端服务
        backend:        #定义了路径规则对应的后端服务
          serviceName: nginx-app     #指定了后端service服务的名称
          servicePort: 80            #指定了后端服务的端口号


方法二：
vim ingress-app.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-app-ingress
spec:
  rules:
  - host: www.benet.com
    http:
      paths:
      - path: /
        pathType: Prefix
#定义了路径匹配类型为前缀匹配，这意味着任何以 / 开头的路径都会匹配此规则。
#这是默认的匹配类型，但在较新版本中显式指定以增强可读性和避免未来版本的兼容性问题

        backend:
          service:
            name: nginx-app
            port:
              number: 80

kubectl apply -f ingress-app.yaml

进行访问测试

#选择一台客户机，直接添加node02的节点的IP与pod的域名进行映射
vim /etc/hosts
192.168.80.12 www.benet.com
 
curl www.benet.com

查看 nginx-ingress-controller

kubectl get pod -n ingress-nginx -o wide

kubectl exec -it nginx-ingress-controller-x2swm -n ingress-nginx /bin/bash

more /ect/nginx/nginx.conf

或

awk 'NR {printf "%03d %s\n", NR, $0}' /etc/nginx/nginx.conf | more

三、Deployment+NodePort模式的Service

方式三：Deployment+NodePort模式的Service

如果做了上一个操作，就将所有的yaml文件通过delete进行清除。继续下面的操作

3.1 下载模板并启用

步骤一：下载相关的ingress和service-nodeport模板

下载 nginx-ingress-controller 和 ingress-nginx 暴露端口配置文件
mkdir /opt/ingress-nodeport
cd /opt/ingress-nodeport

官方下载地址：
wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.30.0/deploy/static/mandatory.yaml
wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.30.0/deploy/static/provider/baremetal/service-nodeport.yaml

国内 gitee 资源地址：
wget https://gitee.com/mirrors/ingress-nginx/raw/nginx-0.30.0/deploy/static/mandatory.yaml
wget https://gitee.com/mirrors/ingress-nginx/raw/nginx-0.30.0/deploy/static/provider/baremetal/service-nodeport.yaml


在所有 node 节点上传镜像包 ingress-controller-0.30.0.tar 到 /opt/ingress-nodeport 目录，并加载镜像
docker load -i ingress-controller-0.30.0.tar

步骤二：直接启动官方模板即可使用

kubectl apply -f mandatory.yaml
kubectl apply -f service-nodeport.yaml
 
 
 
#//如果K8S Pod 调度失败，在 kubectl describe pod资源时显示：
Warning  FailedScheduling  18s (x2 over 18s)  default-scheduler  0/2 nodes are available: 2 node(s) didn't match node selector
解决方案：
1. 给需要调度的node加上对应标签
# 相对上面这个Yaml文件的例子
kubectl label nodes node_name kubernetes.io/os=linux

2. 删除Yaml文件中的nodeSelector，如果对节点没有要求的话，直接删除节点选择器即可

3.2 进行Ingress Http代理访问的操作演示

mkdir /opt/ingress-nodeport
cd /opt/ingress-nodeport


创建 deployment、Service、Ingress Yaml 资源
vim ingress-nginx.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: nginx
  name: nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx
        name: nginx
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-svc
spec:
  ports:
  - port: 80
    targetPort: 80
    protocol: TCP
  selector:
    name: nginx
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-ingress
spec:
  rules:
  - host: www.benet.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: nginx-svc
            port:
              number: 80



-------------------------------------------------------------------------------------------
#host 主机名可以是精确匹配，或者使用通配符来匹配，但通配符仅覆盖一个 DNS 标签（例如 *.foo.com 不匹配 baz.bar.foo.com）。
 
#pathType 支持的路径类型有三种：
●ImplementationSpecific：对于这种路径类型，匹配方法取决于 IngressClass。具体实现可以将其作为单独的 pathType 处理或者与 Prefix 或 Exact 类型作相同处理。
 
●Exact：精确匹配 URL 路径，且区分大小写。
 
●Prefix：基于以 / 分隔的 URL 路径前缀匹配。匹配区分大小写。如果路径的最后一个元素是请求路径中最后一个元素的子字符串，则不会匹配 （例如：/foo/bar 匹配 /foo/bar/baz, 但不匹配 /foo/barbaz）。
 
具体可详见：https://kubernetes.io/zh-cn/docs/concepts/services-networking/ingress/#the-ingress-resource
-------------------------------------------------------------------------------------------


kubectl apply -f ingress-nginx.yaml

kubectl get svc,pods -o wide

客户机进行访问测试：

可以进入pod容器中修改nginx网页文件达到更佳的测试效果，这里就不演示了。

本地 host 添加域名解析

3.3 Ingress HTTP 代理访问虚拟主机

我们知道nginx和apache能够设置三种虚拟主机，分别为：基于IP，基于域名，基于端口。同样ingress-nginx这里也可以设置出这三种虚拟主机。下面将以最常用的基于域名的虚拟主机为例子，进行操作演示

创建虚拟主机1 资源

vim deploy-ng1.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment1
spec:
  replicas: 1
  selector:
    matchLabels:
      name: nginx1
  template:
    metadata:
      labels:
        name: nginx1
    spec:
      containers:
        - name: nginx1
          image: soscscs/myapp:v1
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: svc-1
spec:
  ports:
    - port: 80
      targetPort: 80
      protocol: TCP
  selector:
    name: nginx1


kubectl apply -f deploy-ng1.yaml

创建虚拟主机2 资源

vim deploy-ng2.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment2
spec:
  replicas: 1
  selector:
    matchLabels:
      name: nginx2
  template:
    metadata:
      labels:
        name: nginx2
    spec:
      containers:
        - name: nginx2
          image: soscscs/myapp:v2
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: svc-2
spec:
  ports:
    - port: 80
      targetPort: 80
      protocol: TCP
  selector:
    name: nginx2
	
	
kubectl apply -f deploy-ng2.yaml

创建ingress资源

vim ingress-nginx1.yaml

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-ng
spec:
  rules:
    - host: www.ng1.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
            service: 
              name: svc-1
              port:
                number: 80
    - host: www.ng2.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
            service: 
              name: svc-2
              port:
                number: 80

kubectl apply -f ingress-nginx.yaml

做好映射（这里任意填写一个node节点的IP即可）

测试访问

3.4 Ingress HTTPS 代理访问

（1）创建ssl证书，进行secret资源存储

#yum安装openssl
yum install -y openssl

#创建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 --key=tls.key --cert=tls.crt

（2）创建 deployment、Service、Ingress Yaml 资源

vim ingress-https.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-app
spec:
  replicas: 2
  selector:
    matchLabels:
      name: nginx
  template:
    metadata:
      labels:
        name: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:1.18
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-svcc
spec:
  ports:
    - port: 80
      targetPort: 80
      protocol: TCP
  selector:
    name: nginx
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-https
spec:
  tls:
    - hosts:
      - www.ng3.com
      secretName: tls-secret
  rules:
    - host: www.ng3.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
            service: 
              name: nginx-svcc
              port:
                number: 80


kubectl apply -f ingress-https.yaml

访问测试
在宿主机的 C:\Windows\System32\drivers\etc\hosts 文件中添加 192.168.80.12 www.ng3.com 记录。
使用谷歌浏览器访问 https://www.ng3.com:31864

3.5 ingress设置pod业务nginxBasicAuth认证

（1）生成用户密码认证文件，创建 secret 资源进行存储

yum -y install httpd-tools
htpasswd -c auth wang			#认证文件名必须为 auth
kubectl create secret generic basic-auth --from-file=auth

（2）在上述HTTPS 代理访问实验中，我们在ingress-https.yaml添加以下内容

vim ingress-https.yaml

#以上内容省略
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-https
  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 - wang'
spec:
  tls:
    - hosts:
      - www.ng3.com
      secretName: tls-secret
  rules:
    - host: www.ng3.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              name: nginx-svcc
              port:
                number: 80


kubectl apply -f ingress-https.yaml

具体详细设置方法可参考官网：Basic Authentication - Ingress-Nginx Controller

访问测试

浏览器访问：https://www.ng3.com:31864

3.6 Ingress中设置nginx重写

kubectl explain Ingress.metadata.annotations

#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上定义的路径是否使用正则表达式

我们添加一个http的pod和svc资源，ingress（www.ng3.com）。然后进行重写ingress的编写

pod，svc，ingress 资源就使用 ingress-https.yaml 的配置，就不在重新创建了。

vim ingress-rewrite.yaml

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-rewrite
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: https://www.ng3.com:31864
spec:
  rules:
  - host: re.ng3.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
		  #由于re.ng3.com只是用于跳转不需要真实站点存在，因此svc资源名称可随意定义
          service: 
            name: nginx-svcc
            port:
              number: 80


kubectl apply -f ingress-rewrite.yaml

进行客户机访问测试

首先添加主机映射：

访问 https://re.ng3.com:31864/

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

总结

ingress的使用：
DaemonSet + host网络模式 部署ingress-controller：
客户端(防火墙，前端负载均衡器) -> Node节点的80或443端口（ingress-controller，host网络模式下节点主机与Pod共享网络命名空间） -> 业务Pod的Service -> 业务Pod
 
Deployment + Service(NodePort) 部署：
客户端(防火墙，前端负载均衡器) -> ingress-controller的Service（NodeIP:NodePort） -> ingress-controller（以Pod形式运行） -> 业务Pod的Service -> 业务Pod
 
ingress的配置：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: 资源名称
spec:
  rules:
  - host: 域名（可以精确匹配或通配符匹配，比如 *.kgc.com 可以匹配www.kgc.com或mail.kgc.com等，但不能匹配ky22.www.kgc.com）
    http:
      paths:
      - path: 域名后的URL路径（比如 / 代表网页根路径，或者 /test）
        pathType: Prefix|Exact（Exact用于精确匹配URL路径；Prefix用于前缀匹配，且只能匹配完整的字符串，/test/abc能匹配/test/abc/123，但不能匹配/test/abc123）
        backend:
          service:
            name: 指定SVC的名称
            port:
              number: 指定SVC的端口
 
基于 域名 的代理转发
spec:
  rules:
  - host: 域名1
    http:
    ....
	
  - host: 域名2
    http:
    ....
	
基于 URL路径 的代理转发
spec:
  rules:
  - host:
    http:
      paths:
      - path: URL路径1
	    ....
		
      - path: URL路径2
	    ....
		
https 代理转发
先签发 TLS 证书 和 私钥文件
创建 tls 类型的 Secret 资源，把证书和私钥信息保存到 Secret 资源中
创建 ingress 资源，调用 tls 类型的 Secret 资源
spec:
  tls:
  - hosts:
    - 指定使用https的域名
    secretName: 指定tls_Secret资源名称
  rules:
    ....
	
	
basic-auth 访问认证
创建 Opaque 类型的 Secret 资源，把basic认证文件内容保存到 Secret 资源中
创建 ingress 资源
metadata:
  annotations:
    nginx.ingress.kubernetes.io/auth-type: basic
    nginx.ingress.kubernetes.io/auth-secret: 指定保存basic认证文件内容的Secret资源
    nginx.ingress.kubernetes.io/auth-realm: '指定提示信息'
 
 
rewrite 重写
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: 指定要跳转的目标域名或URL路径
	                                            http|https://<域名>:<ingress-controller的svc端口>