標準パイプラインステージ設計:

Phase 1: 検証（並列実行、目標: 10分以内）
├── Lint & Format Check
├── Unit Test (with coverage)
└── Security: SAST + SCA

Phase 2: ビルド（Phase 1完了後、目標: 5分以内）
├── Build Application
├── Build Container Image
└── Sign Artifact (Cosign)

Phase 3: 統合テスト（Phase 2完了後、目標: 10分以内）
├── Integration Test
└── Container Security Scan (Trivy)

Phase 4: デプロイ（Phase 3完了後）
├── Staging Deploy（自動、目標: 5分以内）
└── Production Deploy（承認後、カナリア）

合計目標: ~30分

トレードオフの判断:

• チームAの「速度優先」→ Phase 1を並列化して10分以内に
• チームBの「セキュリティ強化」→ SASTとSCAをPhase 1に統合、コンテナスキャンはPhase 3で
• 経営層の「コスト削減」→ 並列化で実行時間を短縮しランナーコストを最適化

# 共有ワークフローの構成
org/shared-workflows/
├── .github/workflows/
│   ├── ci.yml              # メインCI（オーケストレーター）
│   ├── build-typescript.yml # TypeScript用ビルド
│   ├── build-python.yml     # Python用ビルド
│   ├── build-go.yml         # Go用ビルド
│   ├── test.yml            # テスト実行（言語自動判定）
│   ├── security-scan.yml    # セキュリティスキャン
│   ├── deploy-staging.yml   # ステージングデプロイ
│   └── deploy-production.yml # 本番デプロイ
└── actions/
    ├── setup-runtime/       # ランタイムセットアップ
    ├── lint/                # Lint実行
    └── coverage-check/      # カバレッジチェック

# 呼び出し側（各チームのリポジトリ）
name: CI/CD
on: [push, pull_request]
jobs:
  pipeline:
    uses: org/shared-workflows/.github/workflows/ci.yml@v2
    with:
      language: "typescript"
      deploy-staging: ${{ github.ref == 'refs/heads/main' }}
    secrets: inherit

SOC2対応:

• 本番デプロイは2名以上の承認が必要
• 承認者は変更の実施者と異なる必要がある
• すべてのデプロイログは90日間保持

レジストリ構成:

ghcr.io/org/
├── <team>/<service>:<version>   # コンテナイメージ
├── <team>/<service>:sha-<hash>  # コミットハッシュタグ
└── <team>/<service>:latest      # 開発用（本番使用禁止）

命名規則:

• イメージ名: ghcr.io/org/{team}/{service}:{semver}
• タグ: v{major}.{minor}.{patch}, sha-{short-hash}, pr-{number}
• 本番では latest タグの使用を禁止

保持ポリシー:

自動ロールバック基準:

ロールバック手順:

1. 自動検知 → Slackアラート + PagerDuty通知
2. カナリアの場合: トラフィックを前バージョンに即時切り替え
3. 全面展開済みの場合: 前バージョンのイメージを再デプロイ
4. ポストモーテム実施（24時間以内）

# 組織標準パイプライン設計書

## 1. 概要
- 目的と適用範囲
- 設計原則

## 2. パイプラインステージ
- ステージ構成図
- 各ステージの詳細
- 実行時間と品質ゲート

## 3. Reusable Workflow
- 共有ワークフロー一覧
- 言語別カスタマイズ方法
- バージョニングとアップデート方針

## 4. 環境管理
- 環境構成
- プロモーション戦略
- SOC2コンプライアンス対応

## 5. アーティファクト管理
- レジストリ構成
- 命名規則とメタデータ
- 保持ポリシー

## 6. ロールバック戦略
- 自動ロールバック基準
- 手動ロールバック手順
- ポストモーテムプロセス

## 付録
- チーム別オンボーディングガイド
- FAQ