K8SYaml文件详解（云原生）

一、K8S支持的文件格式

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

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

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

易读

1、yaml和json的主要区别

• YAML 使用空格缩进，这是 Python 开发人员熟悉的领域。
• JavaScript 开发人员喜欢 JSON，因为它是 JavaScript 的一个子集，可以直接在
• JavaScript中解释和编写，同时使用简写方式声明 JSON，在使用没有空格的典型变量名时，不需要键中的双引号。
• 有很多解析器在 YAML 和 JSON 的所有语言中都能很好地工作。
• 在许多情况下，YAML 的空白格式可以更容易查看，因为格式化需要更人性化的方法。
  如果您的编辑器中没有空格可见或缩进线指示符，那么 YAML 的空白虽然更紧凑，更容易查看，但可能难以手动编辑。
• JSON 的序列化和反序列化要快得多，因为要检查的功能明显少于 YAML，这使得更小更轻的代码能够处理 JSON。
• 一个常见的误解是 YAML 需要较少的标点符号并且比 JSON更紧凑，但这完全是错误的。空格是不可见的，所以看起来字符较少，但是如果你计算实际的空格是必要的，以便正确解释 YAML以及正确的缩进，你会发现 YAML 实际上需要比 JSON 更多的字符。JSON不使用空格来表示层次结构或分组，并且可以通过删除不必要的空格来轻松展平，以实现更紧凑的传输。

2、YAML语言格式

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

二、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 --validate=false

2.3 查看创建的pod资源

 

kubectl get pods -o wide

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

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

 

[root@master ~]# vim 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 访问测试

访问nginx-test的ip

 

curl 10.96.28.172:80 curl 192.168.160.40:32139

三、详解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

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

1、–dry-run：试运行

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

 

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

2、查看生成yaml格式

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

 

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

3、查看生成json格式

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

 

kubectl run dryrun-test --image=nginx --port=80 --replicas=3 --dry-run -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

五、总结

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

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

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

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

写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  #复制配置，再粘贴到新文件

yaml文件的学习方法：

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