liveBook · Manning

Platform-managed domain

As explained in Effective Platform Engineering

A platform-managed domain is a domain reserved and administered exclusively by an engineering platform for standardized self-service subdomain use.

A platform-managed domain reserves a domain exclusively for the engineering platform, giving development teams standardized DNS subdomains and ingress patterns through self-service. section 7.1.3

The platform controls the left side of the domain: users cannot create new subdomains, but they can manage the right-of-domain pattern within approved boundaries. This reduces naming and traffic-routing friction without immediately introducing fully custom domains. section 7.1.3

A practical implementation typically provides:

  • Standard subdomains such as api, qa, dev, and preview. section 7.1.3
  • Hosted-zone delegation and ingress configuration that route traffic to platform services. section 7.1.3
  • An evolutionary path toward customer-managed subdomains or custom domains when justified. section 7.1.3
Table 7.1 Zone delegations for the Epetech engineering platform

Subdomain hosted zone delegation

account-1

account-2

prod-i01-aws-us-east-2.epetech.io

X

api.epetech.io

X

qa.epetech.io

X

dev.epetech.io

X

sbx-i01-aws-us-east-1.epetech.io

x

preview.epetech.io

x

Use the zone-delegation table to compare platform-managed environments and account-specific hosted zones. section 7.1.3

How Effective Platform Engineering covers it

How deep it goes
Explains ownership boundaries, staged domain strategies, DNS routing, and hosted-zone delegation with Terraform examples.
Examples
Uses epetech.io with api, qa, dev, preview, and environment-specific hosted-zone delegation.
What it assumes
Assumes product-domain decisions and engaged software-development leadership for naming and ownership choices.
What you can do after
Operate standardized self-service DNS and ingress patterns while deferring custom-domain complexity.
How it connects
Connects DNS, hosted zones, ingress patterns, API gateways, subdomains, and custom domains.

This explainer was generated by Manning's knowledge graph from the text of Effective Platform Engineering. The section links point to the parts of the book it draws on.