Heroku CI #

┌─────────────────────────────────────────────────────┐
│              Heroku CI 流程                         │
├─────────────────────────────────────────────────────┤
│                                                     │
│  代码推送                                           │
│     │                                               │
│     ▼                                               │
│  ┌─────────────────────────────────────────────┐   │
│  │           创建测试环境                        │   │
│  │  ├── 创建临时 Dyno                           │   │
│  │  ├── 设置环境变量                            │   │
│  │  └── 配置 Add-ons                            │   │
│  └─────────────────────────────────────────────┘   │
│     │                                               │
│     ▼                                               │
│  ┌─────────────────────────────────────────────┐   │
│  │           运行测试                            │   │
│  │  ├── 安装依赖                                │   │
│  │  ├── 执行测试脚本                            │   │
│  │  └── 收集测试结果                            │   │
│  └─────────────────────────────────────────────┘   │
│     │                                               │
│     ├──────────────┬──────────────┐                │
│     │              │              │                │
│     ▼              ▼              ▼                │
│   测试通过       测试失败       测试跳过            │
│     │              │              │                │
│     ▼              ▼              ▼                │
│   允许部署      阻止部署      继续流程              │
│                                                     │
└─────────────────────────────────────────────────────┘

# 创建 Pipeline
heroku pipelines:create myapp-pipeline -a myapp-staging -s staging

# 启用 CI
heroku ci:enable -a myapp-staging

# 查看 CI 状态
heroku ci:info

{
  "name": "myapp",
  "environments": {
    "test": {
      "scripts": {
        "test": "npm test"
      },
      "addons": [
        "heroku-postgresql:mini",
        "heroku-redis:mini"
      ],
      "env": {
        "NODE_ENV": "test"
      }
    }
  }
}

// package.json
{
  "scripts": {
    "test": "jest",
    "test:coverage": "jest --coverage",
    "test:watch": "jest --watch"
  }
}

// app.json
{
  "environments": {
    "test": {
      "scripts": {
        "test": "npm run test:coverage"
      }
    }
  }
}

// app.json
{
  "environments": {
    "test": {
      "scripts": {
        "test": "pytest --cov=app tests/"
      }
    }
  }
}

// app.json
{
  "environments": {
    "test": {
      "scripts": {
        "test": "bundle exec rspec"
      }
    }
  }
}

// app.json
{
  "environments": {
    "test": {
      "addons": [
        "heroku-postgresql:mini"
      ],
      "env": {
        "NODE_ENV": "test"
      }
    }
  }
}

// jest 配置
module.exports = {
  testEnvironment: 'node',
  setupFilesAfterEnv: ['./tests/setup.js']
};

// tests/setup.js
const { Pool } = require('pg');

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false }
});

beforeAll(async () => {
  // 创建测试表
  await pool.query(`
    CREATE TABLE IF NOT EXISTS users (
      id SERIAL PRIMARY KEY,
      email VARCHAR(255) UNIQUE NOT NULL,
      name VARCHAR(255)
    )
  `);
});

afterAll(async () => {
  await pool.end();
});

# 查看最近的测试运行
heroku ci:runs

# 输出示例
# === CI Runs
# Run #    Status    Branch    Commit    Created
# ─────    ──────    ──────    ──────    ───────
# 42       passed    main      abc123    10 minutes ago
# 41       failed    main      def456    1 hour ago

# 查看特定测试运行详情
heroku ci:run 42

# 查看测试日志
heroku ci:run 42 --log

# 手动触发测试
heroku ci:run

# 指定分支
heroku ci:run --branch feature-branch

// app.json
{
  "environments": {
    "test": {
      "env": {
        "NODE_ENV": "test",
        "DATABASE_URL": {
          "from_database": {
            "name": "heroku-postgresql",
            "addon": "heroku-postgresql:mini"
          }
        }
      }
    }
  }
}

# 设置测试环境密钥
heroku config:set TEST_API_KEY=xxx --app myapp-staging

# CI 会自动继承应用的环境变量

// jest 配置
module.exports = {
  reporters: [
    'default',
    ['jest-junit', { outputDirectory: './reports' }]
  ]
};

// jest 配置
module.exports = {
  coverageReporters: ['text', 'lcov', 'html'],
  coverageDirectory: './coverage'
};

# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_PASSWORD: postgres
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          - 5432:5432
      
      redis:
        image: redis:7
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          - 6379:6379
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      
      - name: Install dependencies
        run: npm ci
      
      - name: Run tests
        run: npm test
        env:
          DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
          REDIS_URL: redis://localhost:6379
          NODE_ENV: test
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3
        with:
          files: ./coverage/lcov.info

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Deploy to Heroku
        uses: akhileshns/heroku-deploy@v3.13.15
        with:
          heroku_api_key: ${{ secrets.HEROKU_API_KEY }}
          heroku_app_name: myapp-staging
          heroku_email: ${{ secrets.HEROKU_EMAIL }}

tests/
├── unit/           # 单元测试
│   ├── user.test.js
│   └── product.test.js
├── integration/    # 集成测试
│   ├── api.test.js
│   └── auth.test.js
└── e2e/           # 端到端测试
    └── flow.test.js

// package.json
{
  "scripts": {
    "test": "jest",
    "test:unit": "jest tests/unit",
    "test:integration": "jest tests/integration",
    "test:e2e": "jest tests/e2e",
    "test:coverage": "jest --coverage",
    "test:watch": "jest --watch"
  }
}

// 每个测试使用独立的数据库
beforeEach(async () => {
  await pool.query('BEGIN');
});

afterEach(async () => {
  await pool.query('ROLLBACK');
});

// 增加测试超时时间
jest.setTimeout(30000);

// 或在特定测试中
test('long running test', async () => {
  // ...
}, 30000);

// 检查数据库连接
beforeAll(async () => {
  try {
    await pool.query('SELECT 1');
    console.log('Database connected');
  } catch (error) {
    console.error('Database connection failed:', error);
    throw error;
  }
});

# 检查 CI 环境变量
heroku ci:run 42 --log | grep -i env