Activate GitLab EE with a license

原文:https://docs.gitlab.com/ee/user/admin_area/license.html

Activate GitLab EE with a license

要激活所有 GitLab 企业版(EE)功能,您需要上传许可证. 从 GitLab Inc.获得许可证后,您可以通过以管理员身份登录到 GitLab 实例或在安装时添加许可证来上载许可证.

许可证的形式为 base64 编码的 ASCII 文本,扩展名为.gitlab-license ,可以在购买 .gitlab-license或注册免费试用时获得 .

注意:从 GitLab Enterprise Edition 9.4.0 开始,没有上载许可证的新安装实例将仅具有核心功能. 试用许可证将激活所有 Ultimate 功能,但是试用期满后 ,某些功能将被锁定.

Uploading your license

首次访问以 admin 身份登录的 GitLab EE 安装时,您会看到一条注释,敦促您上传许可证,并带有一个链接,该链接可直接转到Admin Area> License .

否则,您可以:

  1. 通过单击菜单栏中的扳手图标,手动导航到管理区域 .

    Admin Area icon

  2. 然后转到” 许可证”选项卡,然后单击”上载新许可证” .

    License Admin Area

  3. 如果您收到.gitlab-license文件,则应该已经将其下载到本地计算机中. 然后,您可以通过选择许可证文件并单击”上载许可证”按钮直接上载它. 在下图中,您可以看到所选的许可证文件名为GitLab.gitlab-license .

    Upload license

    如果您以纯文本格式收到许可证,则需要选择”输入许可证密钥”选项,复制许可证,将其粘贴到”许可证密钥”字段中,然后点击上传许可证 .

Add your license at install time

通过将名为Gitlab.gitlab-license的文件放置在/etc/gitlab/对于 Omnibus)或config/对于源代码安装,可以在安装时自动导入Gitlab.gitlab-license .

还可以为许可证指定自定义位置和文件名.

源代码安装应使用有效的 GitLab Enterprise Edition 许可证的路径设置GITLAB_LICENSE_FILE环境变量.

  1. export GITLAB_LICENSE_FILE="/path/to/license/file"

Omnibus 安装应将此条目添加到gitlab.rb

  1. gitlab_rails['initial_license_file'] = "/path/to/license/file"

警告:这些方法只会在安装时添加许可证. 使用 Web 用户界面中的”管理区域”来续订或升级许可证.


许可证上载后,所有 GitLab 企业版功能都将处于激活状态,直到许可证期结束. 该时间段结束后,该实例将恢复为仅 Core 功能.

您可以随时在”管理区域”的”许可证”部分中查看许可证详细信息.

License details

Notification before the license expires

许可证到期前一个月,GitLab 管理员将开始看到一条消息,通知到期时间. 确保您更新了许可证,否则,如果许可证过期,您将错过所有付费功能.

What happens when your license expires

万一您的许可证过期,GitLab 将锁定某些功能,如 Git 推送,问题创建等,并且将向所有管理员显示一条消息,告知已过期的许可证.

为了恢复所有以前的功能,必须上载新的许可证. 要退回到仅激活核心功能,您需要删除过期的许可证.

License history

可以上传和查看多个许可证,但是只有最新的许可证将用作活动许可证.

Troubleshooting

There is no License tab in the Admin Area

如果您最初安装的是 Community Edition,而不是 Enterprise Edition,则需要在升级许可证之前升级到 Enterprise Edition .

GitLab.com 用户无法上传和使用自我管理的许可证. 如果您希望在 GitLab.com 上使用付费功能,则可以购买单独的订阅.

Users exceed license limit upon renewal

如果您在续订之前将新用户添加到您的 GitLab 实例中,则可能需要购买额外的席位来覆盖这些用户. 如果是这种情况,并且上传了没有足够用户的许可证,则会显示一条消息,提示您购买其他用户. 有关如何确定所需用户数以及如何增加其他席位的更多信息,请参见许可常见问题解答 .