# 通过 Ingress 访问您的应用
参考文档:
- Kubernetes Ingress (opens new window)
- Kubernetes Ingress Controllers (opens new window)
- Kubernetes Nginx Ingress Controller Bare-metal considerations (opens new window)
- nginxinc/kubernets-ingress kubernetes-ingress (opens new window)
# Ingress
Ingress 是 Kubernetes 的一种 API 对象,将集群内部的 Service 通过 HTTP/HTTPS 方式暴露到集群外部,并通过规则定义 HTTP/HTTPS 的路由。Ingress 具备如下特性:集群外部可访问的 URL、负载均衡、SSL Termination、按域名路由(name-based virtual hosting)。Ingress 的例子如下所示:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-ingress-for-nginx # Ingress 的名字,仅用于标识
spec:
rules: # Ingress 中定义 L7 路由规则
- host: demo.my-company.com # 根据 virtual hostname 进行路由(请使用您自己的域名)
http:
paths: # 按路径进行路由
- path: /
backend:
serviceName: nginx-service # 指定后端的 Service 为之前创建的 nginx-service
servicePort: 80
2
3
4
5
6
7
8
9
10
11
12
13
Ingress Controller 通常是部署在集群中的一个 Deployment,并且通过 NodePort Service 暴露自己的端口,使得用户可以在集群外通过其 NodePort 访问到 Ingress Controller,假设该端口为 32351
,并且 demo.my-company.com
这个域名被解析到集群中某一个节点的 IP(或者被配置到浏览器所在机器的 hosts 文件),则当用户在浏览器中输入地址 http://demo.my-company.com:32351
时:
- 请求被转发到集群某节点的
32351
节点端口; - 根据 Service 的定义,请求被转发到 Ingress Controller 的 Web 端口;
- Ingress Controller 根据请求域名
demo.my-company.com
以及请求路径,匹配到 Ingress 定义中该请求应该被路由到nginx-service
的80
端口; - Ingress Controller 执行 L7 路由转发,将请求发送到
nginx-service
的80
端口。
# 安装 Ingress Controller
Kuboard 为您提供了一种快速安装 ingress-nginx
的方法,步骤如下所示:
- Kubernetes 集群版本不低于 v1.19
- Kuboard 版本不低于 v3.3.0.0
导航到集群的
集群管理
-->网络
-->IngressClass
列表页,如下图所示:点击图中的
安装 IngressNginxController 并创建 IngressClass
的按钮,如下图所示:假设名称为
my-ingress-controller
完成 Ingress Controller 的创建后,将进入如下界面:
负载均衡
- 通常,您需要在集群外配置一个负载均衡器,并将负载均衡器接收到的所有请求转发到 Ingress Controller 对应的节点端口;
- 为了快速验证,在不配置负载均衡器的情况下,可以将业务域名直接解析到集群的某一个节点,并在访问时,在域名后面增加节点端口;
# 实战:使用 Ingress 访问 Web 应用
前提
- 假设您已经完成了 公布应用程序 中的实战部分
- 假设您已经将
demo.my-company.com
解析到集群的某一个节点 IP (或者已配置到 hosts 文件中)
在 default 名称空间 点击左侧菜单栏中的 创建工作负载,如下图所示:
填写表单如下:
字段名称 填写内容 备注 服务类型 Deployment 服务分层 展现层 服务名称 web-nginx 服务描述 nginx部署 副本数量 1 可以填写其他正整数 切换到 容器信息 Tab 页,并点击
添加工作容器
按钮,如下图所示:填写表单如下:
字段名称 填写内容 备注 容器名称 nginx 镜像 nginx:1.7.9 抓取策略 Always 切换到 服务/应用路由 Tab 页,如下图所示:
填写表单如下:
字段名称 填写内容 备注 服务 NodePort(VPC内访问)
协议: TCP
port: 80
targetPort: 80服务对应 Kubernetes Service对象,
工作负载编辑器为其使用与 Deployment 相同的名字 web-nginx应用路由 IngressClass:my-ingress-controller
域名: demo.my-company.com
映射URL: /
服务端口:80应用路由对应 Kubernetes Ingress对象,
工作负载编辑器为其使用与 Deployment 相同的名字 web-nginxTIP
Kuboard 工作负载编辑器假设 kubernetes 中三个主要对象 Deployment/Service/Ingress 名称相同,并放在同一个编辑器界面中处理。
点击 保存
点击 应用
从浏览器访问
在浏览器打开
http://demo.my-company.com:32351
,如下图所示:节点端口
根据您安装 IngressController 的结果,您应该使用的端口号极有可能不是
32351
,请使用您的在 安装 Ingress Controller 这个步骤中获得的 IngressController 的节点端口。