Chapter 1

Internal Developer Platform Vision

internal developer platformsservice catalogsgolden pathsplatform architecturecontrol plane design

Learning Path

Hands-on Labs

Each objective has a coding lab that opens in VS Code in your browser

Objective 1

Design service catalog data model and golden path templates

Goal

Define the core data structures for platform services, golden path templates, and service catalog entries. Build Pydantic models that represent the platform's offerings to development teams.

Objective 2

Build platform configuration management service

Goal

Implement a configuration management service that stores platform-wide settings, feature flags, and environment-specific overrides in PostgreSQL with Redis caching.

Objective 3

Build service catalog REST API with search and filtering

Goal

Create the API layer that exposes the service catalog to platform consumers. Implement search, filtering by category, and versioned catalog responses.

Objective 4

Integrate platform with Kubernetes cluster discovery

Goal

Connect the platform control plane to the Kubernetes API to discover namespaces, running workloads, and resource availability. Build adapters that sync cluster state into the platform database.

Objective 5

Build platform health dashboard with Prometheus metrics

Goal

Instrument the platform control plane with Prometheus counters, histograms, and gauges. Build Grafana dashboards that show service catalog usage, provisioning latency, and error rates.

Objective 6

Deploy platform control plane with Helm and ArgoCD

Goal

Package the platform control plane as a Helm chart, configure ArgoCD for GitOps-based deployment, and validate the deployment with health checks and smoke tests.