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 ... 命令查