最近开始阅读《Kubernetes权威指南》这本书,书上有一个单节点k8s的小例子,所以就跟着书上的步骤以及这篇博客http://lihaoquan.me/2017/2/25/create-kubernetes-single-node-mode.html操作了一遍,现在把这个过程记录下来,对k8s有一个较直观的认识。

这是一个简单的Java Web应用,结构简单,是一个运行在Tomcat里的Web App,JSP页面通过JDBC直接访问MySQL数据库并展示数据。

此应用需要启动两个容器:Web App容器和MySQL容器,并且Web App容器需要访问MySQL容器。

1.环境准备

这次实验使用的环境是Centos7, IP地址为10.0.0.73

(1)yum源

刚开始我虚拟机的yum源是清华大学的,后面换了个阿里云的yum源。我是为了和博客保持一致,不换源应该也是可以的(有待验证)。

换源操作:

备份

mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup



下载新的CentOS-Base.repo到 /etc/yum.repos.d



wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo



最后运行



yum makecache



(2)关闭防火墙

centos7自带firewall的防火墙业务,而k8s的master与工作node之间会有大量的网络通信,安全的做法实在防火墙上配置各种需要相互通信的端口号,比如后面用到的3306,30001等端口。本文仅做一个学习过程,所以直接关闭防火墙服务。



systemctl disable firewalld.service
systemctl stop firewalld.service



2.安装和配置k8s

(1)安装etcd和k8s软件(安装过程中会自动安装Docker软件)



yum install -y etcd kubernetes



(2)配置修改

安装完成后,需要修改相关配置



nano /etc/sysconfig/docker



将其中的OPTIONS的内容设置为:OPTIONS='--selinux-enabled=false --insecure-registry gcr.io'



nano /etc/kubernetes/apiserver



KUBE_ADMISSION_CONTROL选项中去掉ServiceAccount选项。否则在后面的pod创建中,会报错。

(3)切换docker hub镜像源

为了稳定pull镜像,使用Daocloud的镜像服务



curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://dbe35452.m.daocloud.io



(4)按顺序启动所有服务



systemctl start etcd
systemctl start docker



在启动docker是遇到了如下错误:

KESV8 witness节点是必需的吗_Pod

运行命令查看docker服务



systemctl status docker.service



KESV8 witness节点是必需的吗_Pod_02

试了很多方法都不行后,在这个链接下面找到了答案。原来由于上面切换了docker hub源导致的问题。将/etc/docker/daemon.json中 {"registry-mirrors": ["http://34df6785.m.daocloud.io"],} 后面的逗号去掉就可以。



nano /etc/docker/daemon.json



KESV8 witness节点是必需的吗_Pod_03

继续启动剩下的服务



systemctl start kube-apiserver.service
systemctl start kube-controller-manager.service
systemctl start kube-scheduler.service
systemctl start kubelet.service
systemctl start kube-proxy.service



到目前为止,一个单机版的k8s环境就跑起来了。

3.启动MySQL容器服务

(1)先拉去mysql的服务镜像:



docker pull mysql



(2)启动MySQL服务

首先为MySQL服务创建一个RC定义文件:mysql-rc.yaml。RC(Replication Controller)定义文件中有3个关键信息:

  • 目标Pod的定义。
  • 目标Pod需要运行的副本数量(Replicas)
  • 要监控的目标Pod的标签(Label),Label是Service和Pod之间的纽带
apiVersion: v1
kind: ReplicationController                            #副本控制器RC
metadata:
  name: mysql                                          #RC的名称,全局唯一
spec:
  replicas: 1                                          #Pod副本的期待数量
  selector:
    app: mysql                                         #符合目标的Pod拥有此标签
  template:                                            #根据此模板创建Pod的副本(实例)
    metadata:
      labels:
        app: mysql                                     #Pod副本拥有的标签,对应RC的Selector
    spec:
      containers:                                      #Pod内容器的定义部分
      - name: mysql                                    #容器的名称
        image: hub.c.163.com/library/mysql              #容器对应的Docker image
        ports: 
        - containerPort: 3306                          #容器应用监听的端口号
        env:                                           #注入容器内的环境变量
        - name: MYSQL_ROOT_PASSWORD 
          value: "123456"



创建好mysql-rc.yaml后,在master节点使用kubectl命令将它发布到k8s集群中。



kubectl create -f mysql-rc.yaml



KESV8 witness节点是必需的吗_运维_04

接下来使用kubectl命令查看刚刚创建的RC:

KESV8 witness节点是必需的吗_mysql_05

使用下面命令查看Pod的创建情况:

KESV8 witness节点是必需的吗_mysql_06

可见Pod的状态处于ContainerCreating,需要等到状态为Runing才算成功。我在这里碰到了一个bug,Pod一直处在ContainerCreating状态。博客提供了定位这种问题的方法。通过“kubectl describe pod PodName”指令查看pod发生的事件,从输出中查看错误信息。我这边的输出是:

