Icon

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 https://console.transposit.com/mc/git/<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:
machine console.transposit.com
login
password

Your cloned git repository will have the following structure:

team_name
├── actions
├── cloudwatch_logs.yaml
├── update_statuspage_incident.yaml
...
└── runbooks
├── web_500s.md
├── reboot_ec2.md
...

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