1. Kubernetes资源清单入门指南刚接触Kubernetes时最让我困惑的就是那些YAML文件——它们看起来简单但实际写起来总是报错。资源清单(Manifest)是Kubernetes世界的施工图纸它用声明式语法告诉集群你想要什么样的资源状态。经过多次实践后我总结出这套新手也能快速上手的资源清单编写方法。2. 核心概念解析2.1 什么是资源清单资源清单本质上是YAML或JSON格式的文本文件用于定义Kubernetes对象如Pod、Service等的期望状态。与命令式操作不同你不需要告诉Kubernetes如何做只需声明想要什么。2.2 基础结构剖析每个资源清单都包含以下必填字段apiVersion: v1 # API版本 kind: Pod # 资源类型 metadata: # 元数据 name: my-pod spec: # 期望状态 containers: - name: nginx image: nginx:1.14.2注意缩进必须使用空格而非Tab这是YAML的硬性要求。我建议用2个空格作为缩进单位。3. 完整资源清单编写实战3.1 Pod资源示例下面是一个典型的Pod清单包含了我实际项目中积累的实用配置apiVersion: v1 kind: Pod metadata: name: web-server labels: app: nginx env: prod spec: containers: - name: nginx image: nginx:1.19.0 ports: - containerPort: 80 resources: requests: cpu: 500m memory: 512Mi limits: cpu: 1 memory: 1Gi env: - name: NGINX_ENV value: production restartPolicy: Always关键参数说明resources.requests容器启动的最低资源需求resources.limits容器能使用的资源上限env设置容器环境变量SpringBoot应用常用3.2 Deployment进阶配置对于生产环境我强烈建议使用Deployment而非直接创建PodapiVersion: apps/v1 kind: Deployment metadata: name: frontend spec: replicas: 3 selector: matchLabels: app: web template: metadata: labels: app: web spec: containers: - name: nginx image: nginx:1.19.0 ports: - containerPort: 80 livenessProbe: httpGet: path: / port: 80 initialDelaySeconds: 15 periodSeconds: 20这个配置包含几个生产级特性多副本(replicas: 3)保证高可用livenessProbe实现健康检查selector确保Pod标签匹配4. 环境变量管理技巧4.1 基础环境变量配置在SpringBoot等应用中环境变量配置尤为关键env: - name: JAVA_OPTS value: -Xmx512m -Xms256m - name: SPRING_PROFILES_ACTIVE value: prod - name: DB_URL valueFrom: secretKeyRef: name: db-secret key: connection-string4.2 安全敏感信息处理永远不要将密码等敏感信息直接写在清单中应该使用Secret# 先创建Secret kubectl create secret generic db-secret \ --from-literalusernameadmin \ --from-literalpasswordS!B\*d$zDsb然后在清单中引用env: - name: DB_USERNAME valueFrom: secretKeyRef: name: db-secret key: username - name: DB_PASSWORD valueFrom: secretKeyRef: name: db-secret key: password5. 常见问题排查指南5.1 格式验证与调试我常用的诊断命令# 验证YAML语法 kubectl apply -f pod.yaml --dry-runclient # 查看详细错误 kubectl describe pod/pod-name # 查看容器日志 kubectl logs pod-name -c container-name5.2 典型错误案例镜像拉取失败错误现象ErrImagePull或ImagePullBackOff解决方法检查镜像名称拼写确保镜像仓库可访问CrashLoopBackOff通常表示容器启动后立即退出使用kubectl logs查看应用日志Pending状态资源不足或节点选择器不匹配使用kubectl describe查看事件详情6. 高级技巧与最佳实践6.1 资源请求与限制配置CPU单位说明1 1个vCPU/core500m 0.5个vCPU100m 0.1个vCPU内存单位1Gi 1024Mi512Mi 512MB1G≠ 1Gi前者是1000进制后者是1024进制6.2 使用ConfigMap管理配置对于复杂配置推荐使用ConfigMap# 从文件创建ConfigMap kubectl create configmap nginx-config \ --from-filenginx.conf./nginx.conf在Pod中挂载volumes: - name: config-volume configMap: name: nginx-config containers: - name: nginx volumeMounts: - name: config-volume mountPath: /etc/nginx6.3 多容器Pod设计一个Pod内可以运行多个紧密关联的容器containers: - name: web image: nginx - name: log-collector image: fluentd volumeMounts: - name: logs mountPath: /var/log/nginx volumes: - name: logs emptyDir: {}这种模式常用于边车(Sidecar)容器场景如日志收集、服务网格等。7. 工具链推荐7.1 编辑器插件VS CodeKubernetes插件 YAML扩展IntelliJ IDEAKubernetes插件7.2 校验工具kubeval离线验证YAML文件kubectl neat清理自动生成的字段7.3 模板生成# 快速生成模板 kubectl create deploy nginx --imagenginx --dry-runclient -o yaml deploy.yaml8. 生产环境注意事项资源限制必须设置requests和limits防止单个Pod耗尽节点资源标签规范制定统一的标签策略如app/env/version版本控制所有清单文件必须纳入Git管理变更流程任何修改都应通过CI/CD流水线我在实际运维中发现合理的资源限制可以避免80%的稳定性问题。比如Java应用建议resources: requests: memory: 1Gi cpu: 500m limits: memory: 2Gi cpu: 2这样的配置既保证了应用有足够资源启动又防止内存泄漏时影响整个节点。
