简介面向在阿里云上落地微服务容器化的开发者这套部署方案完整覆盖Vue2前端、Nginx、Spring Boot 2.5后端及Nacos 2.0.3注册中心的编排与发布流程并配套一键部署脚本解决多组件整合中配置易错、上手门槛高的常见问题。压缩包共16个文件约34.69MB核心是8个YAML编排文件分别对应Nacos有状态服务、Ingress路由、MySQL初始化、Service与Headless服务等辅以Dockerfile构建镜像Shell脚本执行部署还有jar包、前端打包文件和SQL脚本。整个流程基本实现从镜像构建到K8s资源创建的自动化减少人工干预。已有1340人学习下载适合具备基础K8s概念、正尝试将前后端项目迁移到云集群的开发者。通过资源不仅能拿到可直接改用的部署模板还能理解Nacos在K8s中如何配置持久化存储、服务发现与入口暴露并参考作者整理的应用部署顺序和异常排查细节少走弯路。1. 从零把 Vue2 Nginx SpringBoot 2.5 Nacos 2.0.3 整套搬上阿里云 K8s这活儿比想象中繁琐阿里云 k8s 部署 vue2nginxspringboot2.5nacos2.0.3这套组合在小微企业和个人项目里太常见了前端 Vue2 打包后交给 Nginx 托管后端 SpringBoot 通过 Nacos 做注册与配置下发。表面上四个组件各自独立真正塞进容器编排环境以后镜像构建、端口暴露、服务发现、配置文件优先级、健康检查每一环都可能让你卡上半天。这篇笔记按我自己落地的顺序写先把 Nacos 这个有状态服务安顿好再做前后端镜像然后写 K8s 编排文件最后把那些排查起来最耗时的坑单独列出来。想照着做一遍完整的云原生部署或者已经在做但被某些玄学问题卡住的人都可以直接对号入座。2. 先把地基打好Nacos 2.0.3 在阿里云 K8s 里的 StatefulSet 部署2.1 为什么 2.0.x 要用 MySQL 存储cluster 模式绕不开的依赖Nacos 单机模式默认能跑在嵌入式 Derby 上但一旦你把实例数扩到 2 个以上或者希望配置数据不随 Pod 重建而丢失就必须把数据落到外部 MySQL。2.0.3 这个版本对 MySQL 的支持要求是 5.7 及以上实际操作中我用 5.7 和 8.0 都跑过8.0 需要注意驱动版本后面避坑章节会细说。在 K8s 里Nacos 更应该用 StatefulSet 而不是 Deployment。因为有状态应用需要稳定的网络标识和独立的存储卷Deployment 的 Pod 重建后 IP 变化、hostname 随机Nacos 集群节点之间的 peer 发现会出问题。StatefulSet 能保证每个副本有固定的名称比如 nacos-0、nacos-1配合 Headless Service 做 DNS 解析集群节点之间才能互相找到。存储我用的是阿里云 ACK 的云盘动态卷声明StorageClass 指定为 alicloud-disk-essd按量付费的 ESSD 云盘对 Nacos 这种读多写少的场景足够。如果你们公司有 NAS 或自建的 Ceph也可以换成对应的 StorageClass但注意 Nacos 集群模式下不建议多个副本共享同一个存储卷每个 Pod 独立云盘更安全。2.2 建库脚本与初始化两张核心表的坑Nacos 2.0.3 的建表脚本在源码包的 conf 目录下叫 nacos-mysql.sql里面包括了 config_info、config_info_gray、his_config_info 等多张表。最核心的是 config_info配置中心存储的配置文件都在这张表里另外一张 tenant_info 也不容忽视多租户隔离依赖它初始化时千万不要只建一张表就觉得完事了。把脚本导入库这一步我一般在阿里云 RDS 的控制台直接执行或者在本机用 mysql 客户端导入mysql -h你的RDS地址 -unacos -p -P3306 nacos_config nacos-mysql.sql这里的 nacos_config 是自己创建的数据库名导入前先建好库。导入成功后验证一下表数量正常应该有 12 张左右记不清具体数字不重要关键看 config_info 和 tenant_info 这两张是否存在。注意不要用 Nacos 自带的 Derby 存储来跑生产Pod 一删数据就没了这种后悔药没人想吃第二次。2.3 编写 Nacos StatefulSet 的 YAML内存、端口、健康检查参数下面这个 YAML 是我在阿里云 ACK 上实际跑过的简版剔除了与具体环境耦合的存储卷细节保留了核心参数apiVersion: v1 kind: Service metadata: name: nacos-headless namespace: middleware spec: clusterIP: None ports: - name: http port: 8848 targetPort: 8848 - name: grpc port: 9848 targetPort: 9848 selector: app: nacos --- apiVersion: v1 kind: Service metadata: name: nacos-server namespace: middleware spec: type: ClusterIP ports: - name: http port: 8848 targetPort: 8848 - name: grpc port: 9848 targetPort: 9848 selector: app: nacos --- apiVersion: apps/v1 kind: StatefulSet metadata: name: nacos namespace: middleware spec: serviceName: nacos-headless replicas: 2 podManagementPolicy: Parallel selector: matchLabels: app: nacos template: metadata: labels: app: nacos spec: affinity: podAntiAffinity: preferredDuringSchedulingIgnoredDuringExecution: - weight: 100 podAffinityTerm: labelSelector: matchExpressions: - key: app operator: In values: - nacos topologyKey: kubernetes.io/hostname containers: - name: nacos image: nacos/nacos-server:v2.0.3 ports: - containerPort: 8848 name: http - containerPort: 9848 name: grpc env: - name: MODE value: cluster - name: NACOS_REPLICAS value: 2 - name: SPRING_DATASOURCE_PLATFORM value: mysql - name: MYSQL_SERVICE_HOST value: rm-xxxxxxxx.mysql.rds.aliyuncs.com - name: MYSQL_SERVICE_PORT value: 3306 - name: MYSQL_SERVICE_DB_NAME value: nacos_config - name: MYSQL_SERVICE_USER value: nacos - name: MYSQL_SERVICE_PASSWORD value: YourPassword - name: NACOS_SERVER_PORT value: 8848 - name: JVM_XMS value: 512m - name: JVM_XMX value: 512m - name: JVM_XMN value: 256m readinessProbe: httpGet: path: /nacos/v1/console/health/readiness port: 8848 initialDelaySeconds: 30 periodSeconds: 10 resources: requests: cpu: 500m memory: 768Mi limits: cpu: 1 memory: 1Gi这段配置里有几个参数直接影响能不能跑起来。MODE 必须显式指定为 cluster否则镜像默认以 standalone 启动多个副本各自为政不会组成集群。NACOS_REPLICAS 要和副本数一致它是节点间 peer 发现时计算集群规模用的。Spring Boot 相关的注册、配置服务会通过 nacos-server 这个 ClusterIP Service 访问端口 8848 是 HTTP 接口9848 是 2.x 版本新增的 gRPC 接口漏掉那个端口客户端连接就时好时坏。2.4 暴露 8848 和 9848给 SpringBoot 和前端请求留的入口Nacos 在 K8s 集群内部暴露给 SpringBoot 客户端时走 ClusterIP Service 就够了。但如果你希望在办公网络里打开 Nacos 控制台看一眼配置就需要额外做一个公网入口。安全一点的做法是只对办公网段开放可以用阿里云的 SLB 四层监听把 8848 转发到 NodePort 或 LoadBalancer Service。注意 9848 这个端口别做成公网暴露。gRPC 端口主要给 Java 客户端做长连接和配置推送暴露到公网会增加被扫描的风险。Nacos 客户端只要能访问 8848会自动向上偏移 1000 去找 9848这个偏移逻辑内建在客户端里不需要我们显式配置但网络层面要保证两个端口都可达。3. 构建阶段Vue2 多阶段构建 Nginx 静态转发3.1 为什么前端要用多阶段构建而不是直接跑 node一开始我图省事直接把 Vue2 项目丢进 node:16 镜像里跑 npm run serve结果 K8s 里多了一个常驻的开发服务器既占内存热更新功能又没用。生产环境正确的姿势是多阶段构建第一个阶段用 node 镜像把代码编译成静态文件第二个阶段把静态文件拷进 Nginx 镜像。这样做的好处有三点。第一最终镜像体积能控制在 30MB 上下而 node 镜像动辄几百 MB部署和拉取都更快。第二运行阶段不依赖 node 进程Nginx 对静态文件的处理效率和并发能力远高于 node 的开发服务器。第三减少攻击面生产镜像里没有 npm、没有源代码只有编译后的产物。3.2 Dockerfile 参数node 版本、npm 镜像、构建产物路径# 阶段一构建 Vue2 静态资源 FROM node:16.14.2-alpine AS build WORKDIR /app COPY package.json ./ COPY package-lock.json ./ RUN npm install --registryhttps://registry.npmmirror.com COPY . . RUN npm run build # 阶段二Nginx 托管 FROM nginx:1.21.6-alpine RUN rm -rf /usr/share/nginx/html/* COPY --frombuild /app/dist/ /usr/share/nginx/html/ COPY nginx.conf /etc/nginx/conf.d/default.conf EXPOSE 80 CMD [nginx, -g, daemon off;]这里 node 版本不必抄我的看你们项目实际用的版本Vue2 老项目一般 14 或 16 都兼容。npm install 加了 npmmirror 的 registry国内构建时速度提升明显如果是纯内网环境记得换成你们私服的地址。构建产物路径默认是 dist如果你的 vue.config.js 里改了输出目录上面 COPY 的源路径要同步修改。还有一个容易忽略的点package-lock.json 最好单独拷贝一层再执行 install这样可以利用 Docker 的层缓存源码没变时npm install 这一步不会重复执行。3.3 nginx.conf 里必须写对的三件事history 路由、静态资源缓存、/api 转发Vue2 项目如果用了 vue-router 的 history 模式Nginx 配置里漏掉 try_files 就会导致页面刷新后 404 白屏这是前端部署最经典的翻车场面。静态资源的缓存策略要区分 index.html 和带 hash 的 js/css 文件前者不缓存后者可以长缓存。最后是接口转发前端代码里的请求地址一般写相对路径 /api由 Nginx 反向代理到后端 Service。server { listen 80; server_name your-domain.com; root /usr/share/nginx/html; index index.html; # 单页应用 history 路由回退 location / { try_files $uri $uri/ /index.html; } # 带 hash 的静态资源长缓存 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ { expires 30d; add_header Cache-Control public, immutable; access_log off; } # 后端接口反向代理 location /api/ { proxy_pass http://springboot-server:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }proxy_pass 后面的地址写法有一个细节http://springboot-server:8080/ 末尾带斜杠表示把 /api/ 前缀替换为空再转发。比如请求 /api/user/list后端收到的是 /user/list。如果你的后端接口都带统一前缀也可以去掉末尾斜杠请求会带着 /api 原样转发两种方式取决于后端 Controller 的 RequestMapping 怎么设计。提示K8s 集群内部访问后端服务直接用 Service 名称加端口即可不需要经过 Ingress省掉一层网络开销。4. SpringBoot 2.5 镜像与接入 Nacos从 bootstrap.yml 到 K8s 健康检查4.1 版本匹配SpringBoot 2.5 与 Spring Cloud Alibaba、Nacos ClientSpringBoot 2.5 属于 2.x 中期的版本对应的 Spring Cloud 版本是 2020.0.x而 Spring Cloud Alibaba 需要选 2021.1 分支它的 Nacos Client 正是 2.0.3和本次部署的 Nacos 服务端版本完全对应。这个匹配关系如果你配错了最常见的症状是注册中心里能看到服务但心跳报错或者配置始终拉不下来。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.5.12/version relativePath/ /parent properties spring-cloud.version2020.0.5/spring-cloud.version spring-cloud-alibaba.version2021.1/spring-cloud-alibaba.version /properties dependencyManagement dependencies dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-dependencies/artifactId version${spring-cloud.version}/version typepom/type scopeimport/scope /dependency dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-alibaba-dependencies/artifactId version${spring-cloud-alibaba.version}/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement不要凭感觉往上加版本spring-cloud-alibaba 的 release 版本只对应特定 spring-cloud 分支。版本高出或低出一个大版本启动时就会遇到 NoSuchMethodError 或类加载冲突。4.2 暴露到 Nacos 的注册地址不要写 localhostSpringBoot 应用注册到 Nacos 时服务启动类上的 EnableDiscoveryClient 是常规操作但注册地址怎么来才是关键。在 K8s 里如果不开 hostNetworkPod 的 IP 是网段的虚拟 IPJava 进程的 InetAddress.getLocalHost() 拿到的结果往往不对。最可靠的做法是把 Pod IP 显式传给 SpringBoot 的环境变量。env: - name: POD_IP valueFrom: fieldRef: fieldPath: status.podIP - name: NACOS_ADDR value: nacos-server.middleware.svc.cluster.local:8848 - name: SPRING_PROFILES_ACTIVE value: k8s - name: JVM_OPTS value: -Xms256m -Xmx256m -XX:UseG1GC -Duser.timezoneAsia/Shanghai对应的 bootstrap.yml 写法spring: application: name: user-service cloud: nacos: discovery: server-addr: ${NACOS_ADDR:127.0.0.1:8848} ip: ${POD_IP:} prefer-ip-address: true config: server-addr: ${NACOS_ADDR:127.0.0.1:8848} file-extension: yamlip 那一行是重点提前把 Pod IP 注入进去Nacos 服务的实例 IP 才准确。prefer-ip-address 设置为 true客户端拿到的访问地址是 IP 而不是 hostname避免容器主机名无法被其他服务解析的问题。Nacos 配置中心的 dataId 默认规则是 ${spring.application.name}.${file-extension}也就是说你需要在 Nacos 控制台上新建一个 user-service.yaml 的配置。bootstrap.yml 里的 server-addr 写的是环境变量本地调试时没有这个变量会回退到 127.0.0.1:8848这算是一个方便本地联调的兜底设计。4.3 Deployment 的探针SpringBoot 的 /actuator/health 对接 K8sSpringBoot 的存活和就绪探针直接可以打到 Actuator 的 /actuator/health 端点。区别在于就绪探针不应该等到整个应用完全初始化才开也不能在依赖的 MySQL、Nacos 没就绪时一直不通过这里需要调整 SpringBoot 的 Actuator 健康检查行为。livenessProbe: httpGet: path: /actuator/health/liveness port: 8080 initialDelaySeconds: 60 periodSeconds: 10 failureThreshold: 3 readinessProbe: httpGet: path: /actuator/health/readiness port: 8080 initialDelaySeconds: 30 periodSeconds: 5 failureThreshold: 6K8s 在 1.16 之后支持用 SpringBoot 2.3 的 liveness 和 readiness 分组端点这样外部依赖挂了只会让 readiness 不通过Pod 不会被杀掉重启等数据库恢复后自动就绪。SpringBoot 的 application.yaml 里要显式开放这两个分组management: endpoints: web: exposure: include: health,info endpoint: health: group: readiness: include: readinessState,db liveness: include: livenessState health: probes: enabled: true如果你想简单粗暴一点直接用 /actuator/health 同时作为两种探针也可以但会产生一个经典问题数据库短暂不可用时readiness 变成 DOWNK8s 把 Pod 摘掉流量紧接着 liveness 也变成 DOWNPod 被重启而重启后如果数据库还没恢复就陷入 CrashLoopBackOff。5. 避坑部署这套链路最常见的 5 个翻车现场5.1 Nacos 9848 端口不通服务列表一直漂移现象SpringBoot 服务启动日志里没有报错但 Nacos 控制台的服务列表总是显示离线或者某个节点的服务列表时有时无。原因Nacos 2.0.3 在 8848 之外新增了 9848 的 gRPC 端口客户端首先尝试连接 8848 获取元数据再向偏移后的 9848 建立长连接。你在 K8s 的 Service 里只暴露了 8848长连接全部失败服务实例的心跳上报自然就不正常。解决Service 的 ports 里显式加上 9848 端口同时确认 ACK 集群的安全组、网络策略没有拦截这个端口。检查一下 SpringBoot 所在 Pod 能不能连通进 Pod 里执行 curl -v telnet://nacos-server.middleware.svc.cluster.local:9848能连上才算完事。5.2 Nacos 服务列表里出现多个旧 IPPod 重建后脏数据留下来了现象每次发版滚动更新后Nacos 里的服务实例数量会逐渐累积里面有不少已不存在的 Pod IP。原因SpringBoot 默认在应用关机时会向 Nacos 发送反注册请求但 K8s 滚动更新时旧 Pod 是被直接强杀的优雅停机信号来不及处理注册中心里残留了旧实例。另一个因素是 Nacos 客户端的心跳保护时间默认有十几秒没收到心跳不会立刻摘除。解决Deployment 的 spec 里配置 terminationGracePeriodSeconds 稍微给长一点并在 SpringBoot 的 application.yaml 里开启 graceful shutdown。更彻底的做法是在 preStop 钩子里手动调用 Nacos 的反注册接口虽然 Spring Cloud 的 shutdown 时机不好控制但 preStop 的调用是 K8s 保证的。翻车多次后我现在的配置是 preStop 里 sleep 10 秒等 Actuator 的 /shutdown 或 Spring 的关闭钩子跑完然后再让 K8s 发 SIGTERM。5.3 Nacos Pod 反复重启日志里全是 MySQL 连接超时现象Nacos StatefulSet 拉起来后readiness 一直失败Pod 日志刷 com.mysql.cj.exceptions.CJCommunicationsException。原因阿里云 RDS 的白名单没有加入 Pod 所在的 VPC 网段或者数据库账号的密码里包含了特殊字符被 YAML 里的 value 解析搞坏。如果是自建的 MySQL也可能因为它部署在集群外Pod 到宿主机的 NAT 路由不通。解决先检查 RDS 白名单把 ACK 的 Pod 网段加进去。密码特殊字符问题用 env 的 valueFrom secretKeyRef 引 Secret不要让明文密码直接躺在 YAML 里。我用的是阿里云 ACK 的自动注入模式把数据库密码放到 Secret 里StatefulSet 里只引用字段名。5.4 前端页面能打开接口全部 502现象Vue 静态页正常显示但浏览器里发接口请求全是 502 Bad Gateway后端日志里压根没有收到请求。原因Nginx 反向代理里的 proxy_pass 写的是 http://springboot-server:8080/但这个 Service 名称在 Nginx 容器的 DNS 解析范围内可能不存在。原因要么是前后端不在同一个 Namespace要么是后端 Service 根本没有正常 Endpoints。解决先确认 Service 的 Endpoints 非空kubectl get endpoints -n dev springboot-server如果为空说明后端 Deployment 的 selector 标签没匹配上。如果 Endpoints 正常试着在 Nginx Pod 里 nslookup springboot-server看看能不能解析出 ClusterIP。跨 Namespace 访问时要写全限定名 springboot-server.dev.svc.cluster.local。5.5 SpringBoot 启动后连不上 Nacos但 Nacos 在集群外能正常访问现象在本地开发时 Nacos 控制台和服务注册都正常部署到 K8s 里就报 Connection refused。原因我见过最隐蔽的一次是 bootstrap.yml 没生效。SpringBoot 2.4 之后bootstrap 上下文默认是关闭的需要引入 spring-cloud-starter-bootstrap 依赖否则 bootstrap.yml 里的 Nacos server-addr 配置会被直接忽略。解决在 pom.xml 里额外添加dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-starter-bootstrap/artifactId /dependency这个依赖加上以后bootstrap.yml 才会在应用主配置加载之前被读取Nacos 的 server-addr 才能生效。6. 验证与上线前最后一件事全链路检查清单部署完成后别急着把所有流量切过去先把这几步验证走一遍。进入前端 Nginx Podcurl http://localhost/ 确认首页返回 200再 curl http://springboot-server:8080/actuator/health 确认后端健康。Nacos 控制台里看服务列表两个实例都在才算注册成功。然后从办公网络请求一下 SLB 的域名用浏览器的开发者工具看接口响应头和网络耗时确认 Nginx 代理路径没有多带 /api 前缀。接下来是滚动发布参数的验证。模拟一次发版kubectl set image deployment/user-service user-serviceregistry.cn-hangzhou.aliyuncs.com/your-repo/user-service:2.0.0观察新旧 Pod 的交替过程。旧 Pod 的 ready 状态变成 0 之后才创建新 Pod说明探针配置生效。如果新 Pod 的 readiness 卡住超过两分钟大概率是注册中心或配置中心有问题这时候 kubectl logs 看启动日志。我个人的习惯是在 Nacos 的配置文件里把所有公共参数收拢像线程池、Redis 地址、短信密钥这类东西不进 JAR 包。环境级别的差异统一用 spring.profiles.active 加 Nacos 的 ${spring.application.name}-${spring.profiles.active}.yaml 来隔离线上只保留 k8s 这一个 profile省得自动扩容时配错环境。这套部署方式看起来不算复杂但每一个组件的版本匹配、端口开放、配置优先级都藏着暗坑。把 Nacos 当成有状态服务来对待前端和后端镜像都按生产标准做精简探针和优雅停机用 K8s 原生的机制去适配基本上能稳定跑上一段时间。希望帮到你。本文还有配套的精品资源点击获取