k8s配置文件用法详解

apiVersion: v1
kind: Namespace
metadata:
  name: db

kubectl apply -f eurekaserver-deployment.yaml

# 指定使用的Kubernetes API版本，Deployment资源属于apps/v1版本
apiVersion: apps/v1
# 定义资源类型为Deployment，用于部署和管理Pod副本集
kind: Deployment
# 元数据部分，定义Deployment的基本信息
metadata:
  # Deployment的名称，在命名空间中必须唯一
  name: eurekaserver
  # 部署到的命名空间，默认为default
  namespace: default
  # 标签集合，用于标识和选择此Deployment
  labels:
    # 应用标识标签
    app: eurekaserver
    # 环境标识标签
    environment: production
  # 注解，用于存储非识别性元数据
  annotations:
    # 描述信息
    description: "Deployment for the main eurekaserver web server"
# 规格部分，定义Deployment的期望状态
spec:
  # 期望的Pod副本数量
  replicas: 1
  # Pod就绪后需要等待的秒数才被视为可用
  minReadySeconds: 5
  # 更新策略配置
  strategy:
    # 更新类型：RollingUpdate(滚动更新)或Recreate(先删除后创建)
    type: RollingUpdate
    # 滚动更新具体配置
    rollingUpdate:
      # 更新过程中可以额外创建的Pod数量(相对于replicas)
      maxSurge: 1
      # 更新过程中最多允许不可用的Pod数量
      maxUnavailable: 0
  # 保留的旧ReplicaSet历史记录数量，用于回滚
  revisionHistoryLimit: 5
  # 标签选择器，定义如何找到由该Deployment管理的Pod
  selector:
    matchLabels:
      # 选择所有拥有app: eurekaserver标签的Pod
      app: eurekaserver
  # Pod模板，定义Deployment创建的Pod的规格
  template:
    # Pod的元数据
    metadata:
      # Pod的标签，必须匹配上面的selector.matchLabels
      labels:
        app: eurekaserver
        environment: production
    # Pod的规格
    spec:
      # 容器列表
      containers:
      # 第一个容器定义
      - name: eurekaserver  # 容器名称
        image: eurekaserver:1.0  # 容器镜像及标签
        imagePullPolicy: IfNotPresent  # 镜像拉取策略: Always, IfNotPresent, Never
        # 容器暴露的端口列表
        ports:
        - containerPort: 9001  # 容器内监听的端口
          protocol: TCP  # 协议类型
        # 环境变量列表
        env:
        - name: ENV_VAR_1  # 环境变量名称
          value: "value1"  # 环境变量值
        # 资源请求和限制
        resources:
          # 请求的资源量，调度器根据此值决定Pod放在哪个节点
          requests:
            cpu: "250m"  # 250 milliCPU (0.25个CPU核心)
            memory: "256Mi"  # 256 Mebibytes
          # 资源使用上限
          limits:
            cpu: "500m"  # 500 milliCPU (0.5个CPU核心)
            memory: "512Mi"  # 512 Mebibytes
        # 存活性探针，检查容器是否还在正常运行
        livenessProbe:
          httpGet:  # 使用HTTP GET请求进行检查
            path: /  # 请求的路径
            port: 9001  # 请求的端口
          initialDelaySeconds: 15  # 容器启动后等待多少秒才开始第一次探测
          periodSeconds: 20  # 每次执行探测的间隔时间(秒)
        # 就绪性探针，检查容器是否已准备好接收流量
        readinessProbe:
          httpGet:
            path: /
            port: 9001
          initialDelaySeconds: 5  # 容器启动后等待多少秒才开始第一次探测
          periodSeconds: 10  # 每次执行探测的间隔时间(秒)
      # Pod内容器的重启策略，对于Deployment只能是Always
      restartPolicy: Always
      # 收到终止信号后，等待容器正常关闭的优雅时间(秒)
      terminationGracePeriodSeconds: 30

