Terraform: Up & Running

By Yevgeniy Brikman

This book is the fastest way to get up and running with Terraform, an open source tool that allows you to define your infrastructure as code and to deploy and manage that infrastructure across a variety of public cloud providers (e.g., AWS, Azure, Google Cloud, DigitalOcean) and private cloud and virtualization platforms (e.g. OpenStack, VMWare).

This is a hands-on-tutorial that not only teaches you DevOps principles, but also walks you through code examples that you can try at home. You'll go from deploying a basic "Hello, World" Terraform example all the way up to running a full tech stack (server cluster, load balancer, database) that can support a large amount of traffic and a large team of developers—all in the span of just a few chapters.

By the time you're done, you'll be ready to use Terraform in the real world.

Order Now

About the book

This book is for Sysadmins, Operations Engineers, Release Engineers, Site Reliability Engineers, DevOps Engineers, Infrastructure Developers, Full Stack Developers, Engineering Managers, CTOs, and anyone else responsible for the code after it has been written. If you're the one managing infrastructure, deploying code, configuring servers, scaling clusters, backing up data, monitoring apps, and responding to alerts at 3AM, then this book is for you.

Ch 1: Why Terraform

How DevOps is transforming the way we run software; an overview of infrastructure as code tools, including configuration management, server templating, orchestration, and provisioning; the benefits of infrastructure as code; a comparison of Terraform, Chef, Puppet, Ansible, SaltStack, OpenStack Heat, and CloudFormation; how to combine tools such as Terraform, Packer, Docker, Ansible, and Kubernetes.

Ch 2: Terraform Syntax

Installing Terraform; an overview of Terraform syntax; an overview of the Terraform CLI tool; how to deploy a single server; how to deploy a web server; how to deploy a cluster of web servers; how to deploy a load balancer; how to clean up resources you've created.

Ch 3: Terraform state

What is Terraform state; how to store state so multiple team members can access it; how to lock state files to prevent race conditions; how to manage secrets with Terraform; how to isolate state files to limit the damage from errors; how to use Terraform workspaces; a best-practices file and folder layout for Terraform projects; how to use read-only state.

Ch 4: Terraform modules

What are modules; how to create a basic module; how to make a module configurable; local values; versioned modules; module tips and tricks; using modules to define reusable, configurable pieces of infrastructure.

Ch 5: Terraform tips & tricks

Advanced Terraform syntax; loops; if-statements; if-else statements; for and for-each expressions; built-in functions; zero-downtime deployment; common Terraform gotchas and pitfalls, including count limitations, zero-downtime deployment gotchas, valid plans can fail, refactoring problems, and eventual consistency.

Ch 6: Production-grade Terraform code

Why DevOps projects always take longer than you expect; the production-grade infrastructure checklist; how to build Terraform modules for production; small modules; composable modules; testable modules; releasable modules; Terraform Registry; Terraform escape hatches.

Ch 7: How to test Terraform code

Manual tests for Terraform code; sandbox environments and cleanup; automated tests for Terraform code; Terratest; unit tests; integration tests; end-to-end tests; dependency injection; running tests in parallel; test stages; retries; the test pyramid; static analysis; property checking.

Ch 8: Using Terraform as a team

How to adopt Terraform as team; how to convince your boss; a workflow for deploying application code; a workflow for deploying infrastructure code; version control; the golden rule of Terraform; code reviews; coding guidelines; Terraform style; CI / CD for Terraform; deployment process.

Code samples

The book includes dozens of code samples. You can find the code here: https://github.com/brikis98/terraform-up-and-running-code.

Second edition

The book is now in its 2nd edition, which is nearly double the length of the 1st edition (~160 more pages), including two completely new chapters (Production-grade Terraform Code and How to Test Terraform Code), and major changes to all the original chapters and code examples. Check out the 2nd edition announcement blog post for the details on what changed!

About the author

Yevgeniy Brikman

Yevgeniy (Jim) Brikman is the co-founder of Gruntwork, a company that offers DevOps as a Service. Gruntwork makes extensive use of Terraform to help customers get their entire infrastructure, defined as code, in about a day.

Jim is also the author of another O'Reilly book called Hello, Startup: A Programmer's Guide to Building Products, Technologies, and Teams, which has a 4.9/5 rating on Amazon and 4.5/5 rating on GoodReads. Previously, he worked as a software engineer at LinkedIn, TripAdvisor, Cisco Systems, and Thomson Financial and got his BS and Masters at Cornell University. For more info, check out ybrikman.com.

Buy the book

