Kubernetes 1.2 新功能介绍:Ingress 原理及实例

20160721161028

什么是Ingress


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

20160721161036

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

20160721161042
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的全过程:

20160721162358

推荐阅读:

Kubernetes 1.2 新功能介绍:DaemonSet

Kubernetes 1.2 新功能介绍:Deployment

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

Kubernetes 1.2 新功能介绍:ConfigMap

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

K8S中文社区微信公众号
分享到:更多 ()

评论 3

评论前必须登录!

 

  1. #2

    lua在哪里,胡闹

    陈伟8年前 (2016-08-20)
  2. #1

    请问这文章能直接跑起来么

    陈伟8年前 (2016-08-22)