GitHub project integration
Introduced in GitLab Premium 10.6.
GitLab provides an integration for updating the pipeline statuses on GitHub. This is especially useful if using GitLab for CI/CD only.
This project integration is separate from the instance wide GitHub integration and is automatically configured on GitHub import.
Configuration
Complete these steps on GitHub
This integration requires a GitHub API token
with repo:status
access granted:
- Go to your “Personal access tokens” page at https://github.com/settings/tokens
- Click “Generate New Token”
- Ensure that
repo:status
is checked and click “Generate token” - Copy the generated token to use on GitLab
Complete these steps on GitLab
- Navigate to the project you want to configure.
- Navigate to the Integrations page
- Click “GitHub”.
- Ensure that the Active toggle is enabled.
- Paste the token you’ve generated on GitHub
- Enter the path to your project on GitHub, such as
https://github.com/username/repository
- Optionally uncheck Static status check names checkbox to disable static status check names.
- Save or optionally click “Test Settings”.
Once the integration is configured, see Pipelines for external pull requests to configure pipelines to run for open pull requests.
Static / dynamic status check names
- Introduced in GitLab 11.5: using static status check names as opt-in option.
- In GitLab 12.4, static status check names is default behavior for new projects.
This makes it possible to mark these status checks as Required on GitHub. With Static status check names enabled on the integration page, your GitLab instance host name is going to be appended to a status check name, whereas in case of dynamic status check names, a branch name is going to be appended.
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc