Core Idea
An IDP is the internal product developers self-serve from: one platform of tools, workflows, and automation behind a portal, so teams ship without wrestling infrastructure themselves.
- The problem an IDP solves, and how it relates to platform engineering.
- Core components: developer portal, service templates, infrastructure automation, CI/CD, observability, security controls.
- Framed as an internal product for developers with a self-service experience.
Introduction
An Internal Developer Platform is a collection of tools, services, workflows and automation that enables software developers to build, deploy, and operate applications through a self-service experience.
Think of it as an internal product for developers. (2. Software-defined Products and Architectures > Product Delivery Model)
Instead of every development team having to learn cloud infrastructure, Kubernetes, CI/CD pipelines, security controls, and monitoring systems, the IDP provides a simpler interface to those capabilities.
The problem an IDP solves
Without an IDP, developers often need to:
- Request infrastructure from operations teams
- Configure CI/CD pipelines manually
- Set up monitoring and logging
- Understand Kubernetes internals
- Handle security and compliance requirements
- Navigate many different tools
This creates delays and increases cognitive load.
An IDP hides much of that complexity behind self-service workflows.
Core components of an IDP
Developer Portal
The central entry point where developers:
- Create services
- Browse documentation
- Discover APIs
- View system ownership
- Access deployment information
Popular example: Backstage
Service Templates
Predefined blueprints for creating applications.
Example:
- Java microservice
- Node.js API
- Python worker
- Frontend application
Infrastructure Automation
Developers request resources without manually configuring cloud infrastructure.
Examples:
- Databases
- Message queues
- Storage buckets
- Kubernetes namespaces
CI/CD
Standardized build and deployment pipelines.
Observability
Built-in: Logging, Metrics, Tracing, Alerting
Security Controls
Integrated:
- Dependency scanning
- Secrets management
- Policy enforcement
- Compliance checks
Relationship to Platform Engineering
Platform engineering teams typically build and maintain the IDP.
So:
- Platform Engineering = the discipline/team
- IDP = the product they build
- Golden Path = the recommended way to use that product