K8s（12）RuoYi on K8s 全流程 · 全思路 · 全排错 · 全配置

Plastic garden2026-06-12 10:18

生产级终极完整版（可直接交付）

一、环境拓扑（你的真实机器）

角色 IP 说明
Master 192.168.222.141 kubectl 操作机
Node1 192.168.222.142 Worker
Node2 192.168.222.143 NFS Server​

二、整体部署顺序（死记）

复制代码

纯文本

纯文本

复制代码 
NFS → StorageClass → MySQL → Redis → RuoYi后端 → RuoYi前端

三、NFS + StorageClass（第一关）

1️⃣ NFS 服务器（143）

复制代码

bash

bash

复制代码 
yum install -y nfs-utils rpcbind
mkdir -p /opt/k8s
chmod 777 /opt/k8s

cat > /etc/exports << EOF
/opt/k8s *(rw,sync,no_root_squash)
EOF

systemctl enable --now rpcbind
systemctl enable --now nfs-server
exportfs -r

✅ 验证：

复制代码

bash

bash

复制代码 
showmount -e localhost

2️⃣ 所有节点

复制代码

bash

bash

复制代码 
yum install -y nfs-utils

3️⃣ NFS Provisioner（血泪教训：RBAC 必须全）

rbac.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: v1
kind: ServiceAccount
metadata:
  name: nfs-client-provisioner
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: nfs-client-provisioner-runner
rules:
- apiGroups: [""]
  resources: ["persistentvolumes"]
  verbs: ["get","list","watch","create","delete"]
- apiGroups: [""]
  resources: ["persistentvolumeclaims"]
  verbs: ["get","list","watch","update"]
- apiGroups: ["storage.k8s.io"]
  resources: ["storageclasses"]
  verbs: ["get","list","watch"]
