Backstage как портал разработчиков: каталог сервисов, плагины и golden-path шаблоны

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: payment-service
  description: Handles payment processing and refunds
  annotations:
    github.com/project-slug: myorg/payment-service
    pagerduty.com/service-id: P123456
    backstage.io/techdocs-ref: dir:.
  tags:
    - java
    - payments
    - tier-1
  links:
    - url: https://grafana.internal/d/payment-service
      title: Grafana Dashboard
spec:
  type: service
  lifecycle: production
  owner: group:payments-team
  system: commerce-platform
  providesApis:
    - payment-api
  dependsOn:
    - resource:default/postgres-payment-db

import React from 'react';
import { useApi } from '@backstage/core-plugin-api';
import { deploymentMetricsApiRef } from '../api';
import { Progress } from '@backstage/core-components';
import { useAsync } from 'react-use';

export const DeploymentFrequency = ({ entity }) => {
  const api = useApi(deploymentMetricsApiRef);
  const { value, loading } = useAsync(
    () => api.getDeploymentFrequency(entity.metadata.name),
    [entity]
  );

  if (loading) return <Progress />;

  return (
    <div>
      <h3>Deployment Frequency (last 30 days)</h3>
      <p>{value?.count ?? 'N/A'} deployments</p>
      <p>Average interval: {value?.avgInterval ?? 'N/A'}</p>
    </div>
  );
};

apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: microservice
  title: New microservice
  description: Scaffold a service with catalog registration and CI wiring
spec:
  owner: group:platform-team
  type: service
  parameters:
    - title: Service metadata
      required: [name, owner, system, org]
      properties:
        name:
          title: Name
          type: string
        description:
          title: Description
          type: string
        owner:
          title: Owner group
          type: string
        system:
          title: System
          type: string
        org:
          title: GitHub org
          type: string
          default: myorg
  steps:
    - id: fetch
      name: Fetch skeleton
      action: fetch:template
      input:
        url: ./skeleton
        values:
          name: ${{ parameters.name }}
          description: ${{ parameters.description }}
          owner: ${{ parameters.owner }}
          system: ${{ parameters.system }}
          org: ${{ parameters.org }}
    - id: publish
      name: Publish to GitHub
      action: publish:github
      input:
        repoUrl: github.com?owner=${{ parameters.org }}&repo=${{ parameters.name }}
  output:
    links:
      - title: Repository
        url: ${{ steps['publish'].output.remoteUrl }}
---
# templates/microservice/skeleton/catalog-info.yaml
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: ${{ values.name }}
  description: ${{ values.description }}
  annotations:
    github.com/project-slug: ${{ values.org }}/${{ values.name }}
spec:
  type: service
  lifecycle: experimental
  owner: ${{ values.owner }}
  system: ${{ values.system }}