How do I set up my GitHub integration?

Follow the steps below to connect Adoptech to GitHub

What do I need to get started?

You will need access to the account that is the 'Owner of your Organisation' in GitHub.

What do I need to configure in GitHub?

1. A custom property to identify the production branch
   1. In GitHub Organisation settings go to Repository → Custom property
   2. The property name must be "production_branch_name". The default value can be anything. Note: you can override this on a per-repository basis.
2. Review each repository and set the correct value. This should be the name of the branch from which the code is coming into production. For example “main” or “production” (ask your DevOps or Dev Team if unsure).

3. Ensure Production branches have protection in place, with a mandatory code review requirement before merging.

What do I need to configure on the Adoptech side?

All GitHub users with access to the company's repositories (including outside collaborators) should be set up in the People table on Adoptech.

A GitHub user's public email does not always match the corporate email used in Adoptech and so the user's GitHub identifier (login name) is required.
You can find the ID in the URL of the user's GitHub page, or by clicking on the user's avatar.

Enter their GitHub ID under External accounts.