Buoyant’s Linkerd Production Runbook
A guide to running a service mesh in production

Last update: Sep 7, 2022 / Linkerd 2.12.0

Welcome to Buoyant’s Linkerd Production Runbook!

We’re thrilled that you’re taking Linkerd to production. Today, organizations around the globe rely on Linkerd for their mission-critical systems—including Buoyant itself. You’ll be in great company.

This goal of this guide is to provide concrete, practical advice for deploying and operating Linkerd in production environments. We’ve written this guide based on our experience helping organizations large and small adopt Linkerd, as well as our experience running Linkerd ourselves.

Note: much of what we've written about in this doc is done automatically for you with Buoyant Cloud. If you'd like us to automate and maintain your Linkerd deployment for you, please book a demo of Buoyant Cloud to learn more. Otherwise, read on!

How to use this guide

This runbook is meant to be used in conjunction with the official Linkerd docs. While this guide will give you our advice for getting to (and staying in!) production, the  docs contain the majority of the information you’ll actually need to understand to be successful with Linkerd. Whenever possible, we’ll point to the relevant docs section from this guide.

This is a living document.” Linkerd moves fast. We’ll update this guide for every release and add our release commentary to the Upgrade Notes.

Finally, please read the important Disclaimer section. We do our best to ensure this doc is accurate, but mistakes, omissions, and inaccuracies do happen. Ultimately, you are responsible for your production systems, not us. (But if you do find an error in the guide, by all means please tell us!)

Let’s get started!