K8s实战：手把手教你部署RuoYi前后端分离项目（含私有镜像仓库搭建）

K8s企业级实战RuoYi前后端分离项目全链路部署指南在云原生技术席卷全球的今天Kubernetes已成为企业级应用部署的事实标准。本文将带您深入探索如何基于K8s构建完整的RuoYi前后端分离项目部署方案从私有镜像仓库搭建到服务编排的全过程为DevOps工程师提供一套可复用的企业级解决方案。1. 私有镜像仓库架构设计与实现1.1 企业级镜像仓库选型考量在容器化部署流程中私有镜像仓库是不可或缺的基础设施。相比直接使用公共仓库私有方案具有以下核心优势安全隔离完全掌控镜像访问权限避免敏感代码泄露网络优化内网传输大幅提升镜像拉取速度版本管控自定义镜像标签策略实现精确版本控制合规审计满足企业安全合规的镜像扫描需求主流私有仓库方案对比方案类型典型代表适用场景维护成本开源自建Harbor, Registry需要深度定制的中大型企业高商业托管AWS ECR, ACR云原生环境下的企业中轻量级部署Registry开发测试环境低1.2 基于Registry的轻量级实现对于中小型团队Docker Registry是最快捷的解决方案。以下是关键配置步骤# 创建认证目录 mkdir -p /docker/volume/registry/auth # 生成认证文件使用bcrypt加密 htpasswd -Bbc /docker/volume/registry/auth/htpasswd registryadmin安全配置要点# config.yml 关键配置项 auth: htpasswd: realm: RegistryAuth path: /auth/htpasswd http: headers: X-Content-Type-Options: [nosniff] Strict-Transport-Security: [max-age31536000]注意生产环境必须启用TLS加密可通过Lets Encrypt获取免费证书1.3 可视化监控方案推荐使用docker-registry-ui作为管理界面docker run -d \ -e REGISTRY_URLhttp://registry:5000 \ -e REGISTRY_AUTHtrue \ -p 8080:80 \ joxit/docker-registry-ui:latest常见问题排查技巧镜像推送失败时检查/var/log/registry.log存储空间不足时配置垃圾回收策略网络问题优先验证docker login连通性2. RuoYi应用容器化改造2.1 后端服务优化实践Java应用的容器化需要特别注意JVM参数优化# 多阶段构建示例 FROM maven:3.8-jdk-11 AS build COPY . /app RUN mvn -f /app/pom.xml clean package FROM openjdk:11-jre-slim COPY --frombuild /app/target/*.jar /app.jar ENV JAVA_OPTS-XX:UseContainerSupport -XX:MaxRAMPercentage75.0 ENTRYPOINT [sh, -c, java ${JAVA_OPTS} -jar /app.jar]关键优化点使用Alpine基础镜像减少体积约减少60%配置合理的JVM内存参数分离编译和运行环境2.2 前端Nginx深度配置现代前端项目的Nginx配置需要关注server { gzip on; gzip_types text/plain application/xml application/javascript; location / { # 解决HTML5 History模式路由问题 try_files $uri $uri/ /index.html; # 启用缓存控制 expires 1y; add_header Cache-Control public; } location /api/ { # 后端服务代理 proxy_pass http://backend-service:8080/; proxy_set_header X-Real-IP $remote_addr; } }性能优化技巧开启Brotli压缩比gzip提升20%压缩率配置合理的缓存策略启用HTTP/2协议3. Kubernetes集群部署架构3.1 生产级集群规划建议三节点最小化生产配置节点类型CPU内存存储数量Control Plane4核8GB100GB1Worker8核16GB200GB2网络插件选型对比插件网络性能易用性特性支持Calico高中网络策略完善Flannel中高配置简单Cilium极高低eBPF高级功能3.2 关键组件部署清单数据库部署示例apiVersion: apps/v1 kind: StatefulSet metadata: name: mysql spec: serviceName: mysql replicas: 1 template: spec: containers: - name: mysql image: mysql:8.0 env: - name: MYSQL_ROOT_PASSWORD valueFrom: secretKeyRef: name: db-secret key: root-password volumeMounts: - name: mysql-data mountPath: /var/lib/mysql volumeClaimTemplates: - metadata: name: mysql-data spec: accessModes: [ ReadWriteOnce ] resources: requests: storage: 50Gi重要生产环境必须使用StatefulSet配合PersistentVolume4. 全链路监控与运维4.1 健康检查策略完善的探针配置是保障稳定性的关键livenessProbe: httpGet: path: /actuator/health port: 8080 initialDelaySeconds: 30 periodSeconds: 10 readinessProbe: exec: command: - curl - -f - http://localhost:8080/actuator/health failureThreshold: 34.2 日志收集方案推荐EFK技术栈Filebeat部署配置filebeat.inputs: - type: container paths: - /var/log/containers/*.log output.elasticsearch: hosts: [elasticsearch:9200]日志查询优化技巧使用KQL语法提高查询效率配置合理的日志保留策略对重要业务日志建立索引4.3 性能监控指标核心监控指标清单指标类别具体指标告警阈值容器资源CPU使用率70%持续5分钟内存使用量80%JVMGC时间1s/次堆内存使用率75%数据库活跃连接数最大连接数80%查询响应时间500ms实施部署过程中每个环节都需要进行严格的验证测试。特别是在镜像推送阶段建议建立自动化校验流程确保镜像完整性和安全性。对于企业级应用还需要考虑多环境部署策略通过命名空间隔离开发、测试和生产环境。