What is an Internal Developer Platform (IDP)? #
An Internal Developer Platform (IDP) is a layer on top of the tech and tooling an engineering team has in place already. It helps Ops teams structure their setup and enable developer self-service.
TLDR; Internal Developer Platforms (IDPs) are configured by Ops teams and used by developers. Ops teams specify what resources start up with what environment or at what request. They also set base-line templates for application configurations and govern permissions. This helps them to automate recurring tasks such as spinning up environments and resources and makes their setup easier to maintain by enforcing standards. Developer teams gain autonomy by changing configurations, deploying, spinning up fully provisioned environments, and rollback. IDPs can be built or bought.
How Internal Developer Platforms are used by Ops, DevOps, or Platform teams #
The Ops team primarily runs and configures the IDP. Teams running IDPs concentrate on infrastructure, service level agreements, and workflow-optimization and configure the IDP to abstract away any recurring or repetitive tasks, such as spinning up resources or environments for developers. The Ops team also sets baseline templates for configuration and avoids unstructured scripting to prevent excessive maintenance time. See below for all building blocks that Ops usually operates.
How Internal Developer Platforms are used by application developers #
IDPs integrate into existing workflows which usually remain a git-push deploy workflow but add further automation. The entire deployment process is now at the disposal of the developer. They can request resources, spin up fully provisioned environments, rollback, deploy and set deployment automation ruling autonomously.
Five core components #
Although variations exist, a fully-fledged IDP is made out of five core components. Two features are exclusively used by the Ops, DevOps or Platform team: Infrastructure Orchestration and Role Based Action Control (RBAC). Application Configuration Management is used by the Ops team to set baseline-templates but also used in day-to-day activity by the application development team. Developers use the functionalities Deployment Management and Environment Management.-> Core Components
UI, API, or CLI? #
All of the above-mentioned building blocks are centered around an API. Depending on the maturity of the IDP, an User Interface (UI) or Command Line Interface (CLI) can be built around the API. While many IDPs are CLI based, only a few provide a complementary UI. We also found that teams with the full set (UI, CLI, and API) show the highest satisfaction with the product.
Integrating with all existing tech and tools #
IDPs integrate with all the existing tech and tooling a team has in place already. They integrate mainly through APIs to prevent introducing yet more scripts running in clusters which would increase the security risk and increases maintenance overhead.
On the cluster side, modern IDPs are (in 95% of all cases) built on Kubernetes with containers as workloads. Ops teams usually assign fixed clusters to the platform and assign them to environment types. If a developer requests a new environment, the platform can now set up a namespace in the assigned cluster and take care of updating configurations.
IDPs closely integrate with CI setups by fetching built images needed to update environments or create new ones. External resources such as databases, DNS, and others are connected through resource drivers that signal the success or failure of updating/creating a resource back to the IDP’s API. Those drivers can be Infrastructure as Code (IaC) scripts or simple little services.
Ops tools such as monitoring, chaos engineering, GitOps tools can be plugged into the different workflows of an IDP at the team’s convenience. We’ve compiled a long list of all tools we see commonly used with IDPs.-> Integrations
What happens under the hood? #
Before a developer deploys an environment they specify the type of environment, which tells the IDP what resources should be set to which state. They select the images (workloads) they require in the application, applies changes to the base-line configurations (if necessary), and initiates a deployment. The IDP will now take the changes to the baseline configurations and create a manifest. It will use the functionality of Infrastructure Orchestration and set the right resources into the right state (let’s say the application requires a namespace in GKE, a Postgres database, and a certain DNS setting to run). It will then inject the environment variables into the container and serve the running environment to the developer.
Why is it called an Internal Developer Platform? #
Before we dive into the specifics, let’s briefly look at the reason this category is evolving along with those naming conventions.
- Internal – clearly separated from externally facing platforms such as Twilio’s developer platforms. IDPs are meant for internal use only.
- Developer – indicates the internal customer and the primary user, the application developer.
- Platform – characterizes the product type.
Slight variations exist, but we’ve actively decided against those as the descriptions are less accurate and the risk of misunderstanding is too high. Those include:
- Internal platform (too broad)
- Developer portal/platform (Google it, too much overlap with externally facing portals)
- Application management framework (imprecise)