返回首页
上一课下一课 →
module3
25 分钟

CI/CD 集成

学习进度

当前模块0/6 课
总进度0/36 课
学习时长0 分钟

学习目标

  • 在 GitHub Actions 中集成 Codex CLI
  • 实现自动构建验证与部署前检查
  • 利用 Codex 进行故障自动诊断
  • 掌握 AI 辅助 CI/CD 最佳实践

205 CI/CD 集成

将 Codex 集成到 CI/CD 流水线中，实现自动构建验证、部署前校验和故障自诊断

学习目标

一、GitHub Actions 集成

基础 Workflow 配置

# .github/workflows/codex-ci.yml
name: Codex CI
on:
  pull_request:
    branches: [main, develop]
  push:
    branches: [main]

jobs:
  codex-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Codex
        run: |
          curl -fsSL https://codex.openai.com/install.sh | bash
      - name: Code Review
        run: codex review --fail-on critical,warning
      - name: Security Audit
        run: codex review --security --fail-on critical
      - name: Run Tests
        run: codex test --coverage --threshold 80

矩阵构建验证

codex-build-check:
    strategy:
      matrix:
        node-version: [18, 20, 22]
    steps:
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
      - run: npm ci
      - name: Build Verification
        run: codex build --verify
**💡 提示：** 使用 `codex ci init` 命令可以交互式生成适合当前项目的 CI 配置文件。

二、自动化构建验证

`codex build --verify` 检查项

# 完整构建验证
codex build --verify

验证清单：

检查项说明
依赖完整性检查 `node_modules` 与 `package-lock.json` 一致性
类型检查TypeScript 全量类型检查
构建产物确认构建输出完整且可运行
Bundle 分析检测 Bundle 体积异常增长
环境变量验证必需的环境变量是否已配置

三、部署前验证

Pre-deployment 检查流程

# 部署前全量验证
codex deploy --check

# 仅验证特定环境
codex deploy --check --env staging

部署前验证包括：

# 1. 数据库迁移检查
codex deploy --check-migrations

# 2. API 契约兼容性
codex deploy --check-api-compat --base main

# 3. 配置变更审查
codex deploy --review-config

# 4. 健康检查端点验证
codex deploy --health-check https://staging.example.com/health

四、故障自动诊断

构建失败分析

# 自动诊断 CI 失败原因
codex ci --diagnose

# 获取修复建议
codex ci --diagnose --fix

Codex 分析的内容包括：

  1. **错误日志解析**：识别关键错误信息
  1. **依赖冲突检测**：检查版本不兼容问题
  1. **环境对比**：对比 CI 环境与本地环境差异
  1. **近期变更关联**：关联最近的代码变更与失败原因

输出示例

诊断报告：
  🔴 错误原因：actions/setup-node@v3 已废弃
  🟡 建议修复：升级为 actions/setup-node@v4
  📝 关联提交：abc1234 (更新 CI 配置文件)
  一键修复：codex ci --diagnose --fix

五、CI/CD 最佳实践

推荐的分层 CI 策略

# 快速检查层（每次 push）
ci-fast:
  - codex review --changed
  - codex test --changed

# 完整检查层（PR）
ci-full:
  - codex review
  - codex test --coverage
  - codex build --verify

# 深度检查层（合并到 main 前）
ci-deep:
  - codex review --security
  - codex deploy --check
  - codex test --integration
**💡 提示：** 将快速检查配置为 Required Check，保证基础质量；将深度检查配置为非阻塞以优化 PR 周期。

六、本课总结

**核心要点：**

  • Codex CLI 可以通过 GitHub Actions 等平台无缝集成到 CI 流水线
  • `codex build --verify` 提供全面的构建质量检查
  • `codex deploy --check` 实现部署前安全验证
  • `codex ci --diagnose` 自动定位并建议修复 CI 失败
  • 分层 CI 策略平衡了检查深度和工作流效率

**下一步：** 进入实战环节 → [206 实战：搭建个人开发工作流](module3-206.md)

上一课
下一课