Configuring Runbooks

Since Transposit is backed by git, you can manage your runbooks like code.

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

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

You can locally clone a runbook with Transposit, as described below.

  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 command below.

git clone https://console.transposit.com/mc/git/<YOUR TEAM NAME>.

Note: For convenience, you can create a .netrc file in your home directory that stores these credentials. The file will have an entry as below.

machine console.transposit.com
login
password

Your cloned git repository will have the structure below.

team_name
├── runbooks
├── web_500s.md
├── reboot_ec2.md
...

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