Help us learn about your current experience with the documentation. Take the survey.
GitHub
- Tier: Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
您可以使用来自 GitLab 的流水线状态更新来更新 GitHub。 如果您使用 GitLab 进行 CI/CD,GitHub 集成可以帮助您。
此项目集成与实例范围的 GitHub 集成是分开的, 当您导入GitHub 项目时会自动配置。
配置集成
此集成需要一个授予了 repo:status 访问权限的 GitHub API token。
在 GitHub 上完成以下步骤:
- 前往您的 Personal access tokens 页面:https://github.com/settings/tokens。
- 选择 Generate new token。
- 在 Note 下,为新输入令牌名称。
- 确保
repo:status已选中,然后选择 Generate token。 - 复制生成的令牌以在 GitLab 中使用。
在 GitLab 中完成以下步骤:
- 在左侧边栏,选择 Search or go to 并找到您的项目。
- 选择 Settings > Integrations。
- 选择 GitHub。
- 确保 Active 复选框已选中。
- 在 Token 中,粘贴您在 GitHub 上生成的令牌。
- 在 Repository URL 中,输入您在 GitHub 上的项目路径,例如
https://github.com/username/repository。 - 可选。要禁用静态状态检查名称,请清除 Enable static status check names 复选框。
- 可选。选择 Test settings。
- 选择 Save changes。
配置集成后,请参阅外部拉取请求的流水线 来配置为打开的拉取请求运行流水线。
静态或动态状态检查名称
状态检查名称可以是静态或动态的:
-
静态:您的 GitLab 实例的主机名会附加到状态检查名称中。
-
动态:分支名称会附加到状态检查名称中。
Enable static status check names 选项使您能够在 GitHub 中配置必需的状态检查, 这些检查需要一致的(静态)名称才能正常工作。
如果您禁用此选项, GitLab 会使用动态状态检查名称。