yaml文件详解

一、yaml文件详解

前言

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

YAML 语法格式：
●大小写敏感
●使用缩进表示层级关系
●不支持Tab键制表符缩进，只使用空格缩进
●缩进的空格数目不重要，只要相同层级的元素左侧对齐即可，通常开头缩进两个空格
●符号字符后缩进一个空格，如冒号，逗号，短横杆（-）等
●“---”表示YAML格式，一个文件的开始，用于分隔文件间
●“#”表示注释

（1）查看api资源版本标签

 1 kubectl api-versions

 2 admissionregistration.k8s.io/v1beta1

 3 apiextensions.k8s.io/v1beta1

 4 apiregistration.k8s.io/v1

 5 apiregistration.k8s.io/v1beta1

 6 apps/v1                                #如果是业务场景一般首选使用 apps/v1

 7 apps/v1beta1                        #带有beta字样的代表的是测试版本，不用在生产环境中

 8 apps/v1beta2

 9 authentication.k8s.io/v1

10 authentication.k8s.io/v1beta1

11 authorization.k8s.io/v1

12 authorization.k8s.io/v1beta1

13 autoscaling/v1

14 autoscaling/v2beta1

15 autoscaling/v2beta2

16 batch/v1

17 batch/v1beta1

18 certificates.k8s.io/v1beta1

19 coordination.k8s.io/v1beta1

20 events.k8s.io/v1beta1

21 extensions/v1beta1

22 networking.k8s.io/v1

23 policy/v1beta1

24 rbac.authorization.k8s.io/v1

25 rbac.authorization.k8s.io/v1beta1

26 scheduling.k8s.io/v1beta1

27 storage.k8s.io/v1

28 storage.k8s.io/v1beta1

29 v1

（2）写一个yaml文件demo

mkdir /opt/demo

cd demo/

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

kubectl apply -f nginx-deployment.yaml
kubectl get deploy -n kube-public

//查看创建的pod资源

kubectl get pods -o wide

NAME                              READY   STATUS    RESTARTS   AGE    IP            NODE            NOMINATED NODE

nginx-deployment-d55b94fd-29qk2   1/1     Running   0          7m9s   172.17.36.4   192.168.80.12   <none>

nginx-deployment-d55b94fd-9j42r   1/1     Running   0          7m9s   172.17.36.3   192.168.80.12   <none>

nginx-deployment-d55b94fd-ksl6l   1/1     Running   0          7m9s   172.17.26.3   192.168.80.11   <none>

（3）创建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.0.0.1     <none>        443/TCP        16d

nginx-service   NodePort    10.0.0.119   <none>        80:35680/TCP   14s

//在浏览器输入 nodeIP:nodePort 即可访问

http://192.168.10.10:35680

http://192.168.10.10:35680

------------------------------------------------------------------------------------------
详解k8s中的port：
●port
port 是 k8s 集群内部访问service的端口，即通过 clusterIP: 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。
------------------------------------------------------------------------------------------

（4）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

（5）查看生成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

（6）查看生成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

（7）使用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

案例：

vim nginx-test.yaml

apiVersion: v1

kind: Pod

metadata:

  creationTimestamp: null     #删除

  labels:

    run: nginx-test

  name: nginx-test

spec:

  containers:

  - image: nginx

    name: nginx-test

    ports:

    - containerPort: 80

    resources: {}             #删除

  dnsPolicy: ClusterFirst

  restartPolicy: Always

status: {}                    #删除

（8）将现有的资源生成模板导出

kubectl get svc nginx-service -o yaml

（9）保存到文件中

kubectl get svc nginx-service -o yaml > my-svc.yaml

（10）查看字段帮助信息，可一层层的查看相关资源对象的帮助信息

kubectl explain deployments.spec.template.spec.containers

或

kubectl explain pods.spec.containers

（11）写yaml太累怎么办？

●用 --dry-run 命令生成
kubectl run my-deploy --image=nginx --dry-run=client -o yaml > my-deploy.yaml

●用get命令导出
kubectl get svc nginx-service -o yaml > my-svc.yaml
或
kubectl edit svc nginx-service #复制配置，再粘贴到新文件

（12）yaml文件的学习方法

多看别人（官方）写的，能读懂
能照着现场的文件改着用
遇到不懂的，善用kubectl explain ... 命令查

巴特西