apiVersion: apps/v1    # -> 我们要使用 Kubernetes 的 "apps" 部门的 "v1" 版订单格式。
kind: Deployment       # -> 订单的类型：我们要生产的是【一套可复制的应用部署】，而不是单个产品（Pod）或一个服务（Service）。

metadata:
  name: nginx-deployment   # -> 这套部署的名字叫 "nginx-deployment"。这是它的唯一标识，后续操作（如更新、查看）都要用这个名字。
  namespace: default       # -> 把它部署到名为 "default" 的车间里。如果不指定，就默认放这个车间。
  labels:                  # -> 给这个订单贴上个标签，方便以后筛选和查找。
    app: nginx             #   例如：贴上一个 "app=nginx" 的标签。
  annotations:             # -> 给管理员看的备注信息，Kubernetes 本身不使用这些信息来识别对象。
    description: "Deployment for the main NGINX web server" # 例如：备注一下这是给主服务器用的。

spec:
  replicas: 3              # -> 我希望任何时候都保持有 3 个完全一样的产品（Pod）在运行。
  strategy:                # -> 当需要升级产品时，采用以下策略：
    type: RollingUpdate    #    【滚动更新】：逐台替换，保证服务不中断。而不是【Recreate】：全部停机再更新。
    rollingUpdate:
      maxSurge: 1          #    更新时，最多允许比 3 台多 1 台（即最多有 4 台在运行）。
      maxUnavailable: 0    #    更新时，最多允许 0 台不可用（即必须保证至少有 3 台随时能服务）。
  revisionHistoryLimit: 5  # -> 保留 5 份旧的订单记录，方便以后出问题时回退到之前的版本。

  selector:                # -> 这是我的“产品筛选器”。
    matchLabels:           #    我管理的所有产品（Pod）都必须贴有下面这个标签。
      app: nginx           #    标签是 "app=nginx"。Kubernetes 会持续检查，确保所有带这个标签的 Pod 都是 3 个。

  template:                # -> 以下是一个产品的设计图（Pod 模板）。
    metadata:
      labels:              # -> 【必须】根据这张图生产出的每一个产品，都要贴上这些标签。
        app: nginx         #    这个标签 `app: nginx` 必须和上面的 selector.matchLabels 完全一致！
        environment: production # 还可以贴其他标签，比如标注这是生产环境用的。

    spec:                  # -> 产品的详细规格。
      containers:          # -> 这个产品里要安装的【容器】（可以装多个）。
      - name: nginx        #    第一个容器的名字叫 "nginx"。
        image: nginx:1.25.2 #   使用哪个镜像文件来安装这个容器？—— `nginx` 软件的 `1.25.2` 版本。
        ports:             #   这个容器开放了哪个端口？—— 80 端口。（这主要是说明文档，不影响实际网络）
        - containerPort: 80
        resources:          # -> 【生产环境必填】这个容器最多能占用多少硬件资源？（防止它挤占其他容器的资源）
          requests:         #   最少需要多少资源才能开机？
            cpu: "250m"     #     需要 0.25 个 CPU 核心。
            memory: "64Mi"  #     需要 64MB 内存。
          limits:           #   运行时最多不能超过多少资源？
            cpu: "500m"     #     最多能用 0.5 个 CPU 核心。
            memory: "128Mi" #     最多能用 128MB 内存。
        livenessProbe:     # -> 【存活探针】—— 如何检查这个容器是“死”是“活”？如果检查失败，就重启它。
          httpGet:         #    检查方法：发送一个 HTTP GET 请求。
            path: /        #      请求的路径是根目录 "/"。
            port: 80       #      请求的端口是 80。
          initialDelaySeconds: 15 # 容器启动后，等 15 秒再执行第一次检查（给程序启动留出时间）。
        readinessProbe:    # -> 【就绪探针】—— 如何检查这个容器是否“准备好接待客户”？如果没准备好，就先不让流量进来。
          httpGet:
            path: /
            port: 80
          initialDelaySeconds: 5 # 启动后 5 秒开始检查。

