Skip to main content

Glossary

TermDefinition
IDPInternal Developer Platform — the sum of all tools, conventions, and workflows that allow engineers to self-serve infrastructure
Golden PathA pre-approved, convention-compliant pathway for a common workflow, encoded as a Backstage Scaffolder template
DomainAn ownership boundary in the catalog. Maps to a Backstage Domain entity, an ArgoCD AppProject, and a {domain}-gitops repository
SystemA logical product grouping within a domain. Contains one or more services (Components)
ComponentA single deployable unit — service, worker, frontend, cronjob — within a system
ResourceA cloud infrastructure asset (database, cluster, queue) that a Component depends on
Claim (XRC)A Crossplane Composite Resource Claim — a Kubernetes object that declares desired cloud infrastructure
XRDCrossplane Composite Resource Definition — defines the API for a resource type (e.g. GKECluster)
CompositionA Crossplane resource that implements an XRD for a specific cloud provider
ApplicationSetAn ArgoCD resource that generates multiple Applications from a template and generator
App of AppsA single ArgoCD Application that manages all other Applications and ApplicationSets
Infra namespaceA Kubernetes namespace ({domain}-{env}-infra) dedicated to Crossplane Claims, separate from app namespaces
Sealed SecretA Kubernetes Secret encrypted with the cluster's public key — safe to commit to Git
ReflectorA Kubernetes operator that mirrors Secrets and ConfigMaps across namespaces
Sync waveAn ArgoCD ordering mechanism that controls which resources are applied first within a sync operation
DORA metricsFour key DevOps performance indicators: deployment frequency, lead time for changes, change failure rate, and MTTR
GitOpsOperational model where Git is the single source of truth for deployed state, with automated reconciliation