【2026年版】Platform Engineering 実践入門：Backstage + Kratix で Internal Developer Platform を作る

開発者
  │
  │  セルフサービスで操作
  ▼
┌─────────────────────────────────────────┐
│       開発者ポータル（Backstage）         │
│  ・サービスカタログ                       │
│  ・スキャフォルダー（テンプレートから作成） │
│  ・TechDocs（ドキュメント）               │
│  ・Kubernetes クラスタ管理 UI             │
└──────────────────┬──────────────────────┘
                   │
                   │ API 呼び出し
                   ▼
┌─────────────────────────────────────────┐
│  プラットフォーム API レイヤー（Kratix）  │
│  ・Promise（インフラの約束事を定義）       │
│  ・ワークフロー管理                       │
│  ・マルチクラスタ orchestration           │
└──────────────────┬──────────────────────┘
                   │
                   │ プロビジョニング
                   ▼
┌─────────────────────────────────────────┐
│         インフラレイヤー                  │
│  Kubernetes / Crossplane / Terraform    │
│  AWS / GCP / Azure / オンプレ            │
└─────────────────────────────────────────┘

# catalog-info.yaml（各リポジトリに配置）
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: payment-service
  description: 決済処理マイクロサービス
  annotations:
    backstage.io/techdocs-ref: dir:.
    github.com/project-slug: myorg/payment-service
    pagerduty.com/service-id: PXXXXXX
  tags:
    - java
    - payment
    - critical
spec:
  type: service
  lifecycle: production
  owner: group:payment-team
  system: e-commerce-platform
  dependsOn:
    - component:user-service
    - resource:payments-db

# template.yaml（サービス作成テンプレートの例）
apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: microservice-template
  title: 新規マイクロサービス作成
  description: Go / Python / Java で新しいサービスを作るゴールデンパス
spec:
  parameters:
    - title: サービス情報
      required: [name, language, owner]
      properties:
        name:
          title: サービス名
          type: string
        language:
          title: 言語
          type: string
          enum: [go, python, java]
        owner:
          title: オーナーチーム
          type: string
          ui:field: OwnerPicker
  steps:
    - id: create-repo
      name: GitHub リポジトリ作成
      action: publish:github
      input:
        repoUrl: github.com?repo=${{ parameters.name }}&owner=myorg
    - id: create-catalog-entry
      name: カタログ登録
      action: catalog:register

# PostgreSQL データベースの Promise 定義例
apiVersion: platform.kratix.io/v1alpha1
kind: Promise
metadata:
  name: postgresql
spec:
  api:
    apiVersion: marketplace.kratix.io/v1alpha1
    kind: postgresql
    spec:
      properties:
        dbName:
          type: string
        storageGB:
          type: integer
          default: 10
        tier:
          type: string
          enum: [dev, staging, production]
  workflows:
    resource:
      configure:
        - apiVersion: platform.kratix.io/v1alpha1
          kind: Pipeline
          spec:
            steps:
            - name: provision-postgres
              image: registry.kratix.io/postgresql-pipeline:v1

# 開発者が発行するリクエスト（シンプル！）
apiVersion: marketplace.kratix.io/v1alpha1
kind: postgresql
metadata:
  name: my-app-db
spec:
  dbName: myapp
  storageGB: 20
  tier: production

開発者体験のレイヤー構造

Backstage（ポータル）
  └── 開発者が見る UI・カタログ・テンプレート

Kratix（API レイヤー）
  └── Backstage のテンプレートから呼び出される
      データベース・Redis・証明書・Namespace 等を
      自動プロビジョニング

Kubernetes / クラウドサービス
  └── 実際のインフラ