Runbook management

Since Transposit is backed by git, you can manage your runbooks like code. First, we will take a look at how you can locally clone a runbook with Transposit.

Cloning your runbook can be useful for a few different reasons, such as:

  • Duplicating a runbook
  • Backing up a runbook in a git provider (I.e. GitHub, GitLab, etc.)
  • Offline copies of a runbook
  • Versioning a runbook

Cloning a runbook #

  1. Go to Settings > Account.
  2. Copy the Git access token from this page
  3. Clone your repository locally using your Transposit username and your git access token as the password using following command: git clone<YOUR TEAM NAME>. For convenience, you can also create a .netrc file in your home directory that stores these credentials. The file will have an entry like the following:

Your cloned git repository will have the following structure:

├── runbooks
└── workflows
├── cloudwatch_logs.yaml
├── update_statuspage_incident.yaml

If you make any changes, make sure to git push to update the runbook in Transposit.