Platform Engineering

# Backstage 소프트웨어 템플릿 (catalog-info.yaml)
apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: create-node-service
  title: Node.js 마이크로서비스 생성
  description: 표준화된 Node.js 서비스를 자동으로 생성합니다
  tags:
    - nodejs
    - microservice
    - recommended
spec:
  owner: platform-team
  type: service

  parameters:
    - title: 서비스 정보
      required:
        - serviceName
        - team
      properties:
        serviceName:
          title: 서비스 이름
          type: string
          description: 소문자, 하이픈만 허용 (예: user-api)
          pattern: '^[a-z][a-z0-9-]*$'
        team:
          title: 담당 팀
          type: string
          enum: ['backend', 'frontend', 'data', 'platform']
        description:
          title: 서비스 설명
          type: string

    - title: 인프라 설정
      properties:
        database:
          title: 데이터베이스
          type: string
          enum: ['none', 'postgresql', 'mongodb', 'redis']
          default: 'none'
        cpu:
          title: CPU 요청량
          type: string
          enum: ['100m', '250m', '500m', '1000m']
          default: '250m'
        memory:
          title: 메모리 요청량
          type: string
          enum: ['128Mi', '256Mi', '512Mi', '1Gi']
          default: '256Mi'

  steps:
    # 1. GitHub 저장소 생성
    - id: fetch-template
      name: 템플릿 가져오기
      action: fetch:template
      input:
        url: ./skeleton
        values:
          serviceName: ${{ parameters.serviceName }}
          team: ${{ parameters.team }}
          database: ${{ parameters.database }}

    - id: publish-github
      name: GitHub 저장소 생성
      action: publish:github
      input:
        repoUrl: github.com?owner=my-org&repo=${{ parameters.serviceName }}
        defaultBranch: main
        protectDefaultBranch: true

    # 2. Kubernetes 리소스 생성
    - id: create-kubernetes
      name: Kubernetes 네임스페이스 및 리소스 생성
      action: kubernetes:apply
      input:
        manifest: |
          apiVersion: v1
          kind: Namespace
          metadata:
            name: ${{ parameters.serviceName }}
            labels:
              team: ${{ parameters.team }}
          ---
          apiVersion: apps/v1
          kind: Deployment
          metadata:
            name: ${{ parameters.serviceName }}
            namespace: ${{ parameters.serviceName }}
          spec:
            replicas: 2
            selector:
              matchLabels:
                app: ${{ parameters.serviceName }}
            template:
              spec:
                containers:
                  - name: app
                    resources:
                      requests:
                        cpu: ${{ parameters.cpu }}
                        memory: ${{ parameters.memory }}

    # 3. 데이터베이스 프로비저닝 (선택시)
    - id: provision-database
      name: 데이터베이스 프로비저닝
      if: ${{ parameters.database != 'none' }}
      action: crossplane:create
      input:
        apiVersion: database.example.com/v1
        kind: ${{ parameters.database | capitalize }}Instance
        metadata:
          name: ${{ parameters.serviceName }}-db

    # 4. Backstage 카탈로그 등록
    - id: register-catalog
      name: 서비스 카탈로그 등록
      action: catalog:register
      input:
        repoContentsUrl: ${{ steps['publish-github'].output.repoContentsUrl }}
        catalogInfoPath: /catalog-info.yaml

  output:
    links:
      - title: 저장소
        url: ${{ steps['publish-github'].output.remoteUrl }}
      - title: 서비스 카탈로그
        icon: catalog
        entityRef: ${{ steps['register-catalog'].output.entityRef }}