Bitbucket Repositories
- Manas Bajaj
- Siddharth Miglani
In this section, the Syndeia Web Dashboard capabilities for Bitbucket repositories are presented.
Pre-Requisites
Check supported versions of Bitbucket here: https://intercax.atlassian.net/wiki/spaces/SYN34/pages/2503639738
Tutorials
See the Bitbucket integration tutorial for Syndeia Web Dashboard - Part 23 - Bitbucket on Web Dashboard.
Add a Bitbucket Repository
(1) Click the Repositories icon in the LHS menu pane.
(2) Select Bitbucket in the list of Repository types on the LHS and click on the + icon to add a new Bitbucket repository, as shown below.
(3) Fill out the details for your Bitbucket server (repository), as shown below, and click the Create button.
URL - Base URL of your Bitbucket repository.
For Bitbucket Cloud (
bitbucket.org), usehttps://api.bitbucket.orgFor Bitbucket Server deployed in your organization, check the URL from your Bitbucket Server administrator.
Name - Name of the Bitbucket repository. Provide a unique name to distinguish this Bitbucket repository from others you may add.
Description - Description of the Bitbucket repository
Authentication type - Basic (default)
Username - Username to sign in to your Bitbucket repository.
Enter the Bitbucket username, or
Enter the email address associated with your Bitbucket account
Password - Password to sign in to your Bitbucket repository.
If you have entered your Bitbucket username in the Username field,
Either enter the password you use to sign in to the Bitbucket web client, or
Enter the Personal Access Token. To create a Personal Access Token, refer here - https://docs.Bitbucket.com/en/Bitbucket/authenticating-to-Bitbucket/keeping-your-account-and-data-secure/creating-a-personal-access-token
If you have entered the email address associated with your Bitbucket account in the Username field,
Enter the password you use to sign in to the Bitbucket web client
Browse a Bitbucket Repository
(1) Expand the Bitbucket repository after it has been added.
(2) If your repository details are correct, Syndeia Cloud will try to sign in to the Bitbucket and display various Bitbucket workspaces relevant to you.
(3) Expand any of the workspaces for a list of Git repositories under that workspace.
(4) If you do not see all of the Git repositories listed, click on the cloud icon in the upper right corner of the screen (as shown below) to fetch more results. You can keep on doing that until that icon is greyed out which means that there are no more results to fetch.
(5) Expand a Git Repository to view contents organized by Branches, Commits, and Tags
(6) Branches - Expand the Branches category to view all Branches in the Git Repository, as shown in the view above. Expand a Branch to views its file and folder contents.
(7) Commits - Expand the Commits category to view all Commits in the Git Repository. Expand a Commit to view files modified in that Commit and the complete list of contents (folders and files) at that commit.
(8) Tags - Expand the Tags category to view all Tags in the Git Repository, as shown in the view below.
Search a Bitbucket Repository
Users can search for Git Repositories or resources in a Git Repository. Click on the Search icon on the RHS to see the Search tab.
(1) Search for Git Repositories
Select the Workspace (Workspace Scope dropdown) in which you want to search for Git Repositories.
Select the Repository option, as shown below.
Specify any text string contained in the name of the Git Repositories you are searching for.
Click the Search button. Results are shown on the RHS.
(2) Search resources in a Git Repository
Select the Workspace (Workspace Scope dropdown) in which you want to search for Git Repositories.
Select the Resources in a repository option, as shown below.
Select a specific Git Repository from the drop-down as shown below.
Select the type of resource you want to search in the selected Git Repository. You can search for Branches, Commits, or Tags in a Git Repository.
Branch search
Select branch in the Select Type dropdown, as shown below.
Specify any text string contained in the name of the branch(es) you are searching for.
Click the Search button. Results are shown on the RHS.
Commit search
Select commit in the Select Type dropdown, as shown below.
Specify any text string contained in the message of the commit(s) you are searching for.
Click the Search button. Results are shown on the RHS.
Tag search
Select tag in the Select Type dropdown, as shown below.
Specify any text string contained in the name of the tag(s) you are searching for.
Click the Search button. Results are shown on the RHS.
Digital Thread Explorer
(1) See an overview of the Digital Thread Explorer - https://intercax.atlassian.net/wiki/spaces/SYN34/pages/2493317967
(2) See the tutorial for Bitbucket integration on Syndeia Web Dashboard - Part 23 - Bitbucket on Web Dashboard.
The Digital Thread Explorer will only display inter-model relations between Bitbucket artifacts and artifacts in other repositories/tools. Intra-model relations, i.e. relationships between Bitbucket artifacts, are not applicable.
Creating Relations
(1) See an overview of the Creating Relations - https://intercax.atlassian.net/wiki/spaces/SYN34/pages/2491384699
(2) See the tutorial for Bitbucket integration on Syndeia Web Dashboard - Part 23 - Bitbucket on Web Dashboard.