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地址配置给负载均衡服务做后端。
●externalIPs:service允许为其分配外部IP,如果外部IP路由到集群中一个或多个Node上,Service会被暴露给这些externalIPs。通过外部IP进入到集群的流量,将会被路由到Service的Endpoint上。
●Ingress:只需一个或者少量的公网IP和LB,即可同时将多个HTTP服务暴露到外网,七层反向代理。
可以简单理解为service的service,它其实就是一组基于域名和URL路径,把用户的请求转发到一个或多个service的规则。
●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 地址:GitHub - kubernetes/ingress-nginx: Ingress-NGINX Controller for Kubernetes
Ingress-Nginx 官方网站:Welcome - Ingress-Nginx Controller
(1)ingress-controller通过和 kubernetes APIServer 交互,动态的去感知集群中ingress规则 变化。
(2)然后读取它,按照自定义的规则,规则就是写明了哪个域名对应哪个service,生成一段 nginx配置。
(3)再写到nginx-ingress-controller的pod里,这个ingress-controller的pod里运行着一个 Nginx服务,控制器会把生成的 nginx配置写入 /etc/nginx.conf文件中。
(4)然后reload一下使配置生效。以此达到域名区分配置和动态更新的作用。
Traefik是一个为了让部署微服务更加便捷而诞生的现代HTTP反向代理、负载均衡工具。 它支持多种后台 (Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd, Zookeeper, BoltDB, Rest API, file…) 来自动化、动态的应用它的配置文件设置。
ingress-nginx
使用nginx作为前端负载均衡,通过ingress controller不断的和kubernetes api交互,实时获取后端service,pod等的变化,然后动态更新nginx配置,并刷新使配置生效,达到服务发现的目的。
Ingress-traefik:
traefik本身设计的就能够实时跟kubernetes api交互,感知后端service,pod等的变化,自动更新配置并重载。相对来说traefik更快速方便,同时支持更多的特性,使反向代理,负载均衡更直接更便捷。(GO语言编写的,原生支持K8S等云原生应用,兼容性更好,但并发能力是 ingress-nginx 的6成)
eg:以阿里云为例
用DaemonSet结合nodeselector来部署ingress-controller到特定的node上,然后使用HostNetwork直接把该pod与宿主机node的网络打通,直接使用宿主机的80/433端口就能访问服务。这时,ingress-controller所在的node机器就很类似传统架构的边缘节点,比如机房入口的nginx服务器。该方式整个请求链路最简单,性能相对NodePort模式更好。缺点是由于直接利用宿主机节点的网络和端口,一个node只能部署一个ingress-controller pod。 比较适合大并发的生产环境使用。
同样用deployment模式部署ingress-controller,并创建对应的service,但是type为NodePort。这样,ingress就会暴露在集群节点ip的特定端口上。由于nodeport暴露的端口是随机端口,一般会在前面再搭建一套负载均衡器来转发请求。该方式一般用于宿主机是相对固定的环境ip地址不变的场景。
NodePort方式暴露ingress虽然简单方便,但是NodePort多了一层NAT,在请求量级很大时可能对性能会有一定影响。
2. 部署DaemonSet+HostNetwork暴露Ingress
- #mandatory.yaml文件中包含了很多资源的创建,包括namespace、ConfigMap、role,ServiceAccount等等所有部署ingress-controller需要的资源。
-
- 官方下载地址:
- 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
应该是 hostNetwork: true
指定 nginx-ingress-controller 运行在 node02 节点
- kubectl apply -f deploy.yaml
- kubectl get pod -n ingress-nginx -owide
- 到 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 做负载均衡。
- //创建一个 deploy 和 svc
- vim service-nginx.yaml
- apiVersion: apps/v1
- kind: Deployment
- metadata:
- name: nginx-app
- spec:
- replicas: 2
- selector:
- matchLabels:
- app: nginx
- template:
- metadata:
- labels:
- app: nginx
- spec:
- containers:
- - name: nginx
- image: nginx
- imagePullPolicy: IfNotPresent
- ports:
- - containerPort: 80
- ---
- apiVersion: v1
- kind: Service
- metadata:
- name: nginx-app-svc
- spec:
- type: ClusterIP
- ports:
- - protocol: TCP
- port: 80
- targetPort: 80
- selector:
- app: nginx
-
-
- //创建 ingress
- kubectl get ingressclasses
- NAME CONTROLLER PARAMETERS AGE
- nginx k8s.io/ingress-nginx <none> 22m
-
- vim ingress-app.yaml
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: nginx-app-ingress
- spec:
- ingressClassName: "nginx"
- rules:
- - host: www.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: nginx-app-svc
- port:
- number: 80
-
- -------------------------------------------------------------------------------------------
- ingressClassName 指定 IngressClass,用来指定选择的 Ingress Controller
-
- host 主机名可以是精确匹配,或者使用通配符来匹配,但通配符仅覆盖一个 DNS 标签(例如 *.foo.com 不匹配 baz.bar.foo.com)。
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
- kubectl apply -f service-nginx.yaml
- kubectl apply -f ingress-app.yaml
-
- kubectl get pods
- kubectl get ingress
- //本地 host 添加域名解析
- vim /etc/hosts
- kubectl get pod -n ingress-nginx -o wide
- kubectl exec -it nginx-ingress-controller-99h72 -n ingress-nginx /bin/bash
- # more /etc/nginx/nginx.conf
- //可以看到从 start server www.kgc.com 到 end server www.kgc.com 之间包含了此域名用于反向代理的配置
3.Deployment+NodePort模式的Service
如果做了上一个操作,就将所有的yaml文件通过delete进行清除。继续下面的操作
- 1、下载 nginx-ingress-controller 配置文件
- mkdir /opt/ingress-nodeport
- cd /opt/ingress-nodeport
-
- 官方下载地址:
- 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
-
- 修改镜像地址为:
- 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
-
- 2、修改配置文件
- apiVersion: v1
- kind: Service
- metadata:
- labels:
- app.kubernetes.io/component: controller
- app.kubernetes.io/instance: ingress-nginx
- app.kubernetes.io/name: ingress-nginx
- app.kubernetes.io/part-of: ingress-nginx
- app.kubernetes.io/version: 1.3.0
- name: ingress-nginx-controller
- namespace: ingress-nginx
- spec:
- #externalTrafficPolicy: Local #注释此行,值为Cluster表示流量可以转发到其他节点上的Pod;Local表示:流量只发给本机的Pod
- ports:
- ......
- type: NodePort #Service类型设置为 NodePort 或 LoadBalancer
-
- 3、启动 nginx-ingress-controller
- kubectl apply -f deploy.yaml
-
- kubectl get pod,svc -n ingress-nginx
- #创建 deployment、Service、Ingress Yaml 资源
- vim ingress-nginx.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
- imagePullPolicy: IfNotPresent
- 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-test
- spec:
- ingressClassName: "nginx"
- rules:
- - host: www.benet.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: nginx-svc
- port:
- number: 80
-
-
-
- kubectl apply -f ingress-nginx.yaml
-
- kubectl get svc,pods -o wide
- kubectl exec -it pod/nginx-app-65d7b99f6b-l4g65 bash
- # cd /usr/share/nginx/html/
- # echo 'this is web1' >> index.html
- kubectl exec -it pod/nginx-app-65d7b99f6b-zcqgp bash
- # cd /usr/share/nginx/html/
- # echo 'this is web2' >> index.html
- #测试访问
- curl 10.96.212.214
-
- kubectl get svc -n ingress-nginx
- NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
- ingress-nginx NodePort 10.96.67.119 <none> 80:32383/TCP,443:32133/TCP 59m
-
- #本地 host 添加域名解析
- vim /etc/hosts
- 192.168.80.10 master
- 192.168.80.11 node01
- 192.168.80.12 node02
- 192.168.80.12 www.kgc.com www.benet.com
-
- #外部访问
- curl http://www.benet.com:32383
我们知道nginx和apache能够设置三种虚拟主机,分别为:基于IP,基于域名,基于端口。同样ingress-nginx这里也可以设置出这三种虚拟主机。下面将以最常用的基于域名的虚拟主机为例子,进行操作演示
- mkdir /opt/ingress-nodeport/vhost
- cd /opt/ingress-nodeport/vhost
- vim deployment1.yaml
- apiVersion: apps/v1
- kind: Deployment
- metadata:
- name: deployment1
- spec:
- replicas: 2
- 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 deployment1.yaml
- vim deployment2.yaml
- apiVersion: apps/v1
- kind: Deployment
- metadata:
- name: deployment2
- spec:
- replicas: 2
- 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 deployment2.yaml
- vim ingress-nginx.yaml
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: ingress1
- spec:
- ingressClassName: "nginx"
- rules:
- - host: www1.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: svc-1
- port:
- number: 80
- ---
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: ingress2
- spec:
- ingressClassName: "nginx"
- rules:
- - host: www2.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: svc-2
- port:
- number: 80
-
-
- kubectl apply -f ingress-nginx.yaml
- vim /etc/hosts
- kubectl get svc -n ingress-nginx
- curl www1.kgc.com:39993
- curl www2.kgc.com:39993
- mkdir /opt/ingress-nodeport/https
- cd /opt/ingress-nodeport/https
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout tls.key -out tls.crt -subj "/CN=nginxsvc/O=nginxsvc"
-
- kubectl create secret tls tls-secret --key tls.key --cert tls.crt
-
- kubectl get secret
-
- kubectl describe secret tls-secret
- 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
- imagePullPolicy: IfNotPresent
- 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-https
- spec:
- ingressClassName: "nginx"
- tls:
- - hosts:
- - www3.kgc.com
- secretName: tls-secret
- rules:
- - host: www3.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: nginx-svc
- port:
- number: 80
-
-
- kubectl apply -f ingress-https.yaml
-
- kubectl get svc -n ingress-nginx
- mkdir /opt/ingress-nodeport/basic-auth
- cd /opt/ingress-nodeport/basic-auth
- yum -y install httpd
- htpasswd -c auth zhangsan #认证文件名必须为 auth
- kubectl create secret generic basic-auth --from-file=auth
- vim ingress-auth.yaml
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: ingress-auth
- 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 - zhangsan'
- spec:
- ingressClassName: "nginx"
- rules:
- - host: auth.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: nginx-svc
- port:
- number: 80
-
-
- kubectl apply -f ingress-auth.yaml
//具体详细设置方法可参考官网https://kubernetes.github.io/ingress-nginx/examples/auth/basic/
进行客户机访问测试:
- kubectl get svc -n ingress-nginx
-
- echo '192.168.136.100 auth.kgc.com' >> /etc/hosts
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上定义的路径是否使用正则表达式
进行demo演示:
我们添加一个http的pod和svc资源,ingress(www.asd.com)。然后进行重写ingress的编写
- vim ingress-nginx.yaml
- apiVersion: apps/v1
- kind: Deployment
- metadata:
- name: nginx-app
- spec:
- replicas: 1
- selector:
- matchLabels:
- name: nginx
- template:
- metadata:
- labels:
- name: nginx
- spec:
- containers:
- - name: nginx
- image: nginx:1.14
- imagePullPolicy: IfNotPresent
- 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
- ports:
- - port: 80
- targetPort: 80
- protocol: TCP
- selector:
- name: nginx
- ---
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: nginx-test
- spec:
- rules:
- - host: www.asd.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- service:
- name: nginx-svc
- port:
- number: 80
-
-
- kubectl apply -f ingress-nginx.yaml
- vim write-ingress.yaml
-
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: nginx-rewrite
- annotations:
- nginx.ingress.kubernetes.io/rewrite-target: http://www.asd.com:31019
- spec:
- rules:
- - host: www.write.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- #由于www.rewrite.com只是用于跳转不需要真实站点存在,因此svc资源名称可随意定义
- service:
- name: nginx-svc
- port:
- number: 80
-
-
- kubectl apply -f write-ingress.yaml
- vim ingress-rewrite.yaml
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: nginx-rewrite
- annotations:
- nginx.ingress.kubernetes.io/rewrite-target: http://www1.kgc.com:32383
- spec:
- ingressClassName: "nginx"
- rules:
- - host: re.kgc.com
- http:
- paths:
- - path: /
- pathType: Prefix
- backend:
- #由于re.kgc.com只是用于跳转不需要真实站点存在,因此svc资源名称可随意定义
- service:
- name: nginx-svc
- port:
- number: 80
-
-
- kubectl apply -f ingress-rewrite.yaml
- 基于canary实现金丝雀发布
- 在新版本应用的ingress资源配置中的metadata.annotations字段添加相关配置
- metadata:
- annotations:
- nginx.ingress.kubernetes.io/canary: "true" #开启金丝雀发布
- nginx.ingress.kubernetes.io/canary-weight: "50" #指定流量调度权重,默认总值为100
- spec:
- rules:
- - host: 与旧版本应用相同的域名
- http:
- paths:
- - path: 与旧版本应用相同的域名URL路径
- backend:
- service:
- name: 新版本应用的Service资源名称
- port:
- number: 新版本应用的Service资源的port端口
总结
- K8S集群外部的客户端访问K8S集群内部的方案?
- 基于Service实现:NodePort LoadBalancer externalIPs 只能支持四层反向代理,如果K8S集群规模较大运行的业务较多时NodePort端口/externalIPs管理成本会很高
-
- 基于Ingress实现:支持七层反向代理,可自定义规则根据用户请求的域名或URL路径转发给指定Service进行代理访问
-
-
- Ingress的组成:
- ingress控制器(ingress controller):根据在ingress资源对象配置的规则转发用户请求的组件,以Pod形式运行的
-
- ingress资源对象:设置转发规则,告诉ingress控制器应该根据什么域名或URL路径转发请求给相应的Service资源的endpoints端点(podIP:容器Port)
-
-
- Ingress的使用:
- DaemonSet + host网络模式 部署的ingress控制器
- 数据流向:客户端 -> 通过node节点的80/433端口进入ingress控制器 -> 根据ingress对象的转发规则 -> 业务Pod的Service -> 通过标签选择器 -> 业务Pod
-
- Deployment + NodePort/LoadBalancer类型的Service 部署的ingress控制器
- 数据流向:客户端 -> 通过nodeIP:NodePort -> ingress控制器的Service -> ingress控制器 -> 根据ingress对象的转发规则 -> 业务Pod的Service -> 通过标签选择器 -> 业务Pod
-
-
- 创建Ingress资源
- kubectl create ingress <ingress资源名称> -n <命名空间> --class=<ingressclass名称> --rule=<域名>/<URL路径>=<service资源名称>:<service的port端口>
-
- Ingress资源配置
- apiVersion: networking.k8s.io/v1
- kind: Ingress
- metadata:
- name: ingress资源名称
- namespace: 命名空间
- spec:
- ingressClassName: ingressclass名称
- rules:
- - host: 域名
- http:
- paths:
- - path: URL路径
- pathType: Prefix(前缀匹配)|Exact(精准匹配)
- backend:
- service:
- name: Service资源名称
- port:
- number: Service资源的port端口
-
- #基于不同域名的代理转发
- - host: 域名2
- http:
- paths:
- - path: URL路径1
- pathType:
- backend:
- ....
- #基于不同URL路径的代理转发
- - path: URL路径2
- pathType:
- backend:
- ....
-
- #基于https代理转发
- tls: #与roles字段在同一层级
- - hosts:
- - 指定使用https访问的域名
- ....
- secretName: 指定tls类型的secret资源名称
-
- #基于basic-auth实现访问认证
- 1)使用htpasswd创建用户数据文件,文件名为auth
- 2)基于auth文件创建secret资源 kubectl create secret generic <secret资源名称> --from-file=auth
- 3)创建ingress资源,在metadata.annotations字段添加相关配置
- metadata:
- annotations:
- nginx.ingress.kubernetes.io/auth-type: basic
- nginx.ingress.kubernetes.io/auth-secret: secret资源名称
- nginx.ingress.kubernetes.io/auth-realm: '认证窗口提示信息'
-
- #基于rewrite实现重写访问路径
- 在metadata.annotations字段添加相关配置
- metadata:
- annotations:
- nginx.ingress.kubernetes.io/rewrite-target: https://www.bbb.com:30443
- spec:
- rules:
- - host: www.aaa.com
-
- 将任何访问 http://www.aaa.com:30080/XXXX 的请求,都重写成 https://www.bbb.com:30443
-
- metadata:
- annotations:
- nginx.ingress.kubernetes.io/rewrite-target: https://www.XXX.com:30443/$2
- nginx.ingress.kubernetes.io/use-regex: "true"
- spec:
- rules:
- - host: www.aaa.com
- http:
- paths:
- - path: /(.*)
- backend:
- ....
-
- 将任何访问 http://www.aaa.com:30080/XXXX 的请求,都重写成 https://www.bbb.com:30443/XXXX
-
- 基于canary实现金丝雀发布
- 在新版本应用的ingress资源配置中的metadata.annotations字段添加相关配置
- metadata:
- annotations:
- nginx.ingress.kubernetes.io/canary: "true" #开启金丝雀发布
- nginx.ingress.kubernetes.io/canary-weight: "50" #指定流量调度权重,默认总值为100
- spec:
- rules:
- - host: 与旧版本应用相同的域名
- http:
- paths:
- - path: 与旧版本应用相同的域名URL路径
- backend:
- service:
- name: 新版本应用的Service资源名称
- port:
- number: 新版本应用的Service资源的port端口