If you aren't yet familiar with Git Version Control, check our prerequisite article before diving into learning about working with Git and Coalesce.
Are you ready to dive in to working with Git and Coalesce? Here's how to begin integrating Git with your Coalesce projects:
- Administrative Item: Create and provision access to your Git repository(ies) for Coalesce. This task will need to be completed by a Git administrator in your organization. Each Project in Coalesce should have its own repository, and the repository should not be shared with any work effort / project outside of Coalesce.
- Administrative Item: Allow network connectivity between Coalesce and your Git provider / repository(ies). If your organization uses network policies to limit traffic to / from your Git provider and/or specific repositories on your Git provider, a Git administrator in your organization will need to modify your network policies to allow connectivity between Coalesce and your Git provider / repositor(ies). The list of IPs that need to be allowed can be found, designated by Coalesce deployment, in the Coalesce documentation. Unsure of your deployment? This is designated by the base URL you use to login to the Coalesce application. If you still need assistance identifying your deployment, contact Coalesce Support.
- Administrative Item: Point each Coalesce Project to the Git repository created for it. Each Coalesce Project must have a Git repository configured in order to facilitate full Project functionality (ie: more than one Workspace, multi-user development, etc). The Project repository is designated in the Project settings.
- Generate your Git personal access token (PAT) for use by Coalesce. Connectivity between Coalesce and Git is authenticated via a username and associated authentication token, otherwise known as a personal access token (PAT), rather than via a username and password combo. Each individual developer needs to generate and use an individual access token associated with their individual account. More information on access tokens and generating them in each of the supported Git providers can be found in the Coalesce documentation.
- Configure your Git Account(s) in your User Settings in the Coalesce user interface (UI). For each Git Provider and/or fine-grained access token you wish to use with Coalesce, you will need to configure a Git account in your User Menu in the Coalesce UI.
- Associate your Git Account(s) to the Project(s) you work with in Coalesce. When you begin working with a Project in Coalesce, you will be prompted to designate which of your configured Git Accounts should be associated with the Project. Select the account associated with the access token (generated in Step 3) that provides you with write access to the Git repository that has been provisioned for the Project.