使用许可证激活极狐GitLab

要启用极狐GitLab 的功能，您需要激活您的实例。激活前，应首先确认运行的版本类型是极狐GitLab。确认版本时，登录 GitLab，并在浏览地址后添加 /help，版本类型（edition）和版本号（version）列在 Help 页面。

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

对于全新安装的极狐GitLab 实例，在未上传许可证的情况下，只激活免费特性。试用许可证可以激活专业版，但在试用到期后，一些功能会被锁定。

使用激活码激活极狐GitLab

从 14.0 开始，您需要一个激活码来激活您的实例。您可以通过购买许可证或注册免费试用来获取激活码。此激活码是您在确认电子邮件中收到的 24 个字符的字母数字字符串。

要使用您的激活码开始激活过程：

如果您收到许可证文件（例如新试用版），您可以通过以管理员身份登录到您的 GitLab 实例或在安装过程中添加它来上传它。许可证是一个 base64 编码的 ASCII 文本文件，扩展名为“.gitlab-license”。

使用管理员账户首次登录访问极狐GitLab 时，您将看到提示上传许可证的信息，点击链接可跳转至许可证区域进行操作。

除此之外，您还可以手动跳转至许可证区域：

许可证可以在安装过程中自动导入，需要将许可证文件命名为 Gitlab.gitlab-license，通过 Omnibus GitLab 安装时放置在 /etc/gitlab/ 路径下，通过源安装时放置在 config/ 路径下。

您也可以为许可证指定自定义的位置和文件名称：

通过源安装时，应当设置 GITLAB_LICENSE_FILE 环境变量，值为有效的极狐GitLab 许可证的路径。
```
export GITLAB_LICENSE_FILE="/path/to/license/file"
```

通过 Omnibus GitLab 安装时，应当向 gitlab.rb 添加以下内容。
```
gitlab_rails['initial_license_file'] = "/path/to/license/file"
```

这些方法只适用于在安装过程中添加一个许可证。在 web 用户界面中使用 管理中心 方可续订或更新许可证。

上传许可证后，所有极狐GitLab 功能将被激活，直到许可证的有效期结束。当有效期结束时，实例将回退到只提供免费功能。

您可以在任何时候访问 管理中心 > 订阅，查看许可证的详细信息。

在许可证到期前一个月，系统将向管理员展示关于到期日的一条信息。确保更新您的许可证，否则在许可证到期时，您将不能使用所有的付费特性。

当您的许可证到期时，系统将锁定例如 Git 推送和 issue 创建等功能，之后，您的实例变为只读，并向所有管理员展示一条到期信息。

对于自助管理实例，您有 14 天宽限期避免以上情况发生。

从自助管理实例中删除许可证文件的操作如下：

可能需要重复这些步骤以完全删除所有许可证，包括过去应用的许可证。

您可以上传、查看多个许可证，但只有当前日期范围内的最新许可证，可以用作有效的许可证。

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

您可以在 订阅历史 表中查看所有激活订阅。

如果您原先安装的是社区版（Community Edition）而不是极狐GitLab，您必须在上传许可证前升级到极狐GitLab。

如果您在续期前为您的许可证实例添加了新的用户，您可能需要为这些用户购买额外的配额。在此情况下，当上传了一个不能满足用户数量的许可证时，系统将显示一条信息，提醒您购买额外的用户数配额。

在 14.2 及更高版本中，对于使用许可证文件的实例，您可以超过购买的用户数量并仍然激活您的许可证。

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

在 14.0 及更高版本中，要激活您的订阅，您的极狐GitLab 实例必须连接到 Internet。

如果您有离线环境，则可以上传许可证文件代替。

如果您在激活实例时有任何疑问或需要帮助，请联系技术支持。