Kubernetes - 实战：API 对象定义、使用 yaml 声明 API 对象、pod 诞生原因及简介、使用 yaml 声明 pod、使用 kubctl 声明 pod、编写 yaml 技巧

在 Kubernetes 中，API 对象是集群内所有资源的核心表示形式。API 对象通过 RESTful API 进行管理和操作，并且通常以 YAML 或 JSON 格式进行声明和持久化存储在 etcd 中。

API 对象定义

API 对象代表了 Kubernetes 中的各种资源类型，比如 Pod、Deployment、Service、ConfigMap、Secret 等。每个 API 对象都有明确的结构和属性，例如 metadata（元数据）、spec（规格）和 status（状态）。下面是一个基本的 API 对象结构示例：

apiVersion: apps/v1
kind: Deployment           # 对象类型（API资源）
metadata:
  name: my-deployment      # 对象名称
  namespace: default       # 对象所在的命名空间
spec:
  replicas: 3              # 指定副本数
  selector:
    matchLabels:
      app: MyApp            # 选择器标签，匹配要管理的Pod
  template:
    metadata:
      labels:
        app: MyApp          # Pod模板的标签
    spec:
      containers:
      - name: my-container  # 容器名称
        image: nginx:1.14.2  # 容器镜像
        ports:
        - containerPort: 80  # 容器暴露端口

Pod 的诞生原因及简介

Pod 是 Kubernetes 中最基本的工作单元，代表集群中能部署和运行的一个或一组紧密相关的容器。Pod 被设计成这样的概念，是因为在实践中往往需要让多个容器共享存储、网络空间和生命周期，形成一个逻辑上的“原子单位”。每个 Pod 都会被分配一个唯一的 IP 地址，Pod 内的容器共享网络命名空间，可以直接通过 localhost 通信。

使用 YAML 声明 Pod

创建一个简单的 Pod 示例：

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
  - name: my-container
    image: busybox
    command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 3600']

上述 YAML 文件声明了一个名为 my-pod 的 Pod，其中包含一个名为 my-container 的容器，该容器使用 busybox 镜像，并执行一个简单的 shell 命令。

使用 kubectl 声明 Pod

使用 kubectl 命令行工具创建 Pod：

kubectl apply -f pod-definition.yaml

这里的 pod-definition.yaml 就是包含了上述 Pod 定义的 YAML 文件。kubectl apply 命令会将 YAML 文件中的资源配置信息发送给 Kubernetes API Server，然后 API Server 会确保集群的实际状态符合所声明的期望状态。

编写 YAML 技巧

• 引用环境变量：可以在 YAML 文件中使用 $ 符号引用环境变量，这对于注入不同环境下的配置非常有用。

• 使用 --- 分隔符：在一个 YAML 文件中可以定义多个资源对象，只需在每个对象之间用 --- 行进行分隔。

• 模板化和参数化：利用 Helm 或 Kustomize 等工具可以方便地对 YAML 进行模板化和参数化处理，以便于复用和批量部署。

• 验证 YAML 格式：在提交前，可以使用 kubectl 自带的验证功能确保 YAML 文件格式正确，例如 kubectl validate -f pod-definition.yaml （请注意，不是所有版本的 kubectl 都支持验证功能，需结合实际情况使用）。

• 注释：YAML 文件支持注释，以 # 开头的行被视为注释，不参与资源配置。这对于记录配置信息和说明用途十分有益。