v1

GitHub integrates with Northflank through the GitHub app ecosystem.

When you connect your GitHub account you will be redirected to GitHub's login and application installation page.

Link your GitHub account

  1. Navigate to the Git integration page in your Northflank account settings
  2. Click Add GitHub
  3. Select the team or organisation you want to link
GitHub Installation
  1. Choose the repositories that you wish to build and deploy on Northflank, or grant access to all the repositories on the account
GitHub Authorisation

You will now be redirected back to Northflank and you should see your GitHub account name on the entry for GitHub. You can now begin building and deploying code from your GitHub repositories.

The GitHub app will automatically send Northflank webhooks for events on your repositories which means commits to your monitored branches and pull requests can be built instantly.

You can unlink GitHub from your Northflank account, which will stop Northflank from building any future commits to your repositories. To completely remove Northflank from your GitHub account you must uninstall the Northflank app from your GitHub settings.

Working on a team account

You can link your organisation's GitHub account or a personal GitHub account to your Northflank team. Anyone with permissions to create services or jobs will have access to select the organisation's GitHub repositories, as well as repositories linked from their personal accounts.

When removing GitHub from the team, you can either unlink or uninstall the Northflank app.

You can connect your GitLab account with Northflank via OAuth. When you connect your GitLab account you will be redirected to GitLab to complete the verification steps. All repositories your GitLab account has access to, including repositories that you do not own, are accessible with the connection.

Link your GitLab account

  1. Navigate to the Git integration page in your Northflank account settings
  2. Click Add GitLab
GitLab Authorization

You will now be redirected back to Northflank and you should see your GitLab account name on the entry for GitLab. If you are adding your GitLab to a team you will be prompted to select whether to restrict access to certain namespaces.

You can now begin building and deploying code from your GitLab repositories.

To completely remove Northflank from your GitLab account, go to GitLab settings - applications and revoke the Northflank application's access.

To remove GitLab from the team, you can either remove or uninstall the Northflank app.

You can connect your Bitbucket account with Northflank via OAuth. When you connect your Bitbucket account you will be redirected to Bitbucket to complete the verification steps. All repositories your Bitbucket account has access to, including repositories that you do not own, are accessible with the connection.

  1. Navigate to the Git integration page in your Northflank account settings
  2. Click Add Bitbucket
Bitbucket Authorization

You will now be redirected back to Northflank and you should see your Bitbucket account name on the entry for Bitbucket. If you are adding your Bitbucket to a team you will be prompted to select whether to restrict access to certain namespaces.

To completely remove Northflank from your Bitbucket account, go to Bitbucket settings - app authorizations and revoke the Northflank application's access.

On team accounts you may need to restrict access to certain namespaces on your linked Git accounts.

GitHub account restrictions are managed on GitHub by selecting which account/organisation to install the Northflank GitHub app on, and then granting access to specific repositories on that account.

Your linked GitLab and Bitbucket accounts can be restricted to certain namespaces by opening the settings on the respective entry. Select restricted and pick the contexts to allow your team members to access. Remove a namespace from the list to revoke access. The namespaces available to your team will be displayed on the git integrations page in the section for the relevant service.

New namespaces can be created in your Gitlab and Bitbucket accounts by creating new projects.

© 2021 Northflank Ltd. All rights reserved.