Terraform: Up & Running, 2nd edition is available at the online stores below and at your local bookstore.


Subscribe to the Terraform: Up & Running Newsletter! Get the latest news, blog posts, and talks on Terraform and DevOps. No spam, ever.

SE Radio Interview: Yevgeniy Brikman on Infrastructure as Code Best Practices

Check out Yevgeniy Brikman's podcast interview with Software Engineering Radio on Infrastructure as Code best practices. The discussion covers similarities and differences between conventional software engineering and code-driven infrastructure; factoring code into modules; layering; terraform code organization for micro-services; releases and tagging; code reviews; unit testing infrastructure; deployment of infrastructure; ownership and code structure models; and open source and re-usable libraries.

Listen to the podcast! »

Automated Testing for Terraform, Docker, Packer, Kubernetes, and More

This talk from QCon SF is a step-by-step, live-coding class on how to write automated tests for infrastructure code, including the code you write for use with tools such as Terraform, Kubernetes, Docker, and Packer. Topics covered include unit tests, integration tests, end-to-end tests, test parallelism, retries, error handling, static analysis, and more.

Check out the video and slides! »

Terraform: Up & Running, 2nd edition has been published!

Terraform: Up & Running, 2nd edition, has been published! It's available on Amazon, O'Reilly, and at all major bookstores. The 2nd edition is nearly double the length of the 1st edition (~160 more pages), including two completely new chapters (Production-grade Terraform Code and How to Test Terraform Code), and major changes to all the original chapters and code examples (everything is now updated through Terraform 0.12).

Get a copy! »

Early release of Terraform: Up & Running, 2nd edition!

The early release of Terraform: Up & Running, 2nd edition, is now available! The 2nd edition is nearly double the length of the 1st edition (~160 more pages), including two completely new chapters (Production-grade Terraform Code and How to Test Terraform Code), and major changes to all the original chapters and code examples to take into account 4 major Terraform releases (everything is now updated through Terraform 0.12), the Terraform state revamp (including backends, locking, and workspaces), Terraform providers split, Terraform Registry, HCL2, and much more. Check out Terraform: Up & Running, 2nd edition announcement blog post for all the details!

Read the Early Release now! »

Terraform: Up & Running has been translated into Korean!

Terraform: Up & Running is now available in Korean!

Grab a copy on aladin.co.kr! »

Lessons learned from writing over 300,000 lines of infrastructure code

This talk from HashiConf 2018 is a concise masterclass on how to write infrastructure code. I share key lessons from the "Infrastructure Cookbook" we developed at Gruntwork while creating and maintaining a library of over 300,000 lines of infrastructure code that's used in production by hundreds of companies. Come and hear our war stories, laugh about all the mistakes we’ve made along the way, and learn what Terraform, Packer, Docker, and Go look like in the wild.

Check out the video, slides, and blog post! »

How to Build Reusable, Composable, Battle-tested Terraform Modules

This is my talk from HashiConf 2017 where I introduce the work we've been doing at Gruntwork with Terraform Modules. I explain how modules work, how to design modules so they are highly configurable and reusable, and how to write automated tests for your Terraform code. Most importanly, I show you how you can use modules to build your entire tech stack on top of proven, battle-tested infrastructure code—in minutes.

Check out the video and slides! »

Terraform training at Velocity Conference

I'll be running a 2-day training course at Velocity Conference in NYC. Learn Terraform through real-world examples: deploy servers, DBs, and load balancers on AWS; build immutable infrastructure with Docker and Packer; put it all together in a continuous delivery pipeline.

Sign up for the course today! »

Why Use Terraform?

Learn what Terraform does, and how it compares to Chef, Puppet, Ansible, CloudFormation, and other tools.

Read the article on O'Reilly Radar »

Terraform: Up & Running is published!

The final version of Terraform: Up & Running has been published and the ebook and print edition are now available online and in your local bookstores!

Get your copy now! »

Early Release

The early release of Terraform: Up & Running is now available! Grab a copy of the ebook before the final version is done so you can start learning today. You'll receive new chapters and updates as they are written, plus the final ebook bundle when the book is released.

Get your copy at the O'Reilly Store »

An intro to Docker, Terraform, and Amazon ECS

This talk is a very quick intro to Docker, Terraform, and Amazon's EC2 Container Service (ECS). In just 15 minutes, you'll see how to take two apps (a Rails frontend and a Sinatra backend), package them as Docker containers, run them using Amazon ECS, and to define all of the infrastructure-as-code using Terraform.

See the presentation on SlideShare »