Set Up Your Git Integration
You’ll set up your Get integration when creating a new project.
Get an Authentication Token
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). Coalesce requires a PAT.
- GitHub Token Generation Instructions
- Bitbucket Token Generation Instructions
- GitLab Token Generation Instructions
- Azure DevOps Token Generation
Git Fields
You’ll need the following information ready to connect your account.
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] |
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.
Create a New Project
- Make sure you are on the Projects page. If you are on the Build page , select the back arrow.
- Click the plus sign (+) next to Projects.
- Fill out the Project Details.
- Enter your Git repo URL.
- Coalesce supports many providers .
- Then select a Git account to use. It should be able to view and make requests to the Git repo in the previous step.
- If you don't a Git repo configured, then select Add New Account.
- Enter an account nickname. This will displayed in the interface.
- Enter the Git username and token.
- Enter the Author Name, which identifies the committer.
- Enter the Author Email, which identifies the committer email.
- Click Add.
- Select the Git account you just created in the drop down, then click Test Account.
- Once successful, click Finish.
- Now that you've added a Project, you need to add a Workspace .
Add Git to an Existing Project
There are two places you can add Git to an existing project, either through the Problem Scanner or the Project Dashboard.
Add Git Using the Problem Scanner
Go to 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.
Add Through the Project Dashboard
Next to Create Workspace, select the ellipses and Configure Git Account.
Add a Git Account
In the Coalesce App, go to User Menu > User Settings > Git Accounts. Click Add. Fill in the account information.
Updated 21 days ago