CI/CD与部署架构技能

CD与部署架构技能 是做什么的？

本技能指导AI代理和贡献者维护GitHub Actions CI/CD流水线、容器镜像发布及自动化部署。

---

1. 本地分支优先开发与提交节奏

[!IMPORTANT] 首先创建本地分支并频繁提交： 始终从 main 创建专用的本地分支：

git switch -c <开发者或代理>/main/<功能名称>

在每一个逻辑里程碑处提交（更多提交 = 更多解释性工作）。切勿直接在 main 上提交。

---

2. 多环境CI/CD流水线

jobs:
  backend-test:
    name: 后端测试与构建
    steps:
      - uses: actions/setup-go@v5
      - run: go test -v -race ./...
      - run: go build -v ./...

  service-test:
    name: Python服务测试与lint检查
    steps:
      - uses: astral-sh/setup-uv@v5
      - run: uv sync
      - run: uv run pytest

  frontend-test:
    name: 前端lint与构建
    steps:
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
      - run: pnpm install --frozen-lockfile
      - run: pnpm run lint
      - run: pnpm run build

---

3. 本地CI镜像运行手册

为确保更改在提交前通过CI，请执行以下操作：

# 1. 运行预提交门控（精确镜像CI检查）
make pre-commit

# 2. 或者，在本地单独运行CI任务：
# Go后端：
go test -v -race ./... && go build -v ./...

# Python服务：
uv run pytest

# 前端：
pnpm run lint && pnpm run build

---

4. 秘密信息与集中式配置

• 秘密信息：严格在 .env / CI秘密和运行时仪表盘中定义（DATABASE_URL、API_KEY、JWT_SECRET）。
• 运行默认值：集中在代码模块中。
• 切勿在CI工作流YAML或Git提交中硬编码秘密信息。