Connect a Bitbucket repository
Tracewell reads your code to investigate tickets. You sign in to Bitbucket Cloud once, then pick the repositories Tracewell may read, with read access only: Tracewell can’t push, open pull requests or change settings.
Before you start
Section titled “Before you start”- You’re an admin of your Tracewell workspace.
- Connect with a Bitbucket user who can read the repositories.
Connect repositories
Section titled “Connect repositories”- In Tracewell, open Settings → Connections. Under Connect repositories, select Bitbucket, then Continue to Bitbucket.
- Sign in to Bitbucket if it asks you to.
- Bitbucket shows what Tracewell asks for: read access to your account and your repositories. Click Grant access.
- Bitbucket sends you back to Tracewell, which lists the repositories your user can read in one of your workspaces. Choose another under Workspace if you need to. Select the repositories to connect and select Connect. Do this within an hour.
For repositories in another workspace, open the Bitbucket card, select Add repositories, and choose that workspace.
Tracewell checks that you can read each repository, and they show as connected.
What Tracewell can read
Section titled “What Tracewell can read”Bitbucket has no permission for a single repository: the access you grant reads every repository your Bitbucket user can read. Tracewell only reads the repositories you picked.
To keep Tracewell’s access to those repositories, connect with a Bitbucket user who can only read them.
Bitbucket’s read access to repositories also lets an app use the repositories’ issue trackers and wikis. Tracewell doesn’t use them. Read access to your account is only used for your name and the list of your workspaces, while you pick repositories. Bitbucket also lists your email address; Tracewell never reads it.
If connecting fails
Section titled “If connecting fails”| Tracewell says | What to do |
|---|---|
| The Bitbucket user who approved the connection can’t read … | Ask the repository’s admin for read access, or connect with another user. |
| You can’t read any repository in … | Choose another workspace, select Use another account, or ask for access in Bitbucket. |
| The Bitbucket sign-in expired, or was used already | You took longer than an hour to pick the repositories. Connect Bitbucket again. |
The messages every provider shows are in Manage connections.
Revoke Tracewell’s access
Section titled “Revoke Tracewell’s access”Disconnecting a repository under Settings → Connections stops Tracewell reading it, but Bitbucket gives Tracewell no way to revoke its access. To revoke it:
- In Bitbucket, click the gear icon in the top right and choose Personal Bitbucket settings.
- Choose Connected apps.
- Find Tracewell and revoke its access.
Tracewell can then no longer read any of your repositories, and their cards show an error.