Source Code Management (Git) Systems Integration
Metrics calculated by GIT data
Having configured GIT the following metrics will be available:
Select data source
1. On the main menu, click Perf, and then open the required unit.
2. On the right of the toolbar, click the Configure Data Sources icon. The Data Sources Configuration Step 1. Choose Data Source opens.
3. On the Step 1. Choose Data Source select your data source.
PERF application supports several services for GIT hosting server:
Azure Repos GIT;
BitBucket;
BitBucket Server (Stash);
GitHub;
GitLab.
4. On the Step 2. Configure Source set data source configuration.
1. Configure credentials
Configure Git Lab
Provide API URL. API url is usually the same as the web url. Details of the api are at https://docs.gitlab.com/ee/api/;
Provide Instance URL;
Connect by:
Login & Password, or
API Token (https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html);
Click Connect.
On how to obtain Access Tokens please refer to https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html.
Minimum required scopes for Personal Access Tokens: GitLab: read_api, read_repository
If you use https://git.epam.com/ for successful repository name validation also need to provide to user auto_epm-dce_perf-vcs@epam.com permissions on your project (Reporter will be enough)
Configure Git Hub
Provide API URL. API url usually differs from the web url you see in your web browser. For GitHub cloud the API url is https://api.github.com (more information here), for GitHub Enterprise the API url is
http(s)://[hostname]/api/v3/
(more information here);Provide Instance URL. GitHub instance URL ishttps://github.com.
Specify Username;
Enter API Token;
Click Connect.
Configure Bitbucket (cloud)
Provide API URL. API url is https://api.bitbucket.org, Web url is https://bitbucket.org;
Provide Instance URL;
Specify Workspace ID;
Enter Login (Bitbucket username) & Password (about app passwords: https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/);
Click Connect.
Configure Bitbucket Server (Stash)
Provide API URL;
Provide Instance URL;
Specify Project;
Connect by:
Login (Bitbucket username) & Password, or
API Token;
Click Connect.
Configure Azure Repos
Provide API URL. API URL has to contain an organization name. Ex.: https://dev.azure.com/myorganization.
Provide Instance URL;
Specify Project;
Connect by:
Login & Password, or
API Token;
Click Connect.
GITLab | GITHub |
---|---|
Bitbucket | Azure Repos |
Bitbucket (cloud) Bitbucket Server (Stash) |
2. Configure Repositories and Branches
Open the Repositories/Branches step.
Select the required repository (you can use the Search function).
To add another repository, click on "Add Repository +"
For the added repository, select the necessary branches using the search feature.
To select all availble branches, click 3-dots button and select “All Brunches”
Cleck Next.
4. Configure advanced settings
The configuration of the Advanced settings is optional. The advanced settings are as follows:
Optional Action | Metric Affected |
---|---|
Select the Include merge requests into statistics checkbox | |
In the Files to Exclude box, enter file wildcards to exclude files with the defined extensions |
5. Complete configuration process
To complete GIT configuration:
Click Save. The Run Data Load button appears.
Click Run Data Load to start data loading from GIT.