- apiGroups: [""]
  resources: ["events","endpoints"]
  verbs: ["get","list","watch","create","update","patch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: run-nfs-client-provisioner
subjects:
- kind: ServiceAccount
  name: nfs-client-provisioner
  namespace: kube-system
roleRef:
  kind: ClusterRole
  name: nfs-client-provisioner-runner
  apiGroup: rbac.authorization.k8s.io

provisioner.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nfs-client-provisioner
  namespace: kube-system
spec:
  replicas: 1
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: nfs-client-provisioner
  template:
    metadata:
      labels:
        app: nfs-client-provisioner
    spec:
      serviceAccountName: nfs-client-provisioner
      containers:
      - name: nfs-client-provisioner
        image: registry.cn-hangzhou.aliyuncs.com/iuxt/nfs-subdir-external-provisioner:v4.0.2
        env:
        - name: PROVISIONER_NAME
          value: nfs-subdir-external-provisioner
        - name: NFS_SERVER
          value: 192.168.222.143
        - name: NFS_PATH
          value: /opt/k8s
        volumeMounts:
        - name: nfs-root
          mountPath: /persistentvolumes
      volumes:
      - name: nfs-root
        nfs:
          server: 192.168.222.143
          path: /opt/k8s

storageclass.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: nfs-storage
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
provisioner: nfs-subdir-external-provisioner
allowVolumeExpansion: true
reclaimPolicy: Delete
volumeBindingMode: Immediate
parameters:
  archiveOnDelete: "false"

四、MySQL（StatefulSet，第二关）

坑 1：PVC Pending

原因：StorageClass 名字写错

解法 ：kubectl get sc

坑 2：MySQL 起不来

原因：NFS 权限

解法 ：runAsUser: 999

mysql-sts.yaml

复制代码 
#注意下mysql的中文问题，

RuoYi 乱码 ≠ 前端问题​

= MySQL 5.7 默认字符集 + K8s 没显式声明 utf8mb4

yaml

yaml

复制代码 
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mysql
spec:
  serviceName: mysql
  replicas: 1
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      securityContext:
        runAsUser: 999
        fsGroup: 999
      containers:
      - name: mysql
        image: mysql:5.7
        args:
        - "--character-set-server=utf8mb4"
        - "--collation-server=utf8mb4_general_ci"
        env:
        - name: MYSQL_ROOT_PASSWORD
          value: "123456"
        - name: MYSQL_DATABASE
          value: "ry_vue"
        ports:
        - containerPort: 3306
        volumeMounts:
        - name: mysql-data
          mountPath: /var/lib/mysql
  volumeClaimTemplates:
  - metadata:
      name: mysql-data
    spec:
      accessModes: ["ReadWriteOnce"]
      storageClassName: nfs-storage
      resources:
        requests:
          storage: 5Gi

mysql-svc.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: v1
kind: Service
metadata:
  name: mysql
spec:
  clusterIP: None
  selector:
    app: mysql
  ports:
  - port: 3306

五、Redis（StatefulSet，第三关）

坑 3：Redis 起不来

原因：UID 不匹配

解法 ：runAsUser: 0

redis-sts.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: redis
spec:
  serviceName: redis
  replicas: 1
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
    spec:
      securityContext:
        runAsUser: 0
        fsGroup: 0
      containers:
      - name: redis
        image: redis:6.2
        command: ["redis-server", "--appendonly", "yes"]
        ports:
        - containerPort: 6379
        volumeMounts:
        - name: redis-data
          mountPath: /data
  volumeClaimTemplates:
  - metadata:
      name: redis-data
    spec:
      accessModes: ["ReadWriteOnce"]
      storageClassName: nfs-storage
      resources:
        requests:
          storage: 2Gi

redis-svc.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: v1
kind: Service
metadata:
  name: redis
spec:
  clusterIP: None
  selector:
    app: redis
  ports:
  - port: 6379

六、RuoYi 后端（Deployment，第四关）

坑 4：Java 连不上库

原因 ：用了 mysql.server

解法 ：必须用 STS 域名

ruoyi-admin.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ruoyi-admin
spec:
  replicas: 1
  selector:
    matchLabels:
      app: ruoyi-admin
  template:
    metadata:
      labels:
        app: ruoyi-admin
    spec:
      containers:
      - name: ruoyi-admin
        image: ruoyi-admin:latest
        ports:
        - containerPort: 8080
        env:
        - name: SPRING_DATASOURCE_URL
          value: >
            jdbc:mysql://mysql-0.mysql.default.svc.cluster.local:3306/ry_vue?
            useUnicode=true&
            characterEncoding=utf8&
            serverTimezone=Asia/Shanghai
        - name: SPRING_DATASOURCE_USERNAME
          value: root
        - name: SPRING_DATASOURCE_PASSWORD
          value: "123456"
        - name: SPRING_REDIS_HOST
          value: redis-0.redis.default.svc.cluster.local
        - name: SPRING_REDIS_PORT
          value: "6379"

ruoyi-admin-svc.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: v1
kind: Service
metadata:
  name: ruoyi-admin
spec:
  selector:
    app: ruoyi-admin
  ports:
  - port: 8080
    targetPort: 8080

七、RuoYi 前端（Nginx，第五关）

坑 5：404

原因 ：没代理 /prod-api

坑 6：502

原因：端口不一致

nginx.conf

复制代码

nginx

nginx

复制代码 
server {
    listen 80;
    server_name localhost;

    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /prod-api/ {
        proxy_pass http://ruoyi-admin:8080/;
        proxy_setHeader Host $host;
        proxy_setHeader X-Real-IP $remote_addr;
    }
}

Dockerfile

复制代码

dockerfile

dockerfile

复制代码 
FROM nginx:alpine
COPY ./dist/ /usr/share/nginx/html/ #dist是在当前目录下上传的文件夹
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

ruoyi-frontend.yaml

复制代码

yaml

yaml

复制代码 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ruoyi-frontend
spec:
  replicas: 1
  selector:
    matchLabels:
      app: ruoyi-frontend
  template:
    metadata:
      labels:
        app: ruoyi-frontend
    spec:
      containers:
      - name: nginx
        image: my-frontend:v2 #这个是加过若以ui的nginx前端修改版
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: ruoyi-frontend
spec:
  type: NodePort
  selector:
    app: ruoyi-frontend
  ports:
  - port: 80
    targetPort: 80
    nodePort: 30080

八、最终部署命令（严格执行）

复制代码

bash

bash

复制代码 
kubectl apply -f rbac.yaml
kubectl apply -f provisioner.yaml
kubectl apply -f storageclass.yaml

kubectl apply -f mysql-svc.yaml
kubectl apply -f mysql-sts.yaml

kubectl apply -f redis-svc.yaml
kubectl apply -f redis-sts.yaml

kubectl apply -f ruoyi-admin-svc.yaml
kubectl apply -f ruoyi-admin.yaml

kubectl apply -f ruoyi-frontend.yaml

#乱码问题，ruoyi jar的application.yml：

示例：spring:

datasource:

url: jdbc:mysql://localhost:3306/ry?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai

相关推荐
张忠琳4 小时前
【k3s】AutoK3s v0.9.3 Part 1 入口与 CLI 命令模块 — 超深度逐行分析之三
云原生·容器·kubernetes·k3s·autok3s
m0_525724727 小时前
AIOps全链路智能运维架构揭秘
云原生·devops
xiaoxiangsiyan10 小时前
企业日常运维高频应用服务全解
运维·网络·云原生·容器·dns
AR_xsy11 小时前
docker--资源配额 配置
运维·docker·容器
国际云，接待11 小时前
Docker 容器突然退出、服务莫名重启：从 OOMKilled 到内存泄漏的生产排查手册
运维·docker·容器
阿里云云原生11 小时前
一次请求只做一次决策：阿里云 AI 网关智能路由如何替大模型应用选模型
云原生
橙-极纪元12 小时前
把docker的镜像文件从一台服务器中，迁移至另一台服务器
服务器·docker·容器
zhangjw3413 小时前
第41篇：微服务入门：架构理念+核心组件，理解微服务本质
微服务·云原生·架构
RobinDevNotes14 小时前
K8s+Ray+vLLM打穿大模型全生命周期（有实践步骤）
人工智能·云原生·容器·kubernetes·生活·vllm
雨声不在14 小时前
docker-android 重启后镜像起不来
android·docker·容器
热门推荐
01GitHub 镜像站点02国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）03VSCode+CodeX扩展，无法启动04微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新052026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？06AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路07Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费08历年考研数学一、数学二、数学三真题试卷及答案PDF09如何新建文件夹？ 电脑新建文件夹的4种方法102026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片