KESV8 witness节点是必需的吗_数据库_07

然后根据博客提供的解决办法,安装rhsm(我也不知道这个是干什么的,就是红帽的一个软件)



yum install *rhsm*



然后再运行



kubectl delete -f mysql-rc.yaml
kubectl create -f mysql-rc.yaml
kubectl get pods



发现Pod已经跑起来了。

KESV8 witness节点是必需的吗_mysql_08

(3)创建关联Service

最后,我们创建一个与之关联的Kubernetes Service-MySQL的定义文件:mysql-svc.yaml



apiVersion: v1                      
kind: Service                              #表明是K8s Service
metadata: 
  name: mysql                              #Service的全局唯一名称
spec:
  ports:
    - port: 3306                           #Service提供服务的端口号
  selector:                                #Service对应的Pod拥有这里定义的标签
    app: mysql



spec.selector确定了哪些Pod副本(实例)对应到本服务。类似地,我们通过kubectl create命令创建Service对象。

运行kubectl命令,创建service:



kubectl create -f mysql-svc.yaml



再运行如下状态,查看刚刚创建的service:



kubectl get svc



KESV8 witness节点是必需的吗_mysql_09

注意到MySQL服务被分配到了一个值为10.254.152.247的Cluster IP地址,这是一个虚地址,随后,k8s集群中其他新创建的Pod就可以通过Service的Cluster IP+端口号3306来连接和访问它了。现在我们只需知道,根据Service的唯一名字,容器可以从环境变量中获取到Service对应的Cluster IP地址和端口,从而发起TCP/IP连接请求了。

 到这里,MySQL容器服务就启动了。小结下创建过程,首先,拉取服务镜像,然后创建RC定义文件,再发布到k8s中,可以看到pod被创建。最后创建一个与之关联的k8s Service,也是通过.yaml文件和kubectl create命令创建。当然,这其中还牵扯到很多概念,比如说Pod和Service之间的联系等等,这个要另起篇幅。

4.启动Web容器服务

有了上面启动MySQL容器服务的经验,我们来启动Web容器服务,过程是一样的。

(1)先拉取一个测试镜像到本地



docker pull kubeguide/tomcat-app:v1



KESV8 witness节点是必需的吗_mysql_10

(2)创建对应的RC文件myweb-rc.yaml,内容如下:



apiVersion: v1
kind: ReplicationController
metadata:
  name: myweb
spec:
  replicas: 5                                       #Pod副本期待数量为5
  selector:
    app: myweb
  template:
    metadata:
      labels:
        app: myweb
    spec:
      containers:
      - name: myweb
        image: docker.io/kubeguide/tomcat-app:v1
        ports: 
        - containerPort: 8080
        env:
        - name: MYSQL_SERVICE_HOST
          value: "mysql"
        - name: MYSQL_SERVICE_PORT
          value: "3306"



然后通过kubectl create命令完成RC的创建和验证工作:



kubectl create -f myweb-rc.yaml
kubectl get rc
kubectl get pods



KESV8 witness节点是必需的吗_Pod_11

从输出看到,在RC中声明了5个Pod期待的数量,现在都已经建立并运行起来了,可以看出k8s在自动升级,扩容等方面带来的优势了。

(3)创建对应的Service

最后,创建对应的Service,以下是完整的yaml定义文件(myweb-svc.yaml):



apiVersion: v1
kind: Service
metadata: 
  name: myweb
spec:
  type: NodePort
  ports:
    - port: 8080
      nodePort: 30001
  selector:
    app: myweb



type=NodePort和nodePort=30001的两个属性,表明此Service开启了NodePort方式的外网访问模式。在k8s集群之外,比如在本机的浏览器里,可以通过30001这个端口访问myweb(对应到8080的虚端口上)。所以前面要关闭防火墙。

运行kubectl create命令进行创建:

kubectl create  -f myweb-svc.yaml



最后,使用kubectl查看前面创建的Service

kubectl get services



KESV8 witness节点是必需的吗_Pod_12

5.验证与总结

通过上面的几个步骤,我们可以成功实现了一个简单的k8s单机版例子。有两种方法验证我们的结果。

首先,可以在本机浏览器中输入http://10.0.0.73:30001/demo/来测试我们发的web应用。然而,很不幸,报错了:

KESV8 witness节点是必需的吗_json_13

报了一个JDBC连接的错误。如果网页能打开的话,是有一个表格并且可以进行操作的。按书上的说法,看不到网页有几个原因:比如防火墙的问题,无法访问30001端口,或者是因为通过代理上网的,浏览器错把这个虚拟机的IP地址当成远程地址了。所以有了第二种验证方法,直接运行如下命令:



curl http://10.0.0.73:30001



输出为:

KESV8 witness节点是必需的吗_数据库_14

 

 我网上看其他教程也大都是采取这种方式验证的,所以就这样吧,虽然成就感小了一点,但毕竟还是跑起来了。重要的是对k8s有一个了解,学习使用它。