一、了解YAML文件的基本结构
YAML文件通常由以下四个关键部分组成：
- apiVersion：指定Kubernetes API的版本。
- kind：指定要创建的资源类型。
- metadata：定义资源的元数据，如名称、命名空间等。
- spec：指定资源的规格和配置。
二、掌握YAML格式的基本规范
- 大小写敏感：YAML文件对大小写敏感。
- 缩进：使用缩进表示层级关系，通常使用两个或四个空格，但必须在同一文档中保持一致。不能使用制表符（Tab）进行缩进。
- 冒号和空格：使用冒号加空格（: ）来分隔键和值。
- 列表：使用短横线加空格（- ）来表示列表项。列表项通常会缩进，表示属于上一级的列表。
- 字典：一组键值对的集合。每个键值对都会缩进，表示属于上一级的字典。
- 数据类型：支持字符串、布尔值、整数、浮点数、null、时间、日期等数据类型。字符串通常不需要引号，但如果包含特殊字符，则需要用单引号或双引号括起来。
- 注释：使用井号（#）开头表示注释，注释内容不会被解析。
- 多文档支持：使用三个短横线（---）来分隔文件中的多个文档。
三、编写YAML文件的技巧
-
明确API版本和类型：
在编写YAML文件之前，首先要明确你要创建或配置的资源的API版本和类型。这有助于确保你的YAML文件具有正确的结构，并使用了正确的属性。 -
使用kubectl命令辅助编写：
Kubernetes提供了kubectl命令行工具，可以使用它来生成YAML文件的框架，并了解每个字段的含义。例如：kubectl explain deployment -
避免手动编写YAML：
手动编写YAML文件容易出错，且效率低下。可以使用Kubernetes提供的各种工具和脚本来生成和管理YAML文件，如kubectl、Helm、Kustomize等。 -
验证YAML文件的正确性：
在部署到集群之前，验证YAML文件的正确性非常重要。可以使用Kubernetes提供的验证工具来检查文件中的语法错误和不符合规范的属性。 -
版本控制YAML文件：
与代码一样，YAML文件也应该进行版本控制。使用版本控制系统（如Git）来跟踪和管理你的YAML文件，可以帮助你更好地协作、回滚更改和审计资源配置。 -
遵循最佳实践：
- 使用描述性的字段名和注释来解释配置。
- 遵循一致的命名规范。
- 确保配置与应用程序需求相匹配。
四、代码示例
以下是一些常见的Kubernetes资源对象的YAML文件示例：
1. Pod YAML文件示例
apiVersion: v1
kind: Pod
metadata:
name: my-pod
namespace: default
spec:
containers:
- name: my-container
image: nginx:1.19.2
ports:
- containerPort: 80
这个示例定义了一个名为my-pod的Pod，其中包含一个名为my-container的容器，该容器使用nginx:1.19.2的镜像，并监听80端口。
2. Deployment YAML文件示例
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
namespace: default
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.19.2
ports:
- containerPort: 80
这个示例定义了一个名为nginx-deployment的Deployment，它创建了3个副本的Pod，每个Pod都包含一个名为nginx的容器，该容器使用nginx:1.19.2的镜像，并监听80端口。
3. Service YAML文件示例
apiVersion: v1
kind: Service
metadata:
name: nginx-service
namespace: default
spec:
selector:
app: nginx
ports:
- protocol: TCP
port: 80
targetPort: 80
type: ClusterIP
这个示例定义了一个名为nginx-service的Service，它选择标签为app: nginx的Pod，并将它们暴露为集群内部的Service，监听80端口，并将流量转发到Pod的80端口。
4. Ingress YAML文件示例（HTTP七层路由机制）
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-ingress
namespace: default
spec:
rules:
- host: myapp.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: nginx-service
port:
number: 80
这个示例定义了一个名为my-ingress的Ingress资源，它配置了一个基于主机名myapp.example.com的HTTP路由规则。当请求的主机名为myapp.example.com且路径为/时，将请求转发到名为nginx-service的Service的80端口。
五、高级配置技巧
-
环境变量：
可以通过环境变量的方式将自定义的Linux OS环境变量传递给Pod。env: - name: LOCAL_KEY value: value - name: CONFIG_MAP_KEY valueFrom: configMapKeyRef: name: special-config key: special.type -
资源限制：
可以为Pod中的容器配置CPU和内存的资源限制。resources: requests: cpu: "2" memory: "2048Mi" limits: cpu: "2" memory: "2048Mi" -
健康检查：
可以配置LivenessProbe和ReadinessProbe来检查容器的健康状态。livenessProbe: httpGet: path: /health port: 8080 scheme: HTTP initialDelaySeconds: 60 timeoutSeconds: 5 successThreshold: 1 failureThreshold: 5 readinessProbe: httpGet: path: /health port: 8080 scheme: HTTP initialDelaySeconds: 30 timeoutSeconds: 5 successThreshold: 1 failureThreshold: 5 -
数据持久化：
可以使用PersistentVolumes（PV）和PersistentVolumeClaims（PVC）来实现数据持久化。volumeMounts: - name: log-cache mountPath: /tmp/log volumes: - name: log-cache emptyDir: {} -
配置管理：
可以使用ConfigMaps和Secrets来管理配置信息。configMap: name: example-volume-config items: - key: log-script path: path/to/log-script - key: backup-script path: path/to/backup-script