激活极狐GitLab

当您在没有许可证的情况下安装新的极狐GitLab 实例时,只启用标准版功能。要启用极狐GitLab 的所有功能,请使用激活码或许可证文件激活您的实例。当许可证过期时,某些功能被锁定。

验证您的极狐GitLab 版本

要激活您的实例,请确保您正在运行极狐GitLab。

要验证版本,请登录极狐GitLab 并选择 帮助 () > 帮助。极狐GitLab 版本和级别列在页面顶部。

如果您正在运行 GitLab 社区版(CE,Community Edition),可以升级到极狐GitLab。在升级过程中出现问题或需要协助时,请您联系技术支持

使用许可证文件激活极狐GitLab

如果您从极狐GitLab 收到许可证文件(例如,试用版),您可以将其上传到您的实例或在安装期间添加。许可证文件是一个 base64 编码的 ASCII 文本文件,扩展名为 .gitlab-license

上传您的许可证

首次登录极狐GitLab 实例时,应显示带有 上传许可证 页面链接的提示。

否则,要上传您的许可证:

  1. 以管理员身份登录极狐GitLab。
  2. 在顶部栏上,选择 菜单 > 管理员
  3. 在左侧边栏,选择 设置
  4. 许可证文件 区域,选择 上传许可证
  5. 上传许可证:
    • 对于文件,您可以选择 上传 .gitlab-license 文件选择文件,然后从本地计算机中选择许可证文件。或者将许可文件拖放到 Drag your license file here 区域。
    • 对于纯文本,选择 请输入许可证密钥 并将内容粘贴到 许可证密钥 中。
  6. 选择 服务条款 复选框。
  7. 选择 上传许可证

安装过程中添加许可证

您可以在安装极狐GitLab 时导入许可证文件。

  • 源安装实例
    • Gitlab.gitlab-license 文件放在 config/ 目录下。
    • 要为许可证指定自定义位置和文件名,请使用文件路径设置 GITLAB_LICENSE_FILE 环境变量:

      export GITLAB_LICENSE_FILE="/path/to/license/file"
      
  • Omnibus 安装实例
    • Gitlab.gitlab-license 文件放在 /etc/gitlab/ 目录下。
    • 要为许可证指定自定义位置和文件名,请将此条目添加到 gitlab.rb

      gitlab_rails['initial_license_file'] = "/path/to/license/file"
      
caution以上方法仅在安装时添加许可证。要续订或升级许可证,请在 Web 用户界面的 管理中心 中上传许可证。

许可证到期时会发生什么

在许可证到期前 15 天,系统会显示一个带有即将到期日期的通知给管理员。

当您的许可证到期时,系统会锁定功能,例如 Git 推送和议题创建。您的实例变为只读,并且所有管理员都会看到一条过期消息。在此之前,您有 14 天的宽限期。

要恢复功能,请上传新许可证

要返回标准版功能,请删除所有过期的许可证

删除许可证文件

要从自助管理实例中删除许可证文件:

  1. 在顶部栏上,选择 菜单 > 管理员
  2. 在左侧边栏中,选择 订阅
  3. 选择 删除许可证

重复这些步骤删除所有许可证,包括过去应用的许可证。

查看许可证详情和历史

要查看您的许可证详细信息:

  1. 在顶部栏上,选择 菜单 > 管理员
  2. 在左侧边栏中,选择 订阅

您可以上传和查看多个许可证,但只有当前日期范围内的最新许可证是有效许可证。

当您上传未来日期的许可证时,在其适用日期之前不会生效。 您可以在 订阅历史 表中查看所有有效订阅。

您还可以将您的许可证使用信息导出到 CSV 文件。

note在 13.6 及更早版本中,当您上传新许可证时,可能会继续显示有关过期许可证的通知。当新许可证的开始日期在未来并且即将到期的许可证仍然有效时,就会发生这种情况。 新许可证激活后通知消失。

故障排查

管理中心没有许可证选项

您无法上传您的许可证,因为没有 订阅 区域。 在以下情况下可能会出现此问题:

  • 如果您原先安装的是社区版(Community Edition)而不是极狐GitLab,您必须在上传许可证前升级到极狐GitLab。
  • 如果您使用的是 SaaS 版,您无法上传一个自助管理许可证。

续订时用户数超过许可证限制

极狐GitLab 会显示一条消息,提示您购买更多用户。如果您上传的许可证没有足够的用户来覆盖您实例中的用户数量,则会出现此问题。

要解决此问题,请购买额外的席位覆盖这些用户。

在 14.2 及更高版本中,对于使用许可证文件的实例,以下规则适用:

  • 如果超过许可的用户少于或等于许可文件中用户的 10%,则应用许可并在下次续订时支付超额。
  • 如果超过许可的用户超过许可文件中用户的 10%,则在不购买更多用户的情况下无法申请许可。

例如,如果您为 100 个用户购买了一个许可证,那么当您激活您的许可证时,您可以拥有 110 个用户。但是,如果您有 111 个用户,则必须购买更多用户才能激活许可证。