How betelabs/platform-engineering-idp works
This repository describes an internal developer platform centered on a Backstage self-service portal: developers discover services and launch templates for new services or databases. The documented platform combines catalog and scaffolder services, Crossplane infrastructure APIs, Argo CD GitOps delivery, admission policies, and Terraform-managed cloud infrastructure. The graph preserves these major capabilities using README-documented relationships; source excerpts verify the Backstage home page, catalog processor, and scaffolder setup, but do not establish their wiring to the unsampled infrastructure and delivery configurations.
Main entry points: scaffolder.ts Template Scaffolder · workloads.yaml Argo CD · HomePage.tsx Backstage Portal · catalog.ts Service Catalog
Components 21
Developer Portal
- Backstage Portal
backstage/packages/app/src/components/HomePage.tsx - Service Catalog
backstage/packages/backend/src/plugins/catalog.ts - Catalog Records
backstage/catalog/all.yaml - Teams and Systems
backstage/catalog/groups.yaml
Self-Service Provisioning
- Template Scaffolder
backstage/packages/backend/src/plugins/scaffolder.ts - Microservice Template
catalog-templates/microservice/template.yaml - Database Template
catalog-templates/database/template.yaml - Infrastructure Claims
crossplane/claims/examples - Crossplane API
crossplane/xrds - Resource Compositions
crossplane/compositions
GitOps Delivery
- Argo CD
gitops/argocd/appsets/workloads.yaml - Workload AppSets
gitops/argocd/appsets/workloads.yaml - Platform AppSets
gitops/argocd/appsets/platform-components.yaml - Kubernetes Cluster
- Application Helm Chart
helm/app-template/Chart.yaml
Policy Enforcement
- Admission Policies
policies - Kyverno Rules
policies/kyverno - OPA Rules
policies/opa
Cloud Infrastructure
- Terraform Provisioning
terraform/aws/main.tf - Cloud Infrastructure
Other components
- Developer
Connections 18
- Developer → Backstage Portal: uses
README.md - Backstage Portal → Template Scaffolder: launches templates
README.md - Backstage Portal → Service Catalog: browses catalog
README.md - Service Catalog → Catalog Records: catalogs entities
backstage/packages/backend/src/plugins/catalog.ts - Service Catalog → Teams and Systems: processes entities
backstage/packages/backend/src/plugins/catalog.ts - Template Scaffolder → Microservice Template: runs template
README.md - Template Scaffolder → Database Template: runs template
README.md - Template Scaffolder → Infrastructure Claims: creates infrastructure claim
README.md - Infrastructure Claims → Crossplane API: requests resources
README.md - Crossplane API → Resource Compositions: resolves claims
README.md - Argo CD → Workload AppSets: manages applications
README.md - Argo CD → Platform AppSets: manages applications
README.md - Argo CD → Kubernetes Cluster: syncs workloads
README.md - Kubernetes Cluster → Admission Policies: enforces at admission
README.md - Admission Policies → Kyverno Rules: includes rules
README.md - Admission Policies → OPA Rules: includes rules
README.md - Terraform Provisioning → Cloud Infrastructure: provisions infrastructure
README.md - Application Helm Chart → Kubernetes Cluster: packages workloads