Skip to main content
Cloud & Infrastructure OpsLast reviewed 2026-09-20

Platform Engineering

The internal platform run as a product: golden paths that make the right architecture the default, self-service for teams, and SLOs the platform answers for.

Overview

Read the full Platform Engineering guidance
WHAT IT IS. Platform engineering treats the internal developer platform as a product with users (your engineers), a roadmap, and adoption metrics. Its surface is the golden path: a paved, templated route from "new service" to "running in production with pipelines, telemetry, and SLOs wired" that works without reading a wiki. Underneath sit the portal/catalog, templating, and the runtime the paved road deploys onto. Team Topologies (linked below) names the organizational shape: a platform team serving stream-aligned teams, measured by how much it reduces their cognitive load — not by the technology it ships. WHY IT EXISTS. Every product team rebuilds the same twenty decisions — repo layout, pipeline, runtime, secrets, dashboards — each slightly differently, so the estate fragments and the ops burden multiplies. A central platform that requires tickets just moves the queue. The product framing fixes both: golden paths make the well-supported route the path of least resistance, and self-service means adopting it costs a teams' afternoon, not a Jira epic. WHEN TO USE IT. When two or three stream teams feel the same friction repeatedly — the third team hand-rolling its own pipeline is the signal. Below that, a shared template repo is honest and cheaper. The anti-pattern is a platform built before its users exist: internal products die the same death as external ones nobody asked for. WHO OWNS IT. A platform team of product-shaped engineers: it interviews users, keeps a public roadmap, deprecates what nobody adopted, and answers for the platform's own SLOs — portal availability, template freshness, time-to-green-pipeline. Product teams are customers with a real alternative: if the paved road is worse than the dirt road, they leave, and that churn is the metric that matters. WHAT GOOD LOOKS LIKE. A new service reaches production through self-service in under a day, with CI/CD, secrets, dashboards, alerts, and an SLO scaffold attached by default. Platform adoption grows because the golden path is genuinely the easiest route, not because mandates say so. The ticket queue between product and platform trends toward zero. The platform has its own SLOs and its own incident reviews — the product team pages the platform team when the paved road breaks, and that is healthy. HOW TO IMPLEMENT. Find the single developer journey with the worst time-to-value (usually "new service to production" or "local dev to staging"). Build the thinnest golden path for exactly that journey — template, pipeline, runtime wiring — and measure time-to-first-deploy before and after. Add the next journey only when the first has adopters who did not have to be asked. Resist the portal-everything phase; a catalog nobody maintains is worse than a README. HOW TO ASSESS YOURSELF. Score the platform's own readiness like any product: /assess covers deployment automation, progressive delivery, and the telemetry the golden path must emit. The maturity ladder below runs from shared scripts (L1) to a self-service platform with SLOs and adoption metrics (L5). Related: /devops is the model the platform productizes, /gitops is how declared state stays true, /observability-engineering is what the paths instrument, /cloudops owns the estate beneath.

Capabilities

  • Golden Paths

    Templated, supported routes from new service to production that make the right architecture the default.

  • Internal Developer Portal

    A catalog of services, owners, and scorecards that makes the estate navigable.

  • Monitoring Coverage

    Metrics and health signals across the full estate, including the parts nobody owns.

  • Platform SLOs

    The internal platform answers for its own reliability targets: portal, pipelines, and runtime.

  • Self-Service Provisioning

    Teams get production-ready infrastructure through templates without filing tickets.

Practices

  • Platform as Product

    Run the internal platform with users, a roadmap, adoption metrics, and deprecation discipline.

  • Toil Budgeting

    Measuring and capping manual operational work to fund automation.

  • You Build It, You Run It

    The team that owns the code owns it in production — deploys, telemetry, and pager included.

Metrics

  • Golden Path Adoption

    Share of new services created through the platform's golden paths.

    Unit: %. Good direction: up.

  • Platform Ticket Volume

    Tickets filed to provision what should have been self-service.

    Unit: tickets/week. Good direction: down.

  • Time to First Deploy

    Time from new-service template run to first production deployment.

    Unit: hours. Good direction: down.

  • Toil Ratio

    Share of engineering time spent on manual, repetitive operational work.

    Unit: %. Good direction: down.

Tools

  • Argo CD

    CNCF-hosted GitOps controller that reconciles Kubernetes clusters against Git declarations.

    Visit site ↗
  • Backstage

    CNCF-hosted framework for internal developer portals, catalogs, and golden-path templates.

    Visit site ↗
  • OpenTelemetry

    Vendor-neutral instrumentation standard for traces, metrics, logs.

    Visit site ↗

Architecture patterns

Reference architectures and their trade-offs live in the blueprints library.

Maturity

  1. L1 ReactiveShared scripts and wikisrequired stage

    Onboarding knowledge lives in documents nobody maintains.

  2. L2 RepeatableTemplate repositories

    Service templates exist; adopting them is voluntary and partly manual.

  3. L3 StandardizedGolden paths with self-servicerequired stage

    New services reach production through the paved road in under a day, wiring included.

  4. L4 MeasuredPlatform run as a product

    Adoption is measured, the roadmap is public, and the platform answers for its own SLOs.

  5. L5 OptimizedPlatform steers the estate

    Golden paths make the well-supported architecture the default; platform metrics drive investment.

Maturity for platform engineering is measured, not guessed — every score traces to your answers. See how maturity is scored.

Put it to work

Sources