Windsurf CI インテグレーション

概要

自動テストを使用して Windsurf インテグレーション向けの CI/CD パイプラインを設定します。

前提条件

• GitHub Actions が有効な GitHub リポジトリ
• Windsurf テスト API キー
• npm/pnpm プロジェクトの設定

手順

ステップ 1: GitHub Actions ワークフローを作成する

.github/workflows/windsurf-integration.yml を作成します：

name: Windsurf Integration Tests

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

env:
  WINDSURF_API_KEY: ${{ secrets.WINDSURF_API_KEY }}

jobs:
  test:
    runs-on: ubuntu-latest
    env:
      WINDSURF_API_KEY: ${{ secrets.WINDSURF_API_KEY }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test -- --coverage
      - run: npm run test:integration

ステップ 2: シークレットを設定する

gh secret set WINDSURF_API_KEY --body "sk_test_***"

ステップ 3: インテグレーションテストを追加する

describe('Windsurf Integration', () => {
  it.skipIf(!process.env.WINDSURF_API_KEY)('should connect', async () => {
    const client = getWindsurfClient();
    const result = await client.healthCheck();
    expect(result.status).toBe('ok');
  });
});

出力

• 自動テストパイプライン
• PR チェックの設定
• カバレッジレポートのアップロード
• リリースワークフロー の準備完了

エラーハンドリング

問題	原因	解決方法
シークレットが見つからない	設定が不足している	gh secret set でシークレットを追加します
テストがタイムアウトする	ネットワークの問題	タイムアウトを増加させるか、モックを使用します
認証エラー	無効なキー	シークレット値を確認します

例

リリースワークフロー

on:
  push:
    tags: ['v*']

jobs:
  release:
    runs-on: ubuntu-latest
    env:
      WINDSURF_API_KEY: ${{ secrets.WINDSURF_API_KEY_PROD }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - name: Verify Windsurf production readiness
        run: npm run test:integration
      - run: npm run build
      - run: npm publish

ブランチ保護

required_status_checks:
  - "test"
  - "windsurf-integration"

リソース

• GitHub Actions ドキュメント
• Windsurf CI ガイド

次のステップ

デプロイメントパターンについては、windsurf-deploy-integration を参照してください。