• 在管理员区域中添加许可证
• 在安装过程中添加您的许可证文件
• 许可证到期时会发生什么
• 删除许可证
• 查看许可证详情和历史
• Rails 控制台中的许可证命令
  • 查看当前许可证信息
    • 与未来开始的许可证交互
  • 检查项目功能是否在实例上可用
    • 检查项目功能是否在项目上可用
  • 通过控制台添加许可证
    • 使用 key 变量
    • 使用许可证文件
  • 删除许可证
• 故障排查
  • 管理中心没有许可证选项
  • 续订时用户数超过许可证限制
  • 添加许可证后仍显示 Start GitLab Ultimate trial

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

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

首次登录极狐GitLab 实例时，应显示带有 添加许可证 页面链接的注释。

否则，要添加您的许可证。

在管理员区域中添加许可证

1. 以管理员身份登录极狐GitLab。
2. 在左侧导航栏，底部，选择 管理员。
3. 选择 设置 > 通用。
4. 在 添加许可证 区域，通过上传文件或输入密钥来添加许可证。
5. 选择 服务条款 复选框。
6. 选择 添加许可证。

在安装过程中添加您的许可证文件

您可以在安装极狐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"
    

许可证到期时会发生什么

Fifteen days before the license expires, a notification banner with the upcoming expiration date displays to GitLab administrators.

Licenses expire at the start of the expiration date, 00:00 server time.

When your license expires, GitLab locks features, like Git pushes and issue creation. Your instance becomes read-only and an expiration message displays to all administrators. You have a 14-day grace period before this occurs.

For example, if a license has a start date of January 1, 2024 and an end date of January 1, 2025:

• It expires at 11:59:59 PM server time December 31, 2024.
• It is considered expired from 12:00:00 AM server time January 1, 2025.
• The grace period of 14 days starts at 12:00:00 AM server time January 1, 2025 and ends at 11:59:59 PM server time January 14, 2025.
• Your instance becomes read-only at 12:00:00 AM server time January 15, 2025.

To resume functionality, renew your subscription.

If the license has been expired for more than 30 days, you must purchase a new subscription to resume functionality.

To go back to Free features, delete all expired licenses.

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

许可证在过期日期开始后过期，也就是服务器上的 00:00。

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

比如，如果许可证的开始日期为 2024 年 1 月 1 日，结束日期为 2025 年 1 月 1 日：

• 许可证会在 2024 年 12 月 31 日 23:59:59 过期。
• 从 2025 年 1 月 1 日，服务器时间 12:00:00 开始过期。
• 宽限期从 2025 年 1 月 1 日，服务器时间 12:00:00 开始，到 2025 年 1 月 14 日，服务器时间 23:59:59 结束。
• 您的实例在 2025 年 1 月 15 日，服务器时间 12:00:00 变为只读。

如果许可证已过期 30 天以上，您必须购买新订阅才能恢复功能。

要返回基础版功能，请删除所有过期的许可证。

删除许可证

要从私有化部署实例中删除许可证文件：

1. 在导航栏左侧，底部，选择 管理员。
2. 选择 订阅。
3. 选择 删除许可证。

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

查看许可证详情和历史

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

1. 在导航栏左侧，底部，选择 管理员。
2. 选择 订阅。

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

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

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

Rails 控制台中的许可证命令

以下命令可以在 rails 控制台中运行。

查看当前许可证信息

# License information (name, company, email address)
License.current.licensee

# Plan:
License.current.plan

# Uploaded:
License.current.created_at

# Started:
License.current.starts_at

# Expires at:
License.current.expires_at

# Is this a trial license?
License.current.trial?

# License ID for lookup on CustomersDot
License.current.license_id

# License data in Base64-encoded ASCII format
License.current.data

与未来开始的许可证交互

# Future license data follows the same format as current license data it just uses a different modifier for the License prefix
License.future_dated

检查项目功能是否在实例上可用

https://jihulab.com/gitlab-cn/gitlab/-/blob/master/ee/app/models/license.rb 中列出的功能。

License.current.feature_available?(:jira_dev_panel_integration)

检查项目功能是否在项目上可用

license.rb 中列出的功能。

p = Project.find_by_full_path('<group>/<project>')
p.feature_available?(:jira_dev_panel_integration)

通过控制台添加许可证

使用 key 变量

key = "<key>"
license = License.new(data: key)
license.save
License.current # check to make sure it applied

使用许可证文件

license_file = File.open("/tmp/Gitlab.license")

key = license_file.read.gsub("\r\n", "\n").gsub(/\n+$/, '') + "\n"

license = License.new(data: key)
license.save
License.current # check to make sure it applied

这些代码片段可以保存到文件中并使用 Rails Runner 执行，以便可以通过 shell 自动化脚本应用许可证。

在许可证过期和多个 LDAP 服务器等已知边缘情况下需要这样做。

删除许可证

清理许可证历史表：

TYPE = :trial?
# or :expired?

License.select(&TYPE).each(&:destroy!)

# or even License.all.each(&:destroy!)

故障排查

管理中心没有许可证选项

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

• 如果您原先安装的是社区版（Community Edition）而不是极狐GitLab，您必须在上传许可证前升级到极狐GitLab。
• 如果您使用的是 SaaS 版，您无法上传一个私有化部署版的许可证。

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

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

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

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

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

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

添加许可证后仍显示 Start GitLab Ultimate trial

要解决此问题，请重新启动 Puma 或您的整个极狐GitLab 实例。

##