极狐GitLab 私有化部署订阅

在您订阅极狐GitLab 后，您可以管理私有化部署订阅的详细信息。

获取私有化部署订阅#

要为极狐GitLab 私有化部署实例订阅：

1. 转到定价页面并选择一个私有化部署计划。您将被重定向到客户门户以完成购买。
2. 购买后，一个订阅许可证会发送到与客户门户账户关联的电子邮件地址。您必须将许可证导入到您的极狐GitLab 实例。

极狐GitLab 如何为用户计费#

极狐GitLab 私有化部署订阅使用混合模式。您根据订阅期间启用的最大用户数为订阅付费。

对于不离线或未在封闭网络上的实例，每季度检查一次极狐GitLab 私有化部署实例中同时在线的最大用户数。

如果一个实例无法生成季度使用报告，则使用现有的真实模型。如果没有季度使用报告，则无法进行按比例收费。

计费用户#

计费用户计入您订阅中购买的订阅席位数量。

当您在当前订阅期间阻止、停用或添加用户到您的实例时，计费用户的数量会发生变化。

用户在以下情况下不被计入计费用户：

• 他们被停用或阻止。
• 他们在待批准状态。
• 他们仅在极狐GitLab 私有化部署旗舰版订阅中具有最低访问角色。
• 他们仅在旗舰版订阅中具有访客角色。
• 他们在旗舰版订阅中没有项目或群组成员资格。
• 账户是极狐GitLab 创建的账户：
  • 幽灵用户。
  • 机器人用户，例如：
    • 支持机器人。
    • 项目的机器人用户。
    • 群组的机器人用户。
    • 其他内部用户。

计费用户的数量每天在管理员区域报告一次。

订阅中的用户#

订阅中的用户数量代表您当前许可证中包含的用户数量，这是基于您支付的费用。除非您购买更多席位，否则此数字在整个订阅期间保持不变。

最大用户数#

最大用户数反映了您系统上当前许可证期间的计费用户的最高数量。

超出订阅的用户#

极狐GitLab 订阅对于特定数量的席位有效。超出订阅的用户数量显示在当前订阅期间超出订阅允许的用户数量。

计算公式为 最大用户数 - 订阅中的用户。例如，您为 10 个用户购买了订阅。

超出订阅的用户 = 13 - 10 (最大用户数 - 订阅中的用户)

对于试用许可证，超出订阅的用户值始终为零。

如果超出订阅的用户值大于零，则表示您在极狐GitLab 实例中的用户超过了您获得许可证的用户数。您必须在续订前或续订时为额外的用户付费。这被称为 真实 过程。如果您不这样做，您的许可证密钥将不起作用。

要查看超出订阅的用户数量，请转到管理员区域。

免费访客用户#

在旗舰版层中，分配了访客角色的用户不消耗席位。用户不得在实例中被分配任何其他角色。

• 如果您的项目是私有或内部的，具有访客角色的用户拥有一组权限。
• 如果您的项目是公开的，所有用户，包括具有访客角色的用户，都可以访问您的项目。
• 用户的最高分配角色是异步更新的，可能需要一些时间来更新。

查看用户#

查看您实例中的用户列表：

1. 在左侧边栏底部，选择管理员。
2. 选择用户。

选择一个用户以查看其账户信息。

检查每日和历史计费用户#

先决条件：

• 您必须是管理员。

您可以在极狐GitLab 实例中获取每日和历史计费用户的列表：

1. 启动 Rails 控制台会话。

2. 统计实例中的用户数量：

   ruby
   User.billable.count

3. 获取过去一年的实例历史最大用户数量：

   ruby
   ::HistoricalData.max_historical_user_count(from: 1.year.ago.beginning_of_day, to: Time.current.end_of_day)

更新每日和历史计费用户#

先决条件：

• 您必须是管理员。

您可以在极狐GitLab 实例中手动触发每日和历史计费用户的更新。

1. 启动 Rails 控制台会话。

2. 强制更新每日计费用户：

   ruby
   identifier = Analytics::UsageTrends::Measurement.identifiers[:billable_users]
   ::Analytics::UsageTrends::CounterJobWorker.new.perform(identifier, User.minimum(:id), User.maximum(:id), Time.zone.now)

3. 强制更新历史最大计费用户：

   ruby
   ::HistoricalDataWorker.new.perform

管理用户和订阅席位#

管理用户数量与订阅席位数量可能很困难：

