K8S 快速入门 - 7-8 k8s yaml详解1 - 《运维学习小结》

yaml语法规则
结构
- Maps：即字典，一个key对应一个value。
- Lists：即列表，说白了就类似数组。
键
Port详解
yaml简单示例
Label与Selector
- label
- Selector
kubectl create与kubectl apply
- kubectl create
- kubectl apply

yaml语法规则

大小写敏感
使用缩进表示层级关系
缩进时不允许使用Tal键，只允许使用空格
缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
”#” 表示注释，从这个字符一直到行尾，都会被解析器忽略
注：- - - 为可选的分隔符，当需要在一个文件中定义多个结构的时候需要使用
结构
Lists
Maps

Maps：即字典，一个key对应一个value。

例如：

---
apiVersion: v1
kind: Pod

Maps的value可以是一个字符串，也可以是一个Maps

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

:::info 上述中的metadata这个key的值为一个Maps，而labels这个key的值是一个Maps。 :::

yaml处理器根据行缩进来知道内容之间的关联，上述例子中，使用两个空格作为缩进，但空格的数量并不重要，至少一个空格并且所有的缩进保持一致的空格数。例如，name和lables是相同缩进级别，因此他们属于同一Maps；app是labels的值应为app缩进更大。

Lists：即列表，说白了就类似数组。

例如：

args
 -beijing
 -shanghai
 -shenzhen
 -guangzhou

:::info 可以知道任何数量的项在列表中，每个项的定义以 - 开头，并且与父元素之间存在缩进。 ::: 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组成。

键

apiVersion

查看可用：kubectl api-versions
官方定义apiVersion分三个类型：alpha/beta/stable

Alpha：未经充分测试，可能存在bug，功能可能随时调整或者删除。
Beta：经过充分测试，功能细节可能会在未来修改。
Stable：稳定版本，将会得到持续支持。

这个键的值有很多，常用的就4-6个。

v1：Kubernetes API的稳定版本，包含很多核心对象：pod、service等。
比如你运行一个nginx-demo，就用v1
apps/v1：包含一些通用的应用层的api组合，如：Deployments，RolingUpdates，andReplicaSets。
batch/v1：包含与批处理和类似作业的任务相关的对象，如：job、cronjob
autoscaling/v1：允许根据不同的资源使用指标自动调整容器
networking.k8s.io/v1：用于ingress
rbac.authorization.k8s.io/v1：用于RBAC

其他：
extensions/v1beta1
deployment等资源在1.6版本时放在这个版本中，后迁入到apps/v1beta2，再到apps/v1中统一管理
certificates.k8s.io/v1beta1
安全认证相关的api组合
authentication.k8s.io/v1
资源鉴权相关的api组合

kind

kind指定对象的类型，如pod、deployment、statefulset、job、cronjob

metadata

metadata常用的配置有 name、namespace，即配置其显示的名字与归属空间。

spec

一个嵌套字典和列表的配置项，也是主要的配置项，支持的子项非常多，根据资源对象的不同，子项会有不同的配置。

apiVersion: v1 #必选，版本号，例如v1
kind: Pod #必选，Pod 
metadata: #必选，元数据 
  name: nginx #必选，Pod名称 
  labels: #自定义标签 
     app: nginx #自定义标签名字 
spec: #必选，Pod中容器的详细定义 
     containers: #必选，Pod中容器列表，一个pod里会有多个容器 
        - name: nginx #必选，容器名称 
          image: nginx #必选，容器的镜像名称 
          imagePullPolicy: IfNotPresent # [Always | Never | IfNotPresent] #获取镜像的策略 Alawys表示下载镜像 IfnotPresent表示优先使用本地镜像，否则下载镜像，Nerver表示仅使用本地镜像 
          ports: #需要暴露的端口库号列表 
          - containerPort: 80 #容器需要监听的端口号 
     restartPolicy: Always # [Always | Never | OnFailure]#Pod的重启策略，Always表示一旦不管以何种方式终止运行，kubelet都将重启，OnFailure表示只有Pod以非0退出码退出才重启，Nerver表示不再重启该Pod

apiVersion: v1
kind: Service
metadata:
  name: service-hello
  labels:
    name: service-hello
