YAML格式

资源清单

描述

在 Kubernetes 环境下可以使用 kubectl run 运行应用,但是不推荐,而是希望使用资源清单的东西来描述应用,资源清单可以使用 YAML 和 JSON 文件来编写,一般 YAML 更方便阅读

通过一个资源清单文件定义好一个应用后,可以使用 kubectl 工具直接运行

kuebctl create -f xxx.yaml

资源清单提交给了 APIServer,然后集群获取到清单描述的应用信息后存入到 etcd 数据库中,然后 kube-scheduler 组件发现这个时候有一个 Pod 还没有绑定到节点上,就会对这个 Pod 进行一系列的调度,把它调度到一个最合适的节点上,然后把这个节点和 Pod 绑定到一起(写回到 etcd),然后节点上的 kubelet 组件这个时候 watch 到有一个 Pod 被分配过来了,就去把这个 Pod 的信息拉取下来,然后根据描述通过容器运行时把容器创建出来,最后当然同样把 Pod 状态再写回到 etcd 中去

示例:

nginx-deployment.yaml

apiVersion: apps/v1 # API版本
kind: Deployment # API对象类型
metadata:
  name: nginx-deploy
  labels:
    chapter: first-app
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2 # Pod 副本数量
  template: # Pod 模板
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:1.7.9
          ports:
            - containerPort: 80

创建应用:

kubectl apply -f nginx-deployment.yaml
kubectl get pods

创建应用之后可以看到有两个副本,由定义的属性replicas: 2 决定的

可以使用kubectl describe 命令查看资源对象的详细信息

kubectl  describe pod nginx-deploy-75b69bd684-h4sc2  #后面编号随机的

我们可以看到看到很多这个 Pod 的详细信息,比如调度到的节点、状态、IP 等,一般我们比较关心的是下面的 Events 部分,可以看到这个 Pod 是如何创建的

在集群中删除这个应用

kubectl delete -f nginx-deployment.yaml

YAML 文件

YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便,为了方便人类读写,实质上是一种通用的数据串行化格式。

语法规则

  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进时不允许使用Tab键,只允许使用空格
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
  • # 表示注释

结构类型

在 kubernets 中只需要了解以下结构类型

  • Lists(列表)
  • Maps(字典)

Maps

字典,key:value 的键值对,例如:

---
apiVersion: v1
Kind: Pod

转换为 JSON

{
    "apiVersion": "v1",
    "kind": "pod"
}

创建复杂一点的 Maps,

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

metadata 对应的值又可以是一个 Maps,转换为 JSON

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

Lists

列表,也就是一个数组,定义:

args
- Cat
- Dog
- Fish

对应的 JSON 格式:

{
  "args": ["Cat", "Dog", "Fish"]
}

Lists 的子项也可以是 Maps,Maps 的子项也可以是 Lists 如下所示:

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

转换为 JSON 格式如下:

{
  "apiVersion": "v1",
  "kind": "Pod",
  "metadata": {
    "name": "ydzs-site",
    "labels": {
      "app": "web"
    }
  },
  "spec": {
    "containers": [
      {
        "name": "front-end",
        "image": "nginx",
        "ports": [
          {
            "containerPort": "80"
          }
        ]
      },
      {
        "name": "flaskapp-demo",
        "image": "cnych/flaskapp",
        "ports": [
          {
            "containerPort": "5000"
          }
        ]
      }
    ]
  }
}