• 如果 LDAP 与极狐GitLab 集成，配置域中的任何人都可以注册极狐GitLab 账户。这可能导致续订时出现意外账单。
• 如果您的实例中启用了注册，则可以访问实例的任何人都可以注册账户。

极狐GitLab 提供了多个功能来帮助您管理用户数量。您可以：

• 要求管理员批准新注册。
• 自动阻止新用户，无论是通过 LDAP还是OmniAuth。
• 限制计费用户的数量，他们可以在没有管理员批准的情况下注册或添加到订阅中。
• 禁用新注册，而是手动管理新用户。
• 查看按角色分类的用户详细信息，在用户统计页面中。

向订阅中添加席位#

要增加许可证涵盖的用户数量，请在订阅期间向您的订阅中添加席位。订阅期间添加的席位的成本从购买日期按比例计算到订阅期结束。即使您达到许可证用户数量，您也可以继续添加用户。极狐GitLab 向您收取超额费用。

要向订阅中添加席位：

1. 登录到客户门户。
2. 转到订阅和购买页面。
3. 在相关订阅卡上选择添加席位。
4. 输入额外用户的数量。
5. 查看购买摘要部分，其中列出了系统上所有用户的总价以及您已支付的信用。您只需支付净变更费用。
6. 输入您的付款信息。
7. 选择购买席位。

如果您的订阅是通过激活码激活的，额外的席位会立即反映在您的实例中。如果您使用许可证文件，您将收到更新的文件。要添加席位，添加许可证文件到您的实例。

订阅数据同步#

先决条件：

• 极狐GitLab 企业版 (JH)。
• 连接到互联网，且不能有离线环境。
• 激活您的实例并使用激活码。

您的订阅数据每天在您的极狐GitLab 私有化部署实例和极狐GitLab 之间自动同步。

在大约凌晨 3:00（UTC）时，此每日同步作业会将订阅数据发送到客户门户。因此，更新和续订可能不会立即生效。

数据通过加密的 HTTPS 连接安全地发送到 customers.gitlab.com 的 443 端口。如果作业失败，它会在大约 17 小时内重试 12 次。

在您设置自动数据同步后，以下过程也会自动化。

• 季度订阅对账。
• 订阅续订。
• 订阅更新，例如添加更多席位或升级极狐GitLab 层级。

手动同步订阅数据#

您也可以随时手动同步订阅数据。

1. 在左侧边栏底部，选择管理员。
2. 选择订阅。
3. 在订阅详细信息部分，选择同步 (
   )。

然后会排队一个同步作业。当作业完成时，订阅详细信息会更新。

订阅数据#

每日同步作业会将以下信息发送到客户门户：

• 日期
• 时间戳
• 许可证密钥，其中加密了以下内容：
  • 公司名称
  • 许可证持有人姓名
  • 许可证持有人电子邮件
• 历史最大用户数
• 计费用户数量
• 极狐GitLab 版本
• 主机名
• 实例 ID

此外，我们还发送附加指标，例如：

• 附加类型
• 购买的席位
• 分配的席位

许可证同步请求示例：

