GitLab Repositories

Owned by Debesh Roy Chowdhury
May 20, 2022
4 min read

In this section, the Syndeia Web Dashboard capabilities for GitLab repositories are presented.

 

Pre-Requisites

Check supported versions of GitLab here: Syndeia 3.5 - Integration Compatibility

Tutorials

See the GitLab integration tutorial for Syndeia Web Dashboard - Part 24 - GitLab on Web Dashboard.

Add a GitLab Repository

(1) Click the Repositories icon in the LHS menu pane.

(2) Select GitLab in the list of Repository types on the LHS and click on the + icon to add a new GitLab repository, as shown below.

 

(3) Fill out the details for your GitLab server (repository), as shown below, and click the Create button.

  • URL - Base URL of your GitLab repository.

    • For GitLab cloud (gitlab.com), use https://gitlab.com.

    • For GitLab Enterprise deployed in your organization, check the URL from your GitLab Enterprise administrator.

  • Name - Name of the GitLab repository. Provide a unique name to distinguish this GitLab repository from others you may add.

  • Description - Description of the GitLab repository

  • Authentication type - Basic (default)

  • Personal Access Token - Enter the Personal Access Token token to sign in. To create a Personal Access Token, refer here - https://docs.GitLab.com/en/GitLab/authenticating-to-GitLab/keeping-your-account-and-data-secure/creating-a-personal-access-token

Browse a GitLab Repository

(1) Expand the GitLab repository after it has been added.

(2) If your repository details are correct, Syndeia Cloud will try to sign in to the GitLab repository and display three categories of Projects, as shown below:

  • Group Projects - Lists all Groups that you are a member of. Expand any Group to view the Projects accessible to you in that Group.

  • Personal Projects - Lists all of your personal Projects.

  • All Projects - Lists all the Projects that you are a member of.

 

(3) Expand a Project to view contents organized by Branches, Commits, Issues, and Tags

(4) Branches - Expand the Branches category to view all Branches in the Project, as shown in the view above. Expand a Branch to views its file and folder contents..

(5) Commits - Expand the Commits category to view all Commits in the Project.

(6) Issues- Expand the Issues category to view all Issues in the Project.

(7) Tags - Expand the Tags category to view all Tags in the Project, as shown in the view above.

Search a GitLab Repository

Users can search for Projects or resources in a Project. Click on the Search icon on the RHS to see the Search tab.

(1) Search for Projects

  • Select the Project option, as shown below.

  • Select the Group in which you want to search for Projects. Select Any if you want to search for Projects in all Groups.

  • Specify any text string contained in the name of the Project you are searching for.

  • Click the Search button. Results are shown on the RHS.

(2) Search resources in a Project

  • Select the Resources in a project option, as shown below.

  • Select a specific Project from the drop-down as shown below.

  • Select the type of resource you want to search for in the selected Project. You can search for Branches, Commits, Issues, 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.

  • Issue search

    • Select issue in the Select Type dropdown, as shown below.

    • Specify any text string contained in the title of the issue(s) you are searching for.

    • Click the Search button. Results are shown on the RHS.

  • File (source code) search

    • Select source in the Select Type dropdown, as shown below.

    • Specify any text string contained in the file(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 - Digital Thread Explorer (DTE)

(2) See the tutorial for GitLab integration on Syndeia Web Dashboard - Part 24 - GitLab on Web Dashboard.

The Digital Thread Explorer will only display inter-model relations between GitLab artifacts and artifacts in other repositories/tools. Intra-model relations, i.e. relationships between GitLab artifacts, are not applicable.

Creating Relations

(1) See an overview of the Creating Relations - Creating Relations on the Web Dashboard

(2) See the tutorial for GitLab integration on Syndeia Web Dashboard - Part 24 - GitLab on Web Dashboard.