【K8S系列】Kubernetes 资源对象的 YAML 文件示例及其详细介绍

在 Kubernetes 中，YAML 文件用于定义各种资源对象的配置，包括 Pods、Deployments、Services 等。以下是一些常见 Kubernetes 资源对象的 YAML 文件示例及其详细介绍。

一、Pod

Pod 是 Kubernetes 中最基本的部署单位，通常包含一个或多个容器。

示例 YAML

yaml 复制代码

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
  labels:
    app: my-app
spec:
  containers:
  - name: my-container
    image: nginx:latest
    ports:
    - containerPort: 80

解释

apiVersion: 定义资源的 API 版本。
kind: 资源类型，这里是 Pod。
metadata: 包含资源的元数据，如名称和标签。
spec : 资源的具体规格。
- containers : 定义 Pod 中的容器列表。
  - name: 容器的名称。
  - image: 使用的容器镜像。
  - ports: 容器暴露的端口。

二、Deployment

Deployment 是用于管理 Pod 的高层抽象，支持版本控制和自动化更新。

示例 YAML

yaml 复制代码

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-container
        image: nginx:latest
        ports:
        - containerPort: 80

解释

apiVersion : 这里是 apps/v1，表明使用的 API 版本。
kind: 资源类型，这里是 Deployment。
metadata: 资源的名称。
spec : 资源的具体规格。
- replicas: Pod 的副本数量。
- selector: 用于选择管理的 Pod。
- template: Pod 的模板，定义了 Pod 的元数据和规范。

三、Service

Service 用于定义 Pod 的访问策略，提供负载均衡。

示例 YAML

yaml 复制代码

apiVersion: v1
kind: Service
metadata:
  name: my-service
spec:
  type: ClusterIP
  selector:
    app: my-app
  ports:
  - protocol: TCP
    port: 80
    targetPort: 80

解释

apiVersion: 资源的 API 版本。
kind: 资源类型，这里是 Service。
metadata: 资源名称。
spec : 资源的具体规格。
- type: Service 的类型（如 ClusterIP、NodePort、LoadBalancer）。
- selector: 用于选择与 Service 关联的 Pod。
- ports : 定义服务的端口映射。
  - protocol: 使用的协议。
  - port: Service 的端口。
  - targetPort: Pod 的端口。

四、ConfigMap

ConfigMap 用于存储非机密的配置信息。

示例 YAML

yaml 复制代码

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-config
data:
  DATABASE_URL: "mysql://user:password@hostname:3306/dbname"
  APP_MODE: "production"

解释

apiVersion: 资源的 API 版本。
kind: 资源类型，这里是 ConfigMap。
metadata: 资源名称。
data: 存储的键值对数据。

五、Secret

Secret 用于存储敏感信息，如密码和令牌。

示例 YAML

yaml 复制代码

apiVersion: v1
kind: Secret
metadata:
  name: my-secret
type: Opaque
data:
  password: cGFzc3dvcmQ=  # base64 编码的密码

解释

apiVersion: 资源的 API 版本。
kind: 资源类型，这里是 Secret。
metadata: 资源名称。
type : Secret 的类型，Opaque 是默认值。
data: 存储的键值对数据，值需要进行 base64 编码。

六、Ingress

Ingress 管理外部 HTTP/S 访问到服务。

示例 YAML

yaml 复制代码

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
spec:
  rules:
  - host: my-app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: my-service
            port:
              number: 80

解释

apiVersion: 使用的 API 版本。
kind: 资源类型，这里是 Ingress。
metadata: 资源名称。
spec : 资源的具体规格。
- rules : 定义访问规则。
  - host: 访问的域名。
  - http : HTTP 路由规则。
    - paths: 路由路径和后端服务的映射。

七、综合示例

1. ConfigMap

首先，我们定义一个 ConfigMap 来存储应用的配置信息。

yaml 复制代码

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  DATABASE_URL: "mysql://user:password@hostname:3306/dbname"
  APP_MODE: "production"

2. Secret

然后，我们定义一个 Secret 来存储敏感信息，如数据库密码。

yaml 复制代码

apiVersion: v1
kind: Secret
metadata:
  name: db-secret
type: Opaque
data:
  password: cGFzc3dvcmQ=  # base64 编码的密码

3. Deployment

接下来，定义一个 Deployment 来管理应用的 Pod，使用 ConfigMap 和 Secret。

yaml 复制代码

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  labels:
    app: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app-container
        image: my-app-image:latest
        ports:
        - containerPort: 8080
        env:
        - name: DATABASE_URL
          valueFrom:
            configMapKeyRef:
              name: app-config
              key: DATABASE_URL
        - name: DB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: db-secret
              key: password

4. Service

定义一个 Service，以便其他 Pod 和外部访问可以通过稳定的 IP 和 DNS 名称访问应用。

yaml 复制代码

apiVersion: v1
kind: Service
metadata:
  name: my-app-service
