【Kubernetes】Kubernetes之YAML文件详解

向右看齐 2024-03-23 20:00 88阅读 0赞

#### YAML ####

*  一、YAML 的概述
 *   *  1. Kubernetes 支持资源管理格式
     *  2. YAML 语法格式
 *  二、YAML 文件
 *   *  1. 如何获取 api 资源相关信息
     *  2. 编写资源配置文件
     *   *  2.1 手动编写 yaml 文件
         *   *  详解K8S中的port
         *  2.2 使用镜像生成 yaml 文件
         *  2.3 根据现有资源导出 yaml 文件
 *  总结
 *   *  1. 如何获取资源清单文件（yaml配置文件）
     *  2. 如何设置流量发送给本机或者其他节点的Pod

--------------------

## 一、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

![在这里插入图片描述][6da0a16bbf8946c589d1b989e220d4b1.png_pic_center]

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

![在这里插入图片描述][aada0c49b3724e6b951c703e15335d91.png_pic_center]

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

![在这里插入图片描述][f97ff91b55f14a6a83477c64415d9a47.png_pic_center]

### 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		#定义容器的对外的端口

![在这里插入图片描述][040a18536a874047b01c6dd2b34b15b3.png_pic_center]

#创建资源对象
    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>

![在这里插入图片描述][cd9db13b11574883a261f85693f397ec.png_pic_center]

**编写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

![在这里插入图片描述][e437ee14a8da4464b1cb9af53362b57d.png_pic_center]

#创建资源对象
    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

![在这里插入图片描述][99aec89465b34949ab3b2eef16a5f185.png_pic_center]

![在这里插入图片描述][62be9635e44e49fd87f30b6f40e7c376.png_pic_center]

##### 详解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

![在这里插入图片描述][c9c958591ef24e9385a69666d500212a.png_pic_center]

#查看生成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

![在这里插入图片描述][b789ae2bea2745f79821252a45a46cb5.png_pic_center]

#查看生成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

![在这里插入图片描述][31e6bf3b23a54eb894eda80fc1981cf4.png_pic_center]

#使用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

![在这里插入图片描述][c6672aef883d4715a0c9f7eb90371f46.png_pic_center]

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

#将现有的资源生成模板导出
    kubectl get svc nginx-service -o yaml
    
    #保存到文件中
    kubectl get svc nginx-service -o yaml > my-svc.yaml		#删除不需要的字段

![在这里插入图片描述][3fdce5c6fff24ec5a6fb8240326749e9.png_pic_center]

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

![在这里插入图片描述][8f88166394ab4b36b2395071c4dafd1f.png_pic_center]

## 总结 ##

### 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

[6da0a16bbf8946c589d1b989e220d4b1.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/80996f81382e4dceb12eeebceedef815.png
[aada0c49b3724e6b951c703e15335d91.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/9d3e8e67c4ac462193c9bd42c6ecf4c1.png
[f97ff91b55f14a6a83477c64415d9a47.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/2ae771ba2f324cf39b226bf452df9bb1.png
[040a18536a874047b01c6dd2b34b15b3.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/af617253f0d34f3ba6f9dc6500391895.png
[cd9db13b11574883a261f85693f397ec.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/db388adea9444f0a928935418ccaf72c.png
[e437ee14a8da4464b1cb9af53362b57d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/39e40e24aba441b9ab48ab6e2f133079.png
[99aec89465b34949ab3b2eef16a5f185.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/8874eb7e40e34e8b8379cbc0e4d933e6.png
[62be9635e44e49fd87f30b6f40e7c376.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/0e46348939e04dfeb3708d5a1b1f6b0a.png
[c9c958591ef24e9385a69666d500212a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/2f498bf737ba4e0f9807bf99391da491.png
[b789ae2bea2745f79821252a45a46cb5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/edafcce5c91b4a9d8781c1ab4410e1f4.png
[31e6bf3b23a54eb894eda80fc1981cf4.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/286631a33bc74107aeea5367e83b7937.png
[c6672aef883d4715a0c9f7eb90371f46.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/2fd8e467982041c8a0a1a906de01592b.png
[3fdce5c6fff24ec5a6fb8240326749e9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/828f16492a6a44e282ef35e3303ac8cf.png
[8f88166394ab4b36b2395071c4dafd1f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/7f43d0a1c75d4ac7a504254dc992eb40.png