We close Chapter 31 (and Part VII) with the idea that ties all of Platform Engineering together: treating Terraform modules as an internal product. Throughout the book, we've seen modules as reusable technical building blocks (Chapter 18). Now we take the mindset leap that distinguishes the most mature organizations: stop seeing modules as "code I share" and start seeing them as a product with customers (other developers), which is designed, maintained, and improved with them in mind. This mindset shift is the essence of Platform Engineering.

Recap: Modules as Reusable Building Blocks

Remember Terraform modules (Chapter 18): reusable infrastructure packages that you define once and use many times. We saw their anatomy (subchapter 18.1), their variables and outputs (subchapter 18.2), their versioning with Git tags (subchapter 18.4)... Technically, you already know how to create them. What this subchapter adds is not technical, but mindset: how to think about those modules when they are the foundation of a platform used by many teams.

The Mindset Shift: From "Shared Code" to "Product"

The key difference between an immature and a mature organization is in how it treats its modules:

   "Shared code" mindset:                  "Product" mindset:
   - I upload it and let them figure it    - I think about my users
   - no clear documentation                - documented and easy to use
   - changes without notice (break others) - versioned, careful changes
   - "it is what it is"                    - gather feedback and improve

Treating modules as an internal product means applying the same mindset you would to a product you sell to customers: thinking about the experience of those who use it, ensuring quality, documenting it well, providing support, and improving it continuously. Your "customers" are the other developers in the company.

Analogy: the difference is like leaving tools scattered in a communal shed versus running a good hardware store. In the shed, everyone dumps their tools; you find them as you can, you don't know if they work, no one maintains them. In a well-managed hardware store, products are organized, labeled, with instructions, someone ensures they work and that what people need is in stock, and you get help if you have questions. Treating modules as a product is moving from the shed to the hardware store: truly thinking about who will use them.

What Treating Modules as a Product Involves

  1. Thinking About the User Experience (the Developers)

The module should be easy to use for someone who is not an expert: clear parameters, sensible default values, a simple interface. You put yourself in the shoes of the user and make their life easier. A good golden path (subchapter 31.1) is born from a module designed with its user in mind.

  1. Quality Documentation

The module comes with clear documentation: what it does, how to use it, examples. Without good documentation, a module is hard to adopt (remember how important documentation is, as we saw with modules in Part IV). A product without a manual doesn't sell.

  1. Careful Versioning and Changes

Remember versioning (subchapter 18.4): product-modules are versioned carefully, so that changes don't break users by surprise. If you're going to make a major change, you communicate it and manage it as a new version, just as a serious product manages its updates. This gives confidence to teams to depend on your modules.

  1. Quality and Testing

Product-modules are tested (remember infrastructure testing, Chapter 21, and contract testing for modules, subchapter 21.4) to ensure they work well. A quality product is reliable; if your modules fail, teams lose trust and go back to doing everything themselves.

  1. Support and Feedback

There is someone (the platform team) who supports module users and gathers their feedback to improve it. Like a product, it evolves by listening to its users: what they're missing, what they struggle with, what they need.

Module as an internal product:
   ✓ designed for the user (easy to use)
   ✓ well documented (with examples)
   ✓ versioned (changes don't break, with confidence)
   ✓ tested (reliable, with testing)
   ✓ with support and continuous improvement (listens to the user)

Why It Matters: It's the Heart of Platform Engineering

This mindset shift is, in reality, the heart of all Platform Engineering (Chapter 31). An Internal Developer Platform is not just "tools"; it's an internal product that the platform team offers to developers as if they were their customers. The golden paths (subchapter 31.1), the Service Catalog (subchapter 31.2), and Backstage (subchapter 31.3) only truly work if this product mindset is behind them: caring for the experience, quality, and continuous improvement.

Well-done Platform Engineering = PRODUCT mindset
   "developers are our customers;
    the platform (and its modules) is our product;
    we care for it, document it, improve it, and provide support."

Without this mindset, an internal platform becomes just another pile of tools that no one wants to use. With it, it becomes something teams happily adopt because it truly makes their work easier.

Real-world example: two companies create Terraform modules for their teams. The first treats them as "shared code": uploads them to a repository without documentation, changes them without notice (breaking other teams), and no one provides support. Result: teams don't trust those modules, prefer to build their own infrastructure, and the platform fails. The second company treats them as an internal product: each module is well documented with examples, carefully versioned (changes never break by surprise), tested, and the platform team provides support and gathers feedback to improve them. Result: teams happily adopt the modules because they save work and are reliable; the platform succeeds, and the company gains speed and consistency. The same technique (modules), but the product mindset made the difference between success and failure.

What You Should Remember

  • The leap for mature organizations is not technical, but mindset: treat Terraform modules as an internal product, not just "shared code." Your customers are the other developers.
  • It's the difference between tools scattered in a shed and a well-managed hardware store (organized, with instructions, maintained, with customer service).
  • Treating modules as a product means: thinking about the user experience (easy to use), quality documentation (with examples), careful versioning (changes don't break, with confidence, Ch. 18.4), quality and testing (reliable, Ch. 21), and support + feedback (continuous improvement by listening to the user).
  • This product mindset is the heart of Platform Engineering: an Internal Developer Platform (with its golden paths, Service Catalog, and Backstage) only succeeds if it is treated as a product cared for its customers. Without it, the platform fails; with it, teams happily adopt it.

You have completed Chapter 31 and, with it, all of Part VII (Reference Architectures and Expert Patterns)! You have reached a level of maturity that few master: Well-Architected, serverless at scale, data platforms, multi-account, and Platform Engineering. All that remains is Part VIII: The Path After the Book, which will guide you in your professional development. We begin in Chapter 32 with AWS certifications.

Cloud, AWS & Terraform — From Zero to Expert

Chapter 1 · What is cloud computing

Chapter 2 · The cloud market and major providers

Chapter 3 · Regions, availability zones and edge

Chapter 4 · Compute: EC2

Chapter 5 · Storage: S3

Chapter 6 · Networking: VPC

Chapter 7 · Identity and access: IAM

Chapter 8 · Managed databases

Chapter 9 · Why Infrastructure as Code

Chapter 10 · HCL: the Terraform language

Chapter 11 · Providers and state

Chapter 12 · Your first real infrastructure in Terraform

Chapter 13 · Load balancing and auto scaling

Chapter 14 · Serverless with Lambda

Chapter 15 · Messaging and events

Chapter 16 · Content delivery and DNS

Chapter 17 · Containers on AWS

Chapter 18 · Modules: reuse and composition

Chapter 19 · Workspaces and environment management

Chapter 20 · Remote backends and locking

Chapter 21 · Infrastructure testing

Chapter 22 · Terraform in CI/CD

Chapter 23 · Defense in depth

Chapter 24 · Observability: logs, metrics and traces

Chapter 25 · Cost optimization

Chapter 26 · High availability and disaster recovery

Chapter 27 · AWS Well-Architected Framework

Chapter 28 · Serverless architectures at scale

Chapter 29 · Data platforms on AWS

Chapter 30 · Multi-account and landing zones

Chapter 31 · Platform Engineering and Internal Developer Platform

Chapter 32 · Relevant AWS certifications

Chapter 33 · Projects to consolidate what you've learned

Chapter 34 · Resources and community

© Copyright 2024. All rights reserved