Ingress 原理及实例

什么是Ingress

---

在Kubernetes中，Service和Pod的IP地址只能在集群内部网络中路由，所有到达“边界路由器”（Edge Router）的网络流量要么被丢弃，要么被转发到别处，从概念上讲，它类似下图：

Ingress是对外（公网）服务到集群内的Service之间规则的集合：允许进入集群的请求被转发至集群内的Service，过程类似下图：

Ingress能把Service（Kubernetes的服务）配置成外网能够访问的URL，流量负载均衡，终止SSL，提供于域名访问的虚拟主机等，用户通过访问URL（API资源服务的形式，例如：caas.one/kibana）进入和请求Service，一个Ingress控制器负责处理所有Ingress的请求流量，它通常是一个负载均衡器，它也可以设置在边界路由器上，或者由额外的前端来帮助处理HA方式的流量。

环境准备

---

如果你的kubernetes运行在GCE或者AWS等云环境中，那么他们都有良好、稳定的负载均衡设施供您使用，本文讨论的问题不包含GCE/AWS等云环境，我们重点讨论在没有负责均衡的基础设施的情况下，我们如何将我们的集群内Services作为一种资源暴露在公网上。

我们需要一个Ingress控制器，这里我们使用nginx1.9.1作为ingress控制器，来将我们的Service暴露在公网上，整个过程的原理如下：

• Ingress是一种对象（资源）存在于API Server(ETCD)上，它的整个生命周期（创建、更新、销毁）可以被实时的监听
• 编写一个golang程序来监听/ingresses的变化
• 我们采用nginx和golang程序来实现对Ingress控制
• 使用Nginx做负载均衡和请求路由，nginx的配置文件由Golang的模板来编写
• /ingresses变化后，golang程序修改nginx的配置文件，reload这个nginx服务

我们将Ingress控制器（nginx-ingress-controller）作为kubernetes的pod部署在kubernetes集群中，这里我们将使用kubernetes1.2版本的新特性（DaemonSet），将nginx-ingress-controller作为Only-One-Pod-Per-Node的应用发布，然后将nginx-ingress-controller服务使用NodePort的方式暴露在外网，最后，在DNS上设置将域名指向这些主机。

使用Ingress

---

编写一个简单的ingress，它类似：

cat > ingress.yaml

apiVersion: extensions/v1beta1

kind: Ingress
metadata:
name: test-ingress
spec:
backend:
serviceName: testsvc

    servicePort: 80

可以通过kubectl -f ingress.yaml来创建ingress。

下面是更复杂一点的例子：

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: test
spec:
rules:
- host: foo.bar.com
http:
paths:
- path: /foo
backend:
serviceName: s1
servicePort: 80
- path: /bar
backend:
serviceName: s2
servicePort: 80

使用Ingress暴露ElasticSearch和Kibana服务

---

我们现有的集群中有部署了efk（elasticsearch + fluentd + kibana）技术栈，现在我们想把elastic search和kibana两个服务暴露在公网上，方便我们的合作商来访问，我们要达到的目的：

• 我们有两个域名，分别是：caas.one和jingru.io
• caas.one用来暴露kibana服务，jingru.io用来暴露es服务
• 我们希望合作商能够通过caas.one/kibana来访问我们的内部的kibana服务
• 我们希望合作商能够通过jingru.io/es来访问我们的内部的es服务

为了达到我们的目标，我们将逐步建立我们ingress设施：

1. 编写glang程序（https://github.com/kubernetes/contrib/tree/master/ingress/controllers/nginx/nginx），并构建出二进制文件：nginx-ingress-controller。
2. 编写nginx.tmplhttps://github.com/lth2015/kubernetes-examples/blob/master/ingress/docker/nginx.tmpl
3. 创建Ingress控制器：

编写Dockerfile

# Copyright 2015 The Kubernetes Authors. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

FROM gcr.io/google_containers/nginx-slim:0.5

RUN apt-get update && apt-get install -y \
diffutils procps net-tools \
--no-install-recommends \
&& rm -rf /var/lib/apt/lists/*

COPY nginx-ingress-controller /
COPY nginx.tmpl /
COPY default.conf /etc/nginx/nginx.conf

COPY lua /etc/nginx/lua/

WORKDIR /

CMD ["/nginx-ingress-controller"]

编译nginx-ingress-controller镜像

docker build -t nginx-ingress-controller:0.5 .

编写ingress.yaml

# An Ingress with 2 hosts and 3 endpoints
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: echomap
spec:
backend:
serviceName:
servicePort: 80
rules:
- host: caas.one
http:
paths:
- path: /kibana
backend:
serviceName: kibana
servicePort: 5601
- host: jingru.io
http:
paths:
- path: /es
backend:
serviceName: elasticsearch
servicePort: 9200

在kubernetes集群中创建ingress控制器

apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
name: nginx-ingress-lb
spec:
template:
metadata:
labels:
name: nginx-ingress-lb
spec:
terminationGracePeriodSeconds: 60
containers:
- image: nginx-ingress-controller:0.5
name: nginx-ingress-lb
imagePullPolicy: Always
livenessProbe:
httpGet:
path: /healthz
port: 10249
scheme: HTTP
initialDelaySeconds: 30
timeoutSeconds: 5
# use downward API
env:
- name: POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
- name: POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
ports:
- containerPort: 80
hostPort: 80
- containerPort: 443
hostPort: 4444
args:
- /nginx-ingress-controller
- --default-backend-service=default/default-http-backend

使用命令kubectl -f ingress.yaml/nginx-ingress-controller.yaml把Ingress和Ingress控制器发布到kubernetes集群中。

下图展示了从浏览器经过Ingress控制器到ingress再到service再到pod的全过程：

推荐阅读：

Kubernetes 1.2 新功能介绍：DaemonSet

Kubernetes 1.2 新功能介绍：Deployment

Kubernetes 1.2 新功能介绍：Limit Range和Resource Quota

Kubernetes 1.2 新功能介绍：ConfigMap

Kubernetes 1.2 新功能介绍：自动扩容算法