Fields Used to Configure a SCM Git Instance
The following settings are used to configure a SCM Git instance.
Setting Used to Configure a SCM Git Instance
|
|
|
|
Git Repository URL(s)
|
Enter (or manage) one or more the repository URLs. You can enter a maximum of 50 URLs.
For more information about adding and managing URLs in this field, see Adding and Managing Repository URLs in the “Git Repository URL(s)” Field.
|
|
Git Username
|
Provide the user name for authenticated access to all repositories listed in Git Repository URL(s) for this instance.
Leave this and the Git Password field blank for an “anonymous” or SSH access. The blank values force the system to look for an SSH key pair on the server instead of attempting to verify a user name and password. (The Code Insight Installation & Configuration Guide provides for instructions on configuring Git over SSH.)
Consult the Code Insight System Manager to ensure you are using the correct user credentials.
|
|
Git Password
|
Enter the password associated with the user name provided.
Leave this and the Git Username field blank for an “anonymous” or SSH access.
See the Git Username description for more information.
|
| |
This setting includes the Include submodules during sync check box.
The Include submodules during sync check box selection enables you to configure the Git instance to include submodules. By default, the Include submodules during sync check box is selected.
If you prefer not to include any submodule in the Git repositories configuration, unselect the Include submodules during sync check box.
|
Adding and Managing Repository URLs in the “Git Repository URL(s)” Field
The following describes how to manage repository URLs in the Git Repository URL(s) field.
Adding URLs
Use following instructions to add URLs to the Git Repository URL(s) field.
To add a URL:
|
1.
|
Click the add icon  above the Git Repository URL(s) field, and enter the URL in the text box that is displayed. The URL should be in one of these basic formats: |
|
•
|
http(s)://<host.xz>/<path>/to/repo.git |
|
•
|
<user>@<host>:<path>/repo.git |
Optionally, add a specific Git branch name, Git commit ID, Git tag name, or Git folder name to the end of the URL to specify a specific view of the repository. Use the appropriate delimiter to separate any of these elements from the main URL:
|
•
|
For a specific branch, prefix the branch name with “~~”. |
|
•
|
For a specific tag, prefix the tag name with “^^”. (A tag marks a specific point in time in the history of the repository, such a version release or a bug fix.) |
|
•
|
For a specific commit, prefix the commit ID with “>>”. |
|
•
|
For a specific folder, prefix the folder name with “**”. |
|
•
|
For a specific folder inside a subdirectory of a repository, prefix the “folderName/subfolderName” with “**”. |
|
•
|
For a specific folder in a specific branch, prefix the branch name with”~~” and then the folder name with “**”. |
|
•
|
For a specific folder in a specific tag, prefix the tag name with “^^” and then the folder name with “**”. |
|
•
|
For a specific folder in a specific commit, prefix the commit ID with “>>” and then the folder name with “**”. |
|
2.
|
(Optional) Repeat the previous step to add another URL. You can enter a maximum of 50 URLs. |
Examples
The following are example URLs that use the various formats described:
|
•
|
git@git.eng.flexera.com:org1/repo1.git |
|
•
|
git@git.engi.flexera.com:org1/repo2.git~~dev-branch |
|
•
|
git@git.eng.flexera.com:org1/repo3.git^^bug-fix-4 |
|
•
|
git@git.eng.flexera.com:org1/repo4.git>>Commit123 |
|
•
|
https://github.com/scaqaadmin/testgit_fnci.git^^v2018r1 |
|
•
|
https://github.com/scaqaadmin/testgit_fnci>>217b44c0eb2b47bb43e22772ef109711ee5cfb3a |
|
•
|
git@git.eng.flexera.com:org1/repo5.git**Folder1
|
|
•
|
git@git.eng.flexera.com:org1/repo5.git**Folder1/SubFolder1
|
|
•
|
git@git.eng.flexera.com:org1/repo6.git~~BranchB**Folder2
|
|
•
|
git@git.eng.flexera.com:org1/repo7.git^^v1.0.4**Folder3
|
|
•
|
git@git.eng.flexera.com:org1/repo8.git>>337b811c76f9dff572d53d9d42e1163aaadb9549**Folder4
|
|
•
|
git@git.eng.flexera.com:org1/repo9.git~~main**Folder4
|
Note:Consider the following information while specifying a URL in the Git Repository URL(s) field:
|
•
|
Since the three delimited elements—branch name, tag name, and commit ID are mutually exclusive, only one can be added to a given URL. |
|
•
|
When specifying a branch name, tag name, or commit ID along with a folder name in a URL, the branch name, tag name, or commit ID must be specified first, followed by the folder name. |
Editing a URL
Use this procedure to edit a URL in the Git Repository URL(s) field.
To edit a URL:
Click within the URL and edit it as needed within its text box.
Deleting a URL
Use this procedure to delete a URL from the Git Repository URL(s) field.
To delete an URL:
|
1.
|
Click within the URL to select it. |
|
2.
|
Click the remove icon  . |