Cloning Runbooks

Oops, you’ve found our legacy documentation! Go here to read the current version of this page.

Since Transposit is backed by git, you can manage your runbooks as 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 the command line 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 <YOUR TRANSPOSIT USER NAME>
        password <YOUR GIT ACCESS TOKEN>

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.