json
1{
2  "gitlab_version": "14.1.0-pre",
3  "timestamp": "2021-06-14T12:00:09Z",
4  "date": "2021-06-14",
5  "license_key": "eyJkYXRhIjoiYlR2MFBPSEJPSnNOc1plbGtFRGZ6M
6  Ex1mWWhyM1Y3NWFOU0Zj\nak1xTmtLZHU1YzJJUWJzZzVxT3FQRU1PXG5
7  KRzErL2ZNd0JuKzBwZmQ3YnY4\nTkFrTDFsMFZyQi9NcG5DVEdkTXQyNT
8  R3NlR0ZEc0MjBoTTVna2VORlVcbjAz\nbUgrNGl5N0NuenRhZlljd096R
9  nUzd2JIWEZ3NzV2V2lqb3FuQ3RYZWppWVFU\neDdESkgwSUIybFJhZlxu
10  Y2k0Mzl3RWlKYjltMkJoUzExeGIwWjN3Uk90ZGp1\nNXNNT3dtL0Vtc3l
11  zWVowSHE3ekFILzBjZ2FXSXVQXG5ENWJwcHhOZzRlcFhr\neFg0K3d6Zk
12  w3cHRQTTJMTGdGb2Vwai90S0VJL0ZleXhxTEhvaUc2NzVIbHRp\nVlRcb
13  nYzY090bmhsdTMrc0VGZURJQ3VmcXFFUS9ISVBqUXRhL3ZTbW9SeUNh\n
14  SjdDTkU4YVJnQTlBMEF5OFBiZlxuT0VORWY5WENQVkREdUMvTTVCb25Re
15  ENv\nK0FrekFEWWJ6VGZLZ1dBRjgzUXhyelJWUVJGTTErWm9TeTQ4XG5V
16  aWdXV0d4\nQ2graGtoSXQ1eXdTaUFaQzBtZGd2aG1YMnl1KzltcU9WMUx
17  RWXE4a2VSOHVn\nV3BMN1VFNThcbnMvU3BtTk1JZk5YUHhOSmFlVHZqUz
18  lXdjlqMVZ6ODFQQnFx\nL1phaTd6MFBpdG5NREFOVnpPK3h4TE5CQ1xub
19  GtacHNRdUxTZmtWWEZVUnB3\nWTZtWGdhWE5GdXhURjFndWhyVDRlTE92
20  bTR3bW1ac0pCQnBkVWJIRGNyXG5z\nUjVsTWJxZEVUTXJNRXNDdUlWVlZ
21  CTnJZVTA2M2dHblc4eVNXZTc0enFUcW1V\nNDBrMUZpN3RTdzBaZjBcbm
22  16UGNYV0RoelpkVk02cWR1dTl0Q1VqU05tWWlU\nOXlwRGZFaEhXZWhjb
23  m50RzA5UWVjWEM5em52Y1BjU1xueFU0MDMvVml5R3du\nQXNMTHkyajN5
24  b3hhTkJUSWpWQ1BMUjdGeThRSEVnNGdBd0x6RkRHVWg1M0Qz\nMHFRXG5
25  5eWtXdHNHN3VBREdCNmhPODFJanNSZnEreDhyb2ZpVU5JVXo4NCtD\nem
26  Z1V1Q0K1l1VndPTngyc1l0TU5cbi9WTzlaaVdPMFhtMkZzM2g1NlVXcGI
27  y\nSUQzRnRlbW5vZHdLOWU4L0tiYWRESVRPQmgzQnIxbDNTS2tHN1xuQ3
28  hpc29D\nNGh4UW5mUmJFSmVoQkh6eHV1dkY5aG11SUsyVmVDQm1zTXZCY
29  nZQNGdDbHZL\ndUExWnBEREpDXG41eEhEclFUd3E1clRYS2VuTjhkd3BU
30  SnVLQXgvUjlQVGpy\ncHJLNEIzdGNMK0xIN2JKcmhDOTlabnAvLzZcblZ
31  HbXk5SzJSZERIcXp3U2c3\nQjFwSmFPcFBFUHhOUFJxOUtnY2hVR0xWMF
32  d0Rk9vPVxuIiwia2V5IjoiUURM\nNU5paUdoRlVwZzkwNC9lQWg5bFY0Q
33  3pkc2tSQjBDeXJUbG1ZNDE2eEpPUzdM\nVXkrYXRhTFdpb0lTXG5sTWlR
34  WEU3MVY4djFJaENnZHJGTzJsTUpHbUR5VHY0\ndWlSc1FobXZVWEhpL3h
35  vb1J4bW9XbzlxK2Z1OGFcblB6anp1TExhTEdUQVdJ\nUDA5Z28zY3JCcz
36  ZGOEVLV28xVzRGWWtUUVh2TzM0STlOSjVHR1RUeXkzVkRB\nc1xubUdRe
37  jA2eCtNNkFBM1VxTUJLZXRMUXRuNUN2R3l3T1VkbUx0eXZNQ3JX\nSWVQ
38  TElrZkJwZHhPOUN5Z1dCXG44UkpBdjRSQ1dkMlFhWVdKVmxUMllRTXc5\
39  nL29LL2hFNWRQZ1pLdWEyVVZNRWMwRkNlZzg5UFZrQS9mdDVcbmlETWlh
40  YUZz\nakRVTUl5SjZSQjlHT2ovZUdTRTU5NVBBMExKcFFiVzFvZz09XG4
41  iLCJpdiI6\nImRGSjl0YXlZWit2OGlzbGgyS2ZxYWc9PVxuIn0=\n",
42  "max_historical_user_count": 75,
43  "billable_users_count": 75,
44  "hostname": "gitlab.example.com",
45  "instance_id": "9367590b-82ad-48cb-9da7-938134c29088",
46  "add_on_metrics": [
47    {
48      "add_on_type": "duo_enterprise",
49      "purchased_seats": 100,
50      "assigned_seats": 50
51    }
52  ]
53}

