データモデル

catalog-info.yaml（payment-service）

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: payment-service
  description: "決済処理のコアサービス。Stripe/PayPay連携、課金管理を担当"
  tags: [typescript, nestjs, production, tier-1]
  annotations:
    github.com/project-slug: cloudops/payment-service
    backstage.io/techdocs-ref: dir:.
    datadoghq.com/service-name: payment-service
    argocd/app-name: payment-service
spec:
  type: service
  lifecycle: production
  owner: payment-team
  system: payment-system
  providesApis: [payment-api]
  consumesApis: [user-api, notification-api]
  dependsOn: [resource:payment-db, resource:payment-redis]

ヘルススコアカード

テンプレート一覧

template.yaml（typescript-api）

apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: typescript-api-service
  title: TypeScript APIサービス
  description: "NestJS + Prisma のREST APIサービス"
spec:
  owner: platform-team
  type: service
  parameters:
    - title: サービス情報
      required: [name, owner]
      properties:
        name:
          title: サービス名
          type: string
          pattern: "^[a-z][a-z0-9-]{2,30}$"
        owner:
          title: オーナー
          type: string
          ui:field: OwnerPicker
    - title: オプション
      properties:
        database:
          title: データベース
          type: string
          enum: [none, postgresql, redis, both]
          default: none
        size:
          title: サイズ
          type: string
          enum: [small, medium, large]
          default: small
  steps:
    - id: generate
      name: コード生成
      action: fetch:template
      input:
        url: ./skeleton
        values:
          name: ${{ parameters.name }}
          owner: ${{ parameters.owner }}
    - id: publish
      name: リポジトリ作成
      action: publish:github
      input:
        repoUrl: github.com?owner=cloudops&repo=${{ parameters.name }}
    - id: argocd
      name: Argo CD登録
      action: argocd:create-application
      input:
        appName: ${{ parameters.name }}
    - id: register
      name: カタログ登録
      action: catalog:register
      input:
        repoContentsUrl: ${{ steps.publish.output.repoContentsUrl }}
        catalogInfoPath: /catalog-info.yaml

ディレクトリ構成

${{ values.name }}/
├── src/
│   ├── domain/
│   ├── application/
│   ├── adapters/
│   ├── app.module.ts
│   └── main.ts
├── test/
├── docs/index.md
├── k8s/platform.yaml
├── catalog-info.yaml
├── Dockerfile
├── .github/workflows/ci.yaml
├── package.json
└── README.md

3フェーズ導入計画

リスクと対策

展開戦略