Kubernetes之YAML文件

时间 2019-11-20

标签 kubernetes yaml 文件繁體版

原文原文链接

1、YAML 基础

YAML是专门用来写配置文件的语言，很是简洁和强大，使用比json更方便。它实质上是一种通用的数据串行化格式。后文会说明定义YAML文件建立Pod和建立Deployment。html

YAML语法规则：node

大小写敏感
使用缩进表示层级关系
缩进时不容许使用Tal键，只容许使用空格
缩进的空格数目不重要，只要相同层级的元素左侧对齐便可
”#” 表示注释，从这个字符一直到行尾，都会被解析器忽略

在Kubernetes中，只须要知道两种结构类型便可：nginx

Lists
Maps

使用YAML用于K8s的定义带来的好处包括：web

便捷性：没必要添加大量的参数到命令行中执行命令
可维护性：YAML文件能够经过源头控制，跟踪每次操做
灵活性：YAML能够建立比命令行更加复杂的结构

YAML Maps

Map顾名思义指的是字典，即一个Key:Value 的键值对信息。例如：docker

---
apiVersion: v1
kind: Pod

注：--- 为可选的分隔符 ，当须要在一个文件中定义多个结构的时候须要使用。上述内容表示有两个键apiVersion和kind，分别对应的值为v1和Pod。json

Maps的value既可以对应字符串也可以对应一个Maps。例如：flask

---
apiVersion: v1
kind: Pod
metadata:
  name: kube100-site
  labels:
    app: web

注：上述的YAML文件中，metadata这个KEY对应的值为一个Maps，而嵌套的labels这个KEY的值又是一个Map。实际使用中可视状况进行多层嵌套。vim

YAML处理器根据行缩进来知道内容之间的关联。上述例子中，使用两个空格做为缩进，但空格的数据量并不重要，只是至少要求一个空格而且全部缩进保持一致的空格数 。例如，name和labels是相同缩进级别，所以YAML处理器知道他们属于同一map；它知道app是lables的值由于app的缩进更大。windows

注意：在YAML文件中绝对不要使用tab键

api

YAML Lists

List即列表，说白了就是数组，例如：

args
 -beijing
 -shanghai
 -shenzhen
 -guangzhou

能够指定任何数量的项在列表中，每一个项的定义以破折号（-）开头，而且与父元素之间存在缩进。在JSON格式中，表示以下：

{
  "args": ["beijing", "shanghai", "shenzhen", "guangzhou"]
}

固然Lists的子项也能够是Maps，Maps的子项也能够是List，例如：

---
apiVersion: v1
kind: Pod
metadata:
  name: kube100-site
  labels:
    app: web
spec:
  containers:
    - name: front-end
      image: nginx
      ports:
        - containerPort: 80
    - name: flaskapp-demo
      image: jcdemo/flaskapp
      ports: 8080

如上述文件所示，定义一个containers的List对象，每一个子项都由name、image、ports组成，每一个ports都有一个KEY为containerPort的Map组成，转成JSON格式文件：

{
  "apiVersion": "v1",
  "kind": "Pod",
  "metadata": {
        "name": "kube100-site",
        "labels": {
            "app": "web"
        },

  },
  "spec": {
        "containers": [{
            "name": "front-end",
            "image": "nginx",
            "ports": [{
                "containerPort": "80"
            }]
        }, {
            "name": "flaskapp-demo",
            "image": "jcdemo/flaskapp",
            "ports": [{
                "containerPort": "5000"
            }]
        }]
  }
}

View Code

2、使用YAML建立Pod

建立Pod

---
apiVersion: v1
kind: Pod
metadata:
  name: kube100-site
  labels:
    app: web
spec:
  containers:
    - name: front-end
      image: nginx
      ports:
        - containerPort: 80
    - name: flaskapp-demo
      image: jcdemo/flaskapp
      ports:
        - containerPort: 5000

上面定义了一个普通的Pod文件，简单分析下文件内容：

