Git Settings
Coalesce makes it simple to connect to your preferred git-based version control system.
This page contains general reference information about setting up a git integration, though for users new to git or curious about best practices, this hands-on tutorial may be helpful.
Supported Git Providers
Please note that while we may not test all Git providers, most will likely work with Coalesce if:
- Git repository must be available to Coalesce via the public internet.
- Authentication to Git is available via a Personal Access Token.
Generate an Authentication Token
To enhance security, many cloud git providers have transitioned from traditional username and password authentication for remote repository access to a more secure method known as token authentication or Personal Access Tokens (PAT).
- GitHub Token Generation Instructions
- Bitbucket Token Generation Instructions
- GitLab Token Generation Instructions
- Azure DevOps Token Generation
Adding a Git Account
Navigate to User Menu → User Settings → Git Accounts and click the Add button in the top right.
Adding a New git Account
Fill in required fields as follows:
| Field | Description | Example |
|---|---|---|
| Account Nickname | Friendly description of this git account | GitHub |
| Git Username | Your git username/account name | jack-bauer |
| Token | The git user's authorization token | ghp_abcdefghijklmnopqrstuvwxyz0123456789 |
| Author Name | Name of the git user | Jack Bauer |
| Author Email | The git user's email | [email protected] |
Click Add once finished and the new git account will be available for Projects to use.
Adding Git to a Project
To add git functionality to a Project, the simplest way is to enter your Development Workspace, click on the relevant Problem Scanner entry, then follow on-screen prompts to edit URL and select the desired git account for that Workspace's Project.
Alternatively, one can go to the Projects Dashboard → Project Settings → Git Repository then enter the git repository URL and click Save. Then click the ellipsis next to the Workspace → Configure Git Account and choose the desired git account. You can Test Account to confirm the connection works, and click Finish once done. Upon entering the Workspace, the repository will be automatically cloned.
Adding Git to a Project
Limitations and Considerations
- Git repository must be available to Coalesce via the public internet.
- Authentication to Git is available via a Personal Access Token.
Git Username in Repo URL
By default, some git providers include a git username in the repo URL. Example
https://[email protected]/customer_projects/my-edw.git.While URLs like this are currently allowed, any authentication information in them is ignored since git URLs can be shared across multiple Coalesce users.
Coalesce will instead use the value of Git Account when authenticating.
Updated 8 days ago