spec:
  type: ClusterIP
  selector:
    app: my-app
  ports:
  - protocol: TCP
    port: 80
    targetPort: 8080

5. Ingress

最后，定义一个 Ingress，以便将外部 HTTP 请求路由到 Service。

yaml 复制代码

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: my-app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: my-app-service
            port:
              number: 80

解释

ConfigMap

ConfigMap 用于存储应用的配置信息。这里定义了数据库连接字符串和应用模式。

Secret

Secret 用于存储敏感信息。密码以 base64 编码的形式存储，以提供安全性。

Deployment

Deployment 定义了应用的 Pods。设置了副本数量为 3，以确保高可用性。
使用 env 字段引用 ConfigMap 和 Secret 中的值。
- DATABASE_URL 从 ConfigMap 中获取。
- DB_PASSWORD 从 Secret 中获取。

Service

Service 将 Pods 暴露为一个网络服务，以便其他 Pods 或外部客户端可以通过服务名称访问应用。
Service 类型为 ClusterIP，表示只在集群内部可访问。

Ingress

Ingress 负责管理外部 HTTP/S 流量的路由。
使用 rules 定义了基于主机名的路由规则。
通过注解配置 NGINX Ingress 控制器的重写目标。

组合部署

将所有这些资源组合在一起后，您可以使用以下命令一次性创建它们（假设您将它们保存为 k8s-setup.yaml 文件）：

bash 复制代码

kubectl apply -f k8s-setup.yaml

当然可以！在 Kubernetes 中，您可以通过在 Deployment 中添加 livenessProbe 和 readinessProbe 来实现健康检查。此外，Kubernetes 默认会在 Pod 失败时自动重启容器，这是一种基本的自我修复机制。

八、健康检查和自动重启机制完整 YAML 示例

以下是包含健康检查和自动重启机制的完整 YAML 示例：

yaml 复制代码

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  DATABASE_URL: "mysql://user:password@hostname:3306/dbname"
  APP_MODE: "production"
---
apiVersion: v1
kind: Secret
metadata:
  name: db-secret
type: Opaque
data:
  password: cGFzc3dvcmQ=  # base64 编码的密码
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  labels:
    app: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app-container
        image: my-app-image:latest
        ports:
        - containerPort: 8080
        env:
        - name: DATABASE_URL
          valueFrom:
            configMapKeyRef:
              name: app-config
              key: DATABASE_URL
        - name: DB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: db-secret
              key: password
        # 添加健康检查
        livenessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /ready
            port: 8080
          initialDelaySeconds: 15
          periodSeconds: 5
---
apiVersion: v1
kind: Service
metadata:
  name: my-app-service
spec:
  type: ClusterIP
  selector:
    app: my-app
  ports:
  - protocol: TCP
    port: 80
    targetPort: 8080
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: my-app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: my-app-service
            port:
              number: 80

解释

1. Liveness Probe

livenessProbe ：用于检查容器是否仍在运行。如果健康检查失败，Kubernetes 会自动重启该容器。
- httpGet ：使用 HTTP GET 请求检查容器的 /health 路径。
- initialDelaySeconds：在容器启动后等待 30 秒后开始执行检查。
- periodSeconds：每 10 秒执行一次健康检查。

2. Readiness Probe

readinessProbe ：用于检查容器是否准备好接收流量。如果检查失败，Kubernetes 将不向该 Pod 发送流量。
- httpGet ：使用 HTTP GET 请求检查容器的 /ready 路径。
- initialDelaySeconds：在容器启动后等待 15 秒后开始执行检查。
- periodSeconds：每 5 秒执行一次准备检查。

自动重启机制

Kubernetes 默认会在容器状态为 CrashLoopBackOff 或其他失败状态时自动重启容器，因此不需要额外配置。

通过添加 liveness 和 readiness probes，可以增强应用在 Kubernetes 中的可靠性，确保只有健康的 Pod 接收流量，并在出现问题时自动重启容器。这使得应用在生产环境中更具韧性和稳定性。

总结

Kubernetes 的 YAML 文件用于定义和配置集群中的各种资源对象。了解这些资源及其配置方式是有效管理 Kubernetes 集群的基础。通过这些示例，可以创建和管理 Pods、Deployments、Services、ConfigMaps、Secrets 和 Ingress 等资源，以便构建和维护应用。

【K8S系列】Kubernetes 资源对象的 YAML 文件示例及其详细介绍

一、Pod

示例 YAML

解释

二、Deployment

示例 YAML

解释

三、Service

示例 YAML

解释

四、ConfigMap

示例 YAML

解释

五、Secret

示例 YAML

解释

六、Ingress

示例 YAML

解释

七、综合示例

1. ConfigMap

2. Secret

3. Deployment

4. Service

5. Ingress

解释

ConfigMap

Secret

Deployment

Service

Ingress

组合部署

八、 健康检查和自动重启机制完整 YAML 示例

解释

1. Liveness Probe

2. Readiness Probe

自动重启机制

总结

八、健康检查和自动重启机制完整 YAML 示例