查看您的订阅#

先决条件：

• 您必须是管理员。

您可以查看您的订阅状态：

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

订阅页面包含以下信息：

• 许可证持有人
• 计划
• 上传、开始和到期的时间
• 订阅中的用户数量
• 计费用户数量
• 最大用户数
• 超出订阅的用户数量

导出您的许可证使用情况#

先决条件：

• 您必须是管理员。

您可以将许可证使用情况导出到 CSV 文件中。

此文件包含极狐GitLab 用于手动处理季度对账或续订的信息。如果您的实例被防火墙保护或处于离线环境中，您必须将此信息提供给极狐GitLab。

1. 在左侧边栏底部，选择管理员。
2. 选择订阅。
3. 在右上角，选择导出许可证使用文件。

许可证使用文件内容#

许可证使用文件包括以下信息：

• 许可证密钥
• 许可证持有人电子邮件
• 许可证开始日期 (UTC)
• 许可证结束日期 (UTC)
• 公司
• 文件生成和导出的时间戳 (UTC)
• 在期间内每天的历史用户计数表：
  • 记录计数的时间戳 (UTC)
  • 计费用户计数

续订您的订阅#

您可以自动续订您的订阅或手动续订。

如果您想要以下任一选项，您应该手动续订您的订阅：

• 续订更少的席位。
• 增加或减少续订产品的数量。
• 移除不再需要的附加产品，以便续订订阅期限。
• 升级订阅层级。

在您的订阅续订日期之前，您应查看您的账户。

如果您需要帮助访问客户门户或更改管理您订阅的联系人，请联系支持团队。如果您需要帮助续订订阅，请联系销售团队。

查看您的账户#

您应该定期查看您的帐单账户设置和购买信息。

要查看您的账单账户设置：

1. 登录到客户门户。
2. 选择账单账户设置。
3. 验证或更新：
   • 在付款方式下，文件中的信用卡。
   • 在公司信息下，订阅和账单联系信息。
4. 保存任何更改。

您还应该定期查看您的用户账户，以确保您只为正确数量的活跃计费用户续订。非活跃用户账户：

• 可能计入计费用户。如果您为非活跃用户账户续订，您支付的费用可能比您应该的要多。
• 可能是安全风险。定期检查有助于降低这种风险。

有关更多信息，请参阅以下文档：

• 用户统计。
• 管理用户和订阅席位。

续订更少的席位#

如果您想以更少的席位续订，您可以执行以下任一操作：

• 手动续订您的订阅。
• 取消您的订阅并联系销售团队以指定您在未来的订阅中需要的席位数量。

自动订阅续订#

先决条件：

• 您必须启用了订阅数据同步。

在续订日期至少两天前，您应该查看您的账户，以便您的更改及时同步到极狐GitLab 进行续订。

当订阅设置为自动续订时，它会在到期日期的午夜 UTC 自动续订，而不会中断可用服务。通过客户门户购买的订阅默认设置为自动续订。

用户席位数量会在续订时根据实例中计费用户的数量进行调整，如果该数量高于当前订阅数量。

电子邮件通知#

在订阅自动续订前 15 天，会发送一封电子邮件，提供有关续订的信息。

• 如果您的信用卡已过期，电子邮件会告诉您如何更新。
• 如果您有任何未结算的超额费用或您的订阅无法自动续订的其他原因，电子邮件会告诉您联系销售团队或在客户门户中手动续订。
• 如果没有问题，电子邮件将指定：
  • 续订的产品名称和数量。
  • 您欠的总金额。如果您的使用在续订前增加，则此金额会更改。

启用或禁用自动订阅续订#

您可以使用客户门户启用或禁用自动订阅续订：

1. 登录到客户门户。您将被带到订阅和购买页面。
2. 检查订阅卡：
   • 如果卡片显示到期于 DATE，您的订阅未设置为自动续订。要启用自动续订，在订阅操作 (
     )中选择打开自动续订。
   • 如果卡片显示自动续订于 DATE，您的订阅设置为自动续订。要禁用自动续订：
     1. 在订阅操作 (
        )中选择取消订阅。
     2. 选择取消的原因。
     3. 可选：在**您想添加什么吗？**中，输入任何相关信息。
     4. 选择取消订阅。

存储#

极狐GitLab 私有化部署实例的存储和传输量没有应用限制。管理员负责底层基础设施成本，并可以设置存储库大小限制。