spec:
  type: NodePort      #这里代表是NodePort类型的,另外还有ingress,LoadBalancer
  ports:
  - port: 80          #这里的端口和clusterIP(kubectl describe service service-hello中的IP的port)对应，即在集群中所有机器上curl 10.98.166.242:80可访问发布的应用服务。
    targetPort: 8080  #端口一定要和container暴露出来的端口对应，nodejs暴露出来的端口是8081，所以这里也应是8081
    protocol: TCP
    nodePort: 31111   # 所有的节点都会开放此端口30000--32767，此端口供外部调用。
  selector:
    run: hello         #这里选择器一定要选择容器的标签，之前写name:kube-node是错的。

Port详解

port：port是k8s集群内部访问service的端口，即通过clusterIP:port 可以访问到某个service
nodePort：nodePort是外部访问k8s集群中service的端口，通过nodeIP：nodePort可以从外部访问到某个service上
targetPort：targetPort是pod端口，从port和nodePort来的流量经过kube-proxy流入到后端pod的targetPort上，最后进入容器。
containerPort：是pod内部容器的端口，targetPort映射到containerPort

yaml简单示例

deployment

apiVersion: apps/v1   # 1.9.0 之前的版本使用 apps/v1beta2，可通过命令 kubectl api-versions 查看
kind: Deployment    #指定创建资源的角色/类型
metadata:    #资源的元数据/属性
  name: nginx-deployment    #资源的名字，在同一个namespace中必须唯一
spec:
  replicas: 2    #副本数量2
  selector:      #定义标签选择器
    matchLabels:
      app: web-server
  template:      #这里Pod的定义
    metadata:
      labels:    #Pod的label
        app: web-server
    spec:        # 指定该资源的内容  
      containers:  
      - name: nginx      #容器的名字  
        image: nginx:1.12.1  #容器的镜像地址    
        ports:  
        - containerPort: 80  #容器对外的端口

pod

apiVersion: v1
kind: Pod  
metadata:  
  name: pod-redis
  labels:
    name: redis
spec: 
  containers:
  - name: pod-redis
    image: docker.io/redis  
    ports:
    - containerPort: 80 #容器对外的端口

service

apiVersion: v1  
kind: Service  # 指明资源类型是 service
metadata:  
  name: httpd-svc # service 的名字是 httpd-svc
  labels:  
    name: httpd-svc 
spec:  
  ports:  # 将 service 8080 端口映射到 pod 的 80 端口，使用 TCP 协议
  - port: 8080
    targetPort: 80  
    protocol: TCP  
  selector:  
    run: httpd # 指明哪些 label 的 pod 作为 service 的后端

Label与Selector

label

label是k8s中的核心概念，是一组绑定到k8s资源对象上的对key/value对。同一个对象的labels熟悉的key必须唯一。label可以附加到各种资源对象上，如Node，Pod，Service，RC等。
通过给指定的资源对象捆绑一个或多个不用的label来实现多维度的资源分组管理功能，以便于灵活，方便地进行资源分配，调度，配置，部署等管理工作。
示例如下：

版本标签：“release” : “stable” , “release” : “canary”…
环境标签：“environment” : “dev” , “environment” : “production”
架构标签：“tier” : “frontend” , “tier” : “backend” , “tier” : “middleware”
分区标签：“partition” : “customerA” , “partition” : “customerB”…
质量管控标签：“track” : “daily” , “track” : “weekly”

Selector

Label selector是Kubernetes核心的分组机制，通过label selector客户端/用户能够识别一组有共同特征或属性的资源对象。符合这个标签的 Pod 会作为这个 Service 的 backend。

apiVersion: v1
kind: Service
metadata:
  name: hello
  labels:
    app: hello
spec:
  ports:
  - port: 80
    targetPort: 80
  selector:
    app: hello

kubectl create与kubectl apply

kubectl create -f与kubectl apply -f 都可以创建资源

kubectl create

创建新的资源，如果再次运行该命令，则会报错，因为资源名称在名称空间中是唯一的。

kubectl apply

将配置应用于资源，如果资源不存在，那么将会创建。因此kubectl apply可以运行多次。 :::info 就是apply的应用场景更广，比create好用。。。。 :::

7-8 k8s yaml详解1