apiVersion：此处值是v1，这个版本号须要根据安装的Kubernetes版本和资源类型进行变化，记住不是写死的。
kind：此处建立的是Pod，根据实际状况，此处资源类型能够是Deployment、Job、Ingress、Service等。
metadata：包含Pod的一些meta信息，好比名称、namespace、标签等信息。
spe：包括一些container，storage，volume以及其余Kubernetes须要的参数，以及诸如是否在容器失败时从新启动容器的属性。可在特定Kubernetes API找到完整的Kubernetes Pod的属性。

下面是一个典型的容器的定义：

…
spec:
  containers:
    - name: front-end
      image: nginx
      ports:
        - containerPort: 80
…

上述例子只是一个简单的最小定义：一个名字（front-end）、基于nginx的镜像，以及容器将会监听的指定端口号（80）。

除了上述的基本属性外，还可以指定复杂的属性，包括容器启动运行的命令、使用的参数、工做目录以及每次实例化是否拉取新的副本。还能够指定更深刻的信息，例如容器的退出日志的位置。容器可选的设置属性包括：

name、image、command、args、workingDir、ports、env、resource、volumeMounts、livenessProbe、readinessProbe、livecycle、terminationMessagePath、imagePullPolicy、securityContext、stdin、stdinOnce、tty

了解了Pod的定义后，将上面建立Pod的YAML文件保存成pod.yaml，而后使用Kubectl建立Pod：

$ kubectl create -f pod.yaml
pod "kube100-site" created

可使用Kubectl命令查看Pod的状态

$ kubectl get pods
NAME           READY     STATUS    RESTARTS   AGE
kube100-site   2/2       Running   0          1m

注： Pod建立过程当中若是出现错误，可使用kubectl describe 进行排查。

建立Deployment

上述介绍了如何使用YAML文件建立Pod实例，可是若是这个Pod出现了故障的话，对应的服务也就挂掉了，因此Kubernetes提供了一个Deployment的概念，目的是让Kubernetes去管理一组Pod的副本，也就是副本集，这样就可以保证必定数量的副本一直可用，不会由于某一个Pod挂掉致使整个服务挂掉。

---
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: kube100-site
spec:
  replicas: 2
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: front-end
          image: nginx
          ports:
            - containerPort: 80
        - name: flaskapp-demo
          image: jcdemo/flaskapp
          ports:
            - containerPort: 5000

一个完整的Deployment的YAML文件如上所示，接下来解释部份内容：

注意这里apiVersion对应的值是extensions/v1beta1，同时也须要将kind的类型指定为Deployment。
metadata指定一些meta信息，包括名字或标签之类的。
spec 选项定义须要两个副本，此处能够设置不少属性，例如受此Deployment影响的Pod的选择器等
spec 选项的template其实就是对Pod对象的定义
能够在Kubernetes v1beta1 API 参考中找到完整的Deployment可指定的参数列表
将上述的YAML文件保存为deployment.yaml，而后建立Deployment：

3、使用k8s建立应用

关于k8s的安装，请参考链接：

http://www.javashuo.com/article/p-tyrkcqwa-ke.html

本文就是基于此连接的环境来搭建的。

新建yaml文件

这里使用 jcdemo/flaskapp 镜像，来介绍，如何建立一个flask应用。

登陆到k8s主控端，也就是master节点。新建文件 flask.yaml

vim flask.yaml

内容以下：

apiVersion: extensions/v1beta1
kind: Deployment 
metadata: 
  name: flaskapp-1
spec: 
  replicas: 1
  template: 
    metadata: 
      labels: 
        name: flaskapp-1
    spec: 
      containers: 
        - name: flaskapp-1
          image: jcdemo/flaskapp
          ports:
          - containerPort: 5000

---
apiVersion: v1
kind: Service
metadata:
  name: flaskapp-1
  labels:
    name: flaskapp-1
spec:
  type: NodePort
  ports:
  - port: 5000
    name: flaskapp-port
    targetPort: 5000
    protocol: TCP
    nodePort: 30005
  selector:
    name: flaskapp-1