# service.yaml
apiVersion: v1
kind: Service
metadata:
  name: order-service # Service 的名称，配置名称后可以用配置的名称来访问服务，从而摆脱对IP的强依赖
  namespace: default   # 可指定命名空间，不指定则默认为 default
spec:
  type: NodePort       # 服务类型，此处为 NodePort，允许从外部访问
  selector:            # 标签选择器，用于选择拥有以下标签的 Pod
    app: orderserver   # 必须与你的 Pod 的标签匹配
  ports:
    - name: http       # 端口名称，可自定义，多端口时必须唯一
      protocol: TCP    # 协议
      port: 80         # Service 自身的端口，在集群内部通过此端口访问
      targetPort: 9002 # 目标端口，即 Pod 中容器实际监听的端口（你的应用端口）
      # nodePort: 30180 # 可选项：手动指定节点端口。若不指定，Kubernetes 会自动分配一个

apiVersion: v1
kind: Secret
metadata:
  name: mysecret
type: Opaque
data:
  username: YWxpY2U=        # Base64 编码后的值
  password: UyFCXKpkJHpEc2I9

# ========================
# 持久卷（PV）配置
# ========================
apiVersion: v1  # Kubernetes API版本
kind: PersistentVolume  # 资源类型：持久卷
metadata:
  name: postgres-pv  # 持久卷名称
spec:
  capacity:
    storage: 10Gi  # 存储容量：10GB
  accessModes:
    - ReadWriteOnce  # 访问模式：单节点读写[11](@ref)
  persistentVolumeReclaimPolicy: Retain  # 回收策略：保留（删除PVC后PV保留）[11](@ref)
  storageClassName: ""  # 存储类名称（空字符串）
  hostPath:  # 使用节点本地目录作为存储[11](@ref)
    path: /mnt/postgres-data  # 节点上的主机路径
---
# ========================
# 持久卷声明（PVC）配置
# ========================
apiVersion: v1  # Kubernetes API版本
kind: PersistentVolumeClaim  # 资源类型：持久卷声明
metadata:
  name: postgres-pvc  # PVC名称
  namespace: db  # 所属命名空间
spec:
  accessModes:
    - ReadWriteOnce  # 访问模式：单节点读写
  resources:
    requests:
      storage: 10Gi  # 请求的存储容量：10GB

apiVersion: v1
kind: Service
metadata:
  name: mysql # 这个名称会被用于Pod的DNS域名
spec:
  clusterIP: None # 这就是Headless Service的定义
  selector:
    app: mysql
  ports:
  - port: 3306
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mysql
spec:
  serviceName: "mysql" # StatefulSet必须通过这个字段知道它属于哪个Headless Service
  replicas: 3
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      containers:
      - name: mysql
        image: mysql:8.0
        ...
  volumeClaimTemplates: # 存储卷声明模板
  - metadata:
      name: data # PVC的名称会是 `data-mysql-0`, `data-mysql-1`, etc.
    spec:
      accessModes: [ "ReadWriteOnce" ]
      storageClassName: "fast-ssd" # 指定存储类，由管理员提供
      resources:
        requests:
          storage: 20Gi

kubectl label pod mysql-0 role=master

apiVersion: v1
kind: Service
metadata:
  name: mysql-master-external  # 这是一个新的、用于外部访问的Service
spec:
  type: NodePort  # 关键：类型为NodePort，用于对外暴露
  selector:
    app: mysql    # 必须匹配您的Pod标签
    role: master  # 关键：只选择Master Pod，确保流量不会跑到从节点
  ports:
    - protocol: TCP
      port: 3306        # Service监听的端口
      targetPort: 3306  # Pod上的端口
      # nodePort: 30000  # 可选：指定一个NodePort端口（范围30000-32767）。不指定则随机分配。

kubectl apply -f mysql-master-svc.yaml

kubectl get pods -o wide

kubectl get deployment <deployment-name> -n <namespace> -o yaml