ストーリー

テンプレート構成戦略

レイヤー構成

テンプレートのレイヤー構成:

共通レイヤー（全テンプレート共通）:
  ├── Dockerfile（マルチステージビルド）
  ├── .github/workflows/ci.yaml（共通CI）
  ├── .eslintrc.js / .prettierrc（コーディング規約）
  ├── k8s/platform.yaml（Application CRD）
  ├── catalog-info.yaml（Backstage登録）
  └── docs/index.md（TechDocs雛形）

言語レイヤー（言語ごとの共通設定）:
  TypeScript:
    ├── tsconfig.json
    ├── jest.config.ts
    └── package.json（共通依存）
  Python:
    ├── pyproject.toml
    ├── pytest.ini
    └── requirements.txt

アプリケーションレイヤー（用途ごとの実装）:
  API Service:
    └── NestJS + Prisma + REST
  Worker:
    └── NestJS + Bull + SQS
  BFF:
    └── NestJS + GraphQL + Apollo

テンプレートの組み合わせ

テンプレートのバージョン管理

バージョニング戦略

テンプレートからのアップグレード

テンプレートアップグレード戦略:

方法1: Renovate/Dependabot による自動PR
  ├── テンプレートの共通部分をnpmパッケージとして配布
  ├── 各サービスのpackage.jsonでバージョン管理
  └── Renovateが新バージョンを検知し、自動PRを作成

方法2: テンプレート差分適用ツール
  ├── テンプレートの変更差分を検出
  ├── 各サービスに差分を自動適用するPRを作成
  └── コンフリクトがある場合は手動解決

方法3: Golden Pathスコアカード
  ├── テンプレートの最新バージョンとの差分をチェック
  ├── ヘルススコアに反映
  └── 古いバージョンのサービスを可視化

テンプレートのテスト

テストピラミッド

テスト自動化の例

# .github/workflows/template-test.yaml
name: Template Test
on:
  pull_request:
    paths:
      - 'templates/**'

jobs:
  test-template:
    strategy:
      matrix:
        template: [typescript-api, typescript-worker, python-ml]
    steps:
      - name: テンプレートからコード生成
        run: |
          backstage-cli scaffolder test \
            --template templates/${{ matrix.template }}/template.yaml \
            --values test/fixtures/${{ matrix.template }}.json

      - name: 生成コードのビルド
        run: |
          cd output/
          npm install && npm run build

      - name: 生成コードのテスト
        run: |
          cd output/
          npm run test

      - name: 生成コードのlint
        run: |
          cd output/
          npm run lint

      - name: Dockerイメージのビルド
        run: |
          cd output/
          docker build -t test-${{ matrix.template }}:test .

共通ライブラリ戦略

社内共通パッケージ

「テンプレートは『最初の一歩』を支える。共通ライブラリは『継続的な品質』を支える。両方が揃って初めてGolden Pathが機能する」 — 田中VPoE

まとめ

チェックリスト

• テンプレートのレイヤー構成を設計できる
• バージョン管理とアップグレード戦略を理解した
• テンプレートのテスト方法を把握した
• 共通ライブラリ戦略を設計できる

次のステップへ

次は「ガードレールの実装」を学びます。Golden Pathを支える自動統制の仕組みを設計しましょう。

推定読了時間: 30分