liveBook · Manning

Role-based network structure

As explained in Effective Platform Engineering

A role-based network structure organizes clusters and their networks according to operational roles such as production, nonproduction, and preview.

A role-based network structure organizes clusters and their dedicated VPCs around operational roles such as production, nonproduction, preview, development, quality assurance, and product management. The role can span multiple clusters and regions, so network capacity and naming must support growth, replacement, and lookup. section 7.2.1

Apply the pattern by:

  • Reserving IP space large enough for every network that a role may eventually require. section 7.2.1
  • Naming each VPC after its Kubernetes cluster, using role, business line, instance, cloud provider, and region. section 7.2.1
  • Separate platform development and preview from user-facing nonproduction and production so changes can be tested progressively. section 7.2.1

Role-and-region naming

Names such as sbx-i01-aws-us-east-1 and prod-i01-aws-us-east-2 identify role, instance, provider, and region while giving Terraform a predictable VPC lookup key. section 7.2.1

sbx-i01-aws-us-east-1
prod-i01-aws-us-east-2

Use the naming examples to inspect how role and region are encoded in cluster and VPC identifiers. section 7.2.1

How Effective Platform Engineering covers it

How deep it goes
Defines dedicated VPCs, IP planning, naming, Terraform lookup, and environment separation without detailing full provisioning implementation.
Examples
Uses sbx-i01-aws-us-east-1, prod-i01-aws-us-east-2, multi-environment pipelines, and VPC subnet allocations.
What it assumes
Assumes familiarity with Kubernetes clusters, VPCs, platform environments, regions, and Terraform data-resource lookups.
What you can do after
Operate/configure scalable cluster networks with predictable names, reserved address space, and staged platform-change exposure.
How it connects
Connects VPCs with Kubernetes clusters, Terraform, IP addressing, regions, and platform environments.

Related concepts

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.