k8s资源清单编写

### 如何编写 Kubernetes 资源清单 YAML 文件 #### 1. 基本结构 Kubernetes 资源清单文件通常由几个核心字段组成，这些字段定义了资源的元数据、规格以及行为。以下是基本结构： ```yaml apiVersion: <API版本> # 定义所使用的 Kubernetes API 版本[^3] kind: <资源类型> # 指定要创建的资源种类，例如 Pod, Service 等 metadata: name: <资源名称> # 设置资源的名字 spec: # 描述资源的具体配置细节 ... ``` #### 2. 实例演示 下面是一个简单的 Pod 配置示例，展示了如何使用上述结构来定义一个容器化的应用程序。 ```yaml apiVersion: v1 # 使用的核心 API 版本 kind: Pod # 创建的对象类型为 Pod metadata: name: my-first-pod # Pod 名称为 my-first-pod spec: containers: - name: nginx-container # 容器名为 nginx-container image: nginx:latest # 使用最新的 Nginx 镜像 ports: - containerPort: 80 # 映射容器端口到主机上的 80 端口 ``` 此示例中，`apiVersion`, `kind`, 和 `metadata.name` 是必需字段，而 `spec.containers` 列表则描述了一个运行 Nginx 的单个容器及其开放的端口号[^4]。 #### 3. 应用资源配置 一旦完成了 YAML 文件的编写，可以利用 kubectl 工具将其应用至集群环境之中。常用命令如下所示： ```bash kubectl apply -f pod.yaml # 将 pod.yaml 中的内容应用于当前上下文中指定的 Kubernetes 集群 ``` 如果希望仅验证而不实际提交更改，则可采用以下方式测试配置的有效性： ```bash helm template --validate . | kubectl api-resources --validate=true -f - ``` 这一步骤能够确保生成的 YAML 文件符合预期的标准并能被 Kubernetes 正确解析[^2]。 #### 4. 更复杂的例子：Deployment 类型 对于更复杂的应用场景，可能需要用到 Deployment 来管理多个副本集和服务扩展等功能。这里提供一段关于 Deployment 的样例代码供参考： ```yaml apiVersion: apps/v1 # 使用 applications API 组合下的 V1 版本 kind: Deployment # 对象类型设置为 Deployment metadata: name: example-deployment # deployment 名字设为例子部署 spec: replicas: 3 # 运行三个实例作为高可用保障 selector: matchLabels: app: webapp # 标签选择器匹配具有特定标签的服务 template: metadata: labels: app: webapp # 添加标签以便于服务发现机制识别 spec: containers: - name: demo-app # 主程序容器命名示范应用 image: nodejs-express-demo # 自定义镜像地址替换此处占位符 ports: - containerPort: 3000 # 开放内部监听端口给外部访问 ``` 以上展示了一种典型的多副本部署模式，其中包含了负载均衡自动恢复等特性支持。