Cursor rule

1---
2description: K8s 部署流程与构建参数规范
3alwaysApply: true
4---
5# 部署规范
6 
7## 核心原则：构建必须正确
8 
9构建前先确认目标环境，确保产物和部署环境匹配。不能盲目执行命令。
10 
11**构建前必问**：
121. 目标环境是什么？（EE SaaS / CE 自部署 / 本地开发）
132. 该环境需要哪些构建参数？（EDITION、平台架构、基础镜像）
143. 产物如何验证？（路由 chunk 是否存在、EE 模块是否加载）
15 
16当前生产环境是 **EE SaaS**，因此构建必须包含 `--build-arg EDITION=ee`。如果未来部署 CE 实例，则不需要该参数。参数跟着环境走，不是死记。
17 
18## 镜像 Registry 与 Tag 规范
19 
20- Registry 和 Namespace 从当前 K8s deployment 的 image 字段获取，不要硬编码
21- 前端镜像 tag 格式: `{main_sha}-{ee_sha}-frontend-{timestamp}-amd64`
22- 后端镜像 tag 格式: `{main_sha}-{ee_sha}-backend-{timestamp}-amd64`
23- 通过 `kubectl -n browser-pilot get deploy -o wide` 确认当前使用的 registry 和镜像名
24 
25## 按需部署
26 
27- 只改了前端代码 → 只构建和部署前端
28- 只改了后端代码 → 只构建和部署后端
29- 两边都改了 → 两个都部署
30 
31## 部署后验证
32 
33更新 K8s deployment 后，用 `kubectl rollout status` 确认 pod 就绪。涉及关键功能变更时，抽查产物确认构建正确（如 EE 路由 chunk 是否存在）。
34