NodePort方式暴露服务的端口的默认范围（30000-32767）

大概解释一下，这个yaml文件。它分为2部分。蓝色部分提供节点，红色部分暴露服务

为何要分为这2部分呢？由于蓝色部分，只是在 k8s部署了一个pod 节点。那么它对应的服务，好比flask，外部是不能直接访问的。

怎么才能访问呢？必须暴露服务才行。这就比如下面这个命令！

docker run -it -p 30005:5000 flaskapp-port

使用-p 参数将端口映射出来，其余服务器才能访问！

这2个参数，就是要暴露的端口号，使用的是TCP协议

protocol: TCP
nodePort: 30005

检验配置文件的正确性

当你不肯定声明的配置文件是否书写正确时，可使用如下命令要验证：

kubectl create -f flask.yaml --validate

使用--validate只是会告诉你它发现的问题，仍然会按照配置文件的声明来建立资源，除非有严重的错误使建立过程没法继续，如必要的字段缺失或者字段值不合法，不在规定列表内的字段会被忽略。

可使用以下命令检查Deployment的列表：

root@k8s-master001:~# kubectl get deployments
NAME             DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
flaskapp-1       1         1         1            0           18s

查看pod状态

root@k8s-master001:~# kubectl get pods -o wide
NAME                              READY     STATUS              RESTARTS   AGE       IP                NODE
flaskapp-1-84b7f79cdf-bbp4p       0/1       ContainerCreating   0          27s       <none>            k8s-node002

提示正在建立中，等待几秒钟，再次查看

root@k8s-master001:~# kubectl get pods -o wide
NAME                              READY     STATUS    RESTARTS   AGE       IP                NODE
flaskapp-1-84b7f79cdf-bbp4p       1/1       Running   0          31s       192.138.6.130     k8s-node002

若是状态是 Running，而且出现了IP地址，那么表示部署成功了！

若是状态不是Running，查看日志

kubectl describe po flaskapp-1-84b7f79cdf-bbp4p

若是出现错误，须要解决错误，将应用删除，使用命令

这个是单个pod删除

kubectl delete pods flaskapp-1-84b7f79cdf-bbp4p

若是须要删除flaskapp全部的pod，使用命令

kubectl delete -f flask.yaml

若是images更新了，修改yaml文件，从新应用一遍

kubectl apply -f flask.yaml

访问应用

这个时候，就能够访问flask页面了

root@k8s-master001:~# curl http://192.138.6.130:5000/
<html><head><title>Docker + Flask Demo</title></head><body><table><tr><td> Start Time </td> <td>2018-Dec-04 09:25:51</td> </tr><tr><td> Hostname </td> <td>flaskapp-1-84b7f79cdf-bbp4p</td> </tr><tr><td> Local Address </td> <td>192.138.6.130</td> </tr><tr><td> Remote Address </td> <td>192.138.121.64</td> </tr><tr><td> Server Hit </td> <td>2</td> </tr></table></body></html>root@k8s-master001:~#

我想直接使用windows 10访问flask，可不可呢？

不能够！为何？由于个人电脑不能直接访问 192.138.0.0/16 的网络。这个是k8s的pod 网络。

添加路由

首先须要在windows 10 中添加路由，好比：k8s主控端的地址为 192.168.0.102

确保cmd打开时，以管理员身份运行，不然提示没有权限！

在cmd中输入以下命令：

route add 192.138.0.0 MASK 255.255.0.0 192.168.0.121

设置nat规则

登陆到k8s 主控端，添加一个nat规则。

其中 -s 是你的客户端网络，-d 是k8s 的 pod 网络。-o 指定网卡。tunl0是k8s集群，建立的。

iptables -t nat -I POSTROUTING -s 192.168.0.0/24 -d 192.138.0.0/16 -o tunl0 -j MASQUERADE

使用windos 10 访问flask页面，效果以下：

或者使用 http://node_ip:30005 也是能够访问的。

本文参考连接：

https://blog.csdn.net/phantom_111/article/details/79427144