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.
- Go to Settings > Account.
- Copy the Git access token from this page.
- 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.