【Kubernetes】Kubernetes之YAML文件详解

---

一、YAML 的概述

1. Kubernetes 支持资源管理格式

Kubernetes 支持 YAML 和 JSON 格式管理资源对象

• JSON 格式：主要用于 api 接口之间消息的传递

• YAML 格式：用于配置和管理，YAML 是一种简洁的非标记性语言，内容格式人性化，较易读

2. YAML 语法格式

• 大小写敏感

• 使用缩进表示层级关系

• 不支持Tab键制表符缩进，只使用空格缩进

• 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可，通常开头缩进两个空格

• 符号字符后缩进一个空格，如冒号，逗号，短横杆（-）等

• “—”表示YAML格式，一个文件的开始，用于分隔文件间

• “#”表示注释

二、YAML 文件

1. 如何获取 api 资源相关信息

#查看 api 资源版本标签
kubectl api-versions
admissionregistration.k8s.io/v1
admissionregistration.k8s.io/v1beta1
apiextensions.k8s.io/v1
apiextensions.k8s.io/v1beta1
apiregistration.k8s.io/v1
apiregistration.k8s.io/v1beta1 
apps/v1
authentication.k8s.io/v1
authentication.k8s.io/v1beta1
authorization.k8s.io/v1
authorization.k8s.io/v1beta1
autoscaling/v1
autoscaling/v2beta1
autoscaling/v2beta2
batch/v1
batch/v1beta1
certificates.k8s.io/v1
certificates.k8s.io/v1beta1
coordination.k8s.io/v1
coordination.k8s.io/v1beta1
discovery.k8s.io/v1beta1
events.k8s.io/v1
events.k8s.io/v1beta1
extensions/v1beta1
flowcontrol.apiserver.k8s.io/v1beta1
networking.k8s.io/v1
networking.k8s.io/v1beta1
node.k8s.io/v1
node.k8s.io/v1beta1
policy/v1beta1
rbac.authorization.k8s.io/v1
rbac.authorization.k8s.io/v1beta1
scheduling.k8s.io/v1
scheduling.k8s.io/v1beta1
storage.k8s.io/v1
storage.k8s.io/v1beta1
v1

#查看资源所需要的版本
kubectl api-resources

#查看字段帮助信息，可一层层的查看相关资源对象的帮助信息#获取资源及其字段的文档
kubectl explain XXXX

例如
kubectl explain deployment		#查看资源字段文档
kubectl explain deployment.metadata

2. 编写资源配置文件

mkdir /opt/demo
cd demo/

2.1 手动编写 yaml 文件

编写deployment文件

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

#创建资源对象
kubectl create -f nginx-deployment.yaml

#查看创建的pod资源
kubectl get pods -o wide
NAME                                READY   STATUS    RESTARTS   AGE    IP           NODE     NOMINATED NODE   READINESS GATES
nginx-5658bdf5d4-k9pjg              1/1     Running   0          134m   10.244.2.8   node02   <none>           <none>
nginx-deployment-746ccc65d8-6rkbg   1/1     Running   0          58s    10.244.2.9   node02   <none>           <none>
nginx-deployment-746ccc65d8-b2vp5   1/1     Running   0          58s    10.244.1.9   node01   <none>           <none>
nginx-deployment-746ccc65d8-nn449   1/1     Running   0          58s    10.244.1.8   node01   <none>           <none>

编写service文件

#创建service服务对外提供访问并测试
vim nginx-service.yaml
apiVersion: v1  
kind: Service  
metadata:
  name: nginx-service
  labels:
    app: nginx  
spec:
  type: NodePort  
  ports:
  - port: 80
    targetPort: 80  
  selector:
    app: nginx

#创建资源对象
kubectl create -f nginx-service.yaml 

#查看创建的service
kubectl get svc
NAME            TYPE        CLUSTER-IP    EXTERNAL-IP   PORT(S)        AGE
kubernetes      ClusterIP   10.96.0.1     <none>        443/TCP        178m
nginx-service   NodePort    10.96.77.77   <none>        80:31636/TCP   19s

#在浏览器输入 nodeIP:nodePort 即可访问
http://192.168.145.12:31636
http://192.168.145.13:31636

详解K8S中的port

• port：是 k8s 集群内部访问service的端口，即通过 clusterIP: port 可以从 Pod 所在的 Node 上访问到 service。
• nodePort： 是外部访问 k8s 集群中 service 的端口，通过 nodeIP: nodePort 可以从外部访问到某个 service。
• targetPort： 是 Pod 的端口，从 port 或 nodePort 来的流量经过 kube-proxy 反向代理负载均衡转发到后端 Pod 的 targetPort 上，最后进入容器。
• containerPort： 是 Pod 内部容器的端口，targetPort 映射到 containerPort。

2.2 使用镜像生成 yaml 文件

#kubectl run --dry-run=client 打印相应的 API 对象而不执行创建
kubectl run nginx-test --image=nginx --port=80 --dry-run=client			#后续可以修改
kubectl create deployment nginx-deploy --image=nginx --port=80 --replicas=3 --dry-run=client

#查看生成yaml格式
kubectl run nginx-test --image=nginx --port=80 --dry-run=client -o yaml
kubectl create deployment nginx-deploy --image=nginx --port=80 --replicas=3 --dry-run=client -o yaml

#查看生成json格式
kubectl run nginx-test --image=nginx --port=80 --dry-run=client -o json
kubectl create deployment nginx-deploy --image=nginx --port=80 --replicas=3 --dry-run=client -o json

#使用yaml格式导出生成模板，并进行修改以及删除一些不必要的参数
kubectl run nginx-test --image=nginx --port=80 --dry-run=client -o yaml > nginx-test.yaml
kubectl create deployment nginx-deploy --image=nginx --port=80 --replicas=3 --dry-run=client -o yaml  > nginx-deploy.yaml

2.3 根据现有资源导出 yaml 文件

#将现有的资源生成模板导出
kubectl get svc nginx-service -o yaml

#保存到文件中
kubectl get svc nginx-service -o yaml > my-svc.yaml		#删除不需要的字段

#查看字段帮助信息，可一层层的查看相关资源对象的帮助信息
kubectl explain deployments.spec.template.spec.containers
或
kubectl explain pods.spec.containers

总结

1. 如何获取资源清单文件（yaml配置文件）

1） 手撕 yaml 配置文件，可根据 kubectl explain 命令获取字段信息
2） 无中生有的方式： kuectl create|run|expose  ... --dry-run=client  -o yaml > XXX.yaml
3） 查看已存在的资源配置方式：kubectl get <资源类型><资源名称> -n 命令空间 -o yaml > XXX.yaml
  					     kubectl edit <资源类型> <资源名称>  手动复制资源配置，再粘贴到文件中
4） 复制官方文档的资源配置案例							 

2. 如何设置流量发送给本机或者其他节点的Pod

在K8S的service对象（申明一条访问通道）中设置externalTrafficPolicy字段

cluster：默认模式，设置将请求发送给其他节点的pod
local：设置将请求发送给本机的pod