Describe your applications 2 min read

Runbooks

How-to pages for operating an application or component, kept on the Handbook tab — not the same as a repository's setup steps

Updated
On this page

A runbook in the Handbook is a how-to page for operating an application or a component — for example, rolling back a bad deploy. It is not the same as a repository’s setup steps, which install and build the code in a sandbox so Extract and Command Center can run.

Handbook runbooks

Open Runbooks on the Handbook tab of an application or a component. An application’s list also includes its components’ runbooks. Search and the tags on the pages narrow the list.

Draft with DevOps asks the DevOps agent to write a new runbook without leaving the tab. Describe what it should cover, then submit. Viewers can read runbooks but can’t request a draft.

These pages aren’t artifacts.

Repository setup

A repository’s setup is the list of install and build steps that have to pass in a sandbox before a scan or a task can run. Some surfaces still call that list a runbook. To set those steps up or fix them, see Set up a repository for Command Center. In AI Chat, a failed install or build step may offer Fix the runbook — that offer is about setup steps, not a Handbook page.