Setting up BitBucket as a Source

Connecting BitBucket makes it easy to turn your repository content into trusted, searchable knowledge. Learn how to connect your BitBucket repositories, manage permissions, and turn existing code and documentation into resources that power intelligent Answers.

๐Ÿ‘ฅ

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Bitbucket Access: The authenticating user must be an Admin in Bitbucket.

Setting Up BitBucket as a Source

  1. In Guru, go to Manage.
  2. Select Sources, then click Add Source.
  3. Choose Bitbucket from the list of integrations.
  4. Authenticate by finding your workspace ID, navigating to your workspace settings, and copy & paste the Workspace ID when prompted.
  5. Add a display name for the Source (optional) and click Connect Source.
  6. Assign which Guru Groups should have access to this content.

Objects Synced from BitBucket

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During Setup

Objects/Data Brought In

Key Fields

Ticket

Primary Object: Repository issues

โ€ข Name โ€ข Description โ€ข Ticket type โ€ข Status (Enum) โ€ข Priority (Enum) โ€ข Creator (UUID) โ€ข Assignees (Array) โ€ข Project (Unknown) โ€ข Collections (Array) โ€ข Ticket URL โ€ข Remote created at โ€ข Remote updated at โ€ข Remote data

Comment

Comments on issues

โ€ข Body โ€ข HTML body โ€ข User (UUID) โ€ข Ticket (UUID) โ€ข Remote created at โ€ข Remote ID โ€ข Remote data

Attachment

File attachments on issues

โ€ข File name โ€ข File URL โ€ข Ticket (UUID) โ€ข Remote ID โ€ข Remote data

Project

Repository projects

โ€ข Name โ€ข Description โ€ข Remote ID โ€ข Remote data

Collection

Repository collections

โ€ข Name โ€ข Description โ€ข Access level (Enum) โ€ข Remote ID โ€ข Remote data

User

Workspace members

โ€ข Name โ€ข Avatar โ€ข Remote ID โ€ข Remote data

Role

User roles and permissions

โ€ข Name โ€ข Ticket actions (Array) โ€ข Remote data

Permissions

  • When you connect Bitbucket as a source in Guru, you'll permission that content in Guru. Learn more here.
  • If someone is not provided with access in Guru to this source, they will not see Bitbucket results in searches or when chatting with Guru.