【云原生之K8s】 YAML文件详解

---

---

一、K8s支持的文件格式

kubernetes支持YAML和JSON文件格式管理资源对象

• JSON格式：主要用于api接口之间消息的传递
• YAML格式用于配置和管理，YAML是一种简洁的非标记性语言，内容格式人性化，较易读

1.YAML和JSON的主要区别

1、YAML使用空格缩进，这是Python开发人员熟悉的领域

2、JavaScript开发人员喜欢JSON，因为它是JavaScript的一个子集，可以直接在JavaScript中解释和编写，同时使用简写方式声明JSON，在使用没有空格的典型变量名时，不需要键中的双引号

3、有很多解释器在YAML和JSON的所有语言中都能很好的工作

4、在许多情况下，YAML的空白格式可以更容易查看，因为格式化需要更人性化的方法

5、如果您的编辑器中没有空格可见或缩进线指示符，那么YAML的空白虽然更紧凑，更容易查看，但可能难以手动编辑

6、JSON的序列化和反序列化要快得多，因为要检查的功能明显少于YAML，这使得更小更轻的代码能够处理JSON

7、一个常见的误解是YAML需要较少的标点符号并且比JSON更紧凑，但这完全是错误的。空格是不可见的，所以看起来字符较少，但是如果你计算实际的空格是必要的，以便正确解释YAML以及正确的缩进，你会发现YAML实际上需要比JSON更多的字符。JSON不使用空格来表示层次结构或分组，并且可以通过删除不必要的空格来轻松展平，以实现更紧凑的传输

2.YAML语言格式

1. 大小写敏感
2. 使用缩进表示层级关系
3. 不支持Tab键制表符缩进，只使用空格缩进
4. 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可，通常开头缩进两个空格
5. 符号字符后缩进一个空格，如冒号，逗号，短横杠(-)等
6. —表示YAML格式，一个文件的开始，用于分隔文件
7. #表示注释

二、YAML

1.查看API资源版本标签

kubectl api-versions

2.编写资源配置清单

2.1 编写nginx-test.yaml资源配置文件

vim nginx-test.yaml
 
#指定api版本标签
apiVersion: apps/v1
#定义资源的类型/角色，deployment为副本控制器
#此处资源类型可以是Deployment、Job、Ingress、Service等
kind: Deployment
#定义资源的元数据信息，比如资源的名称、namespace、标签等信息
metadata:
#定义资源的名称，在同一个namespace空间中必须是唯一的
  name: nginx-deployment
  labels:
    app: nginx
#定义deployment资源需要的参数属性，诸如是否在容器失败时重新启动容器的属性
spec:
#定义副本数量
  replicas: 3
#定义标签选择器
  selector:
#定义匹配标签
    matchLabels:
#需与后面的.spec.template.metadata.labels定义的标签保持一致
      app: nginx
#定义业务模板，如果有多个副本，所有副本的属性会按照模板的相关配置进行匹配
  template:
    metadata:
#定义Pod副本将使用的标签，需与前面的.spec.selector.matchLabels定义的标签保持一致
      labels:
        app: nginx
    spec:
#定义容器属性
      containers:
#定义一个容器名，一个-name:定义一个容器
      - name: nginx
#定义容器使用的镜像以及版本
        image: nginx:1.15.4
        ports:
#定义容器对外的端口
        - containerPort: 80
 
#------------------------------------------------------------------#
#无注释
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
  labels:
    app: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.15.4
        ports:
        - containerPort: 80

2.2 创建资源对象

kubectl create -f nginx-test.yaml

2.3 查看创建的pod资源

kubectl get pods -o wide

3.创建service服务对外提供访问并测试

3.1 编写nginx-svc-test.yaml文件

apiVersion: v1
kind: Service
metadata:
  name: nginx-svc
  labels:
    app: nginx
spec:
  type: NodePort
  ports:
  - port: 80
    targetPort: 80
  selector:
#此处定义的selector要与deployment所定义的selector相同
#service依靠标签选择器来检索提供服务的nodes
    app: nginx

3.2 创建资源对象

kubectl create -f nginx-svc-test.yaml
kubectl get svc

3.3 访问测试

三、详解K8s中的port

port

• port是K8s集群内部访问service的端口，即通过cluserIP:port可以从Pod所在的Node上访问到service

nodePort

• nodePort是外部访问K8s集群中service的端口，通过nodeIP:nodePort可以从外部访问到service

targetPort

• targetPort是Pod的端口，从port或nodePort来的流量经过kube-proxy反向代理负载均衡转发到后端Pod的targetPort上，最后进入容器

containerPort

• containerPort是Pod内部容器的端口，targetPort映射到containerPort

四、试运行生成yaml模板后创建实例

1.–dry-run：试运行

–dry-run：表示试运行，不真正执行命令（测试命令是否正确），即并不会真的创建出pod和deployment实例，去掉该参数后即可真正执行命令

kubectl create deployment dryrun-test --image=nginx --port=80 --replicas=3 --dry-run=client
#打印相应的 API 对象而不执行创建

2.查看生成yaml格式

使用 --dry-run 试运行可不触发生成命令，然后通过 -o yaml 可实现对其 yaml 资源配置清单的查看

kubectl create deployment dryrun-test --image=nginx --port=80 --replicas=3 --dry-run=client -o yaml

3.查看生成json格式

可通过-o json 查看该命令产生的json配置清单

kubectl create deployment dryrun-test --image=nginx --port=80 --replicas=3 --dry-run=client -o json

4.使用yaml格式导出生成模板

kubectl create deployment dryrun-test --image=nginx --port=80 --replicas=3 --dry-run=client -o yaml > dryrun-test.yaml

5.使用yaml模板创建实例

kubectl apply -f dryrun-test.yaml
kubectl get pod,deploy

6.将现有资源生成yaml模板导出并保存为文件

kubectl get deploy dryrun-test -o yaml
kubectl get deploy dryrun-test -o yaml > export-test.yaml

7.查看字段帮助信息

explain 可一层层的查看相关资源对象的帮助信息

kubectl explain deployments.spec.template.spec.containers

kubectl explain pods.dpec.containers

---

总结

没有相关资源，使用 run 命令 --dry-run=client 选项

kubectl run dryrun-test --image=nginx --port=80 --replicas=3 --dry-run=client -o yaml > dryrun-test.yaml

已有相关资源，使用get命令 --export选项

kubectl get deploy dryrun-test --export -o yaml > export-test.yaml