管理您的 InfluxDB 集群许可证

安装和管理您的 InfluxDB 集群许可证，以授权使用 InfluxDB 集群软件。

• 安装您的 InfluxDB 许可证
• 验证您的许可证
  • 验证数据库组件
  • 验证 Secret 是否存在
  • 查看许可证控制器日志
• 从许可证配置错误中恢复
• 续订您的许可证
• 许可证强制执行
  • 需要有效的许可证
  • 定期许可证检查
  • 许可证宽限期
    • 许可证到期日志
    • 查询减载

安装您的 InfluxDB 许可证

1. 如果您还没有，请 申请 InfluxDB 集群许可证。

2. InfluxData 为您提供了一个包含许可证令牌的自定义 Kubernetes 资源的 license.yml 文件。

3. 使用 kubectl 在您的 InfluxDB 命名空间中应用并创建 License 资源

   kubectl apply --filename license.yml --namespace influxdb
   

InfluxDB 集群检测 License 资源并将凭据提取到 InfluxDB 集群 Kubernetes Pod 所需的 Secret 中。Pods 在启动时以及在运行过程中（大约每小时一次）验证许可证 Secret。

验证您的许可证

激活您的许可证后，请使用以下信号来验证许可证是否处于活动状态且正常运行。

在您的命令中，替换以下内容

• NAMESPACE：您的 InfluxDB 命名空间
• POD_NAME：您的 InfluxDB Kubernetes 容器

验证数据库组件

安装您的许可证后，运行以下命令以检查数据库容器是否启动并处于 运行 状态

kubectl get pods -l app=iox --namespace influxdb

如果 容器 启动失败，运行以下命令以查看容器信息

kubectl describe pod 
POD_NAME
 --namespace influxdb

验证 Secret 存在

运行以下命令以验证许可证激活是否创建了一个 iox-license secret

kubectl get secret iox-license --namespace influxdb

如果 secret 不存在，查看 license-controller 日志 获取更多信息或错误。

查看 license controller 日志

license controller 组件会根据您的 License 创建一个名为 iox-license 的 Secret。为了故障排除而查看 license controller 日志，请运行以下命令

kubectl logs deployment/license-controller --namespace influxdb

从许可证配置错误中恢复

如果您部署了一个带有无效或已过期许可证的 InfluxDB Clustered 版本，您的集群中许多容器在启动时可能会崩溃，并可能进入 CrashLoopBackoff 状态而不会运行或变为健康状态。由于 InfluxDB 将许可证存储在挂载到卷的 Kubernetes secret 中，无效的许可证会影响旧容器和新容器。

在应用有效的 License 资源后，新容器将开始正常启动。

InfluxDB 在应用许可证时会验证许可证。如果尝试应用时许可证无效，则 license controller 不会添加或更新所需的 secret。

续订您的许可证

在许可证到期前，您的 InfluxData 销售代表将与您联系有关许可证续订事宜。您也可以随时联系您的销售代表。

许可证强制执行

InfluxDB Clustered 通过 InfluxData 发行的许可证授权使用 InfluxDB 软件。以下各节提供了有关 InfluxDB Clustered 许可证执行的信息。

需要有效的许可证

在您的 InfluxDB 集群中运行的所有 Kubernetes 容器必须具有有效的 License 资源才能运行。许可证由 InfluxData 发行。如果您的集群中没有安装 License 资源，则可能发生以下两种情况之一

• 如果集群从未安装过有效的 License 资源，容器可能会卡在 ContainerCreating 状态。
• 如果集群中安装了已过期或无效的许可证，容器将卡在 CrashLoopBackoff 状态。容器将尝试启动，检测到无效许可证条件，打印错误消息，然后以非零退出代码退出。

定期许可证检查

在正常操作期间，您的 InfluxDB 集群中的容器每小时会检查一次有效许可证。您可能会在容器日志中看到与此行为相关的消息。

许可证宽限期

InfluxData 发行的许可证配置了两个到期日期。第一个是合同许可证的到期日期。第二个是许可证凭证的强制到期日期，在此之后，您的集群中的容器将开始崩溃循环，直到在集群中安装新的有效许可证。

合同许可证到期日期和强制许可证到期日期之间的时间段被认为是 宽限期。标准宽限期为 90 天，但您可以与您的 InfluxData 销售代表协商以根据需要调整。

许可证到期日志

以下表格概述了许可证到期日志记录行为，以显示日志消息何时开始、日志级别（警告 或 错误）以及它们重复的周期。

查询减载

在您的合同许可证到期后的一个月开始，InfluxDB 查询器 开始对请求进行“减载”。减载将返回 FailedPrecondition 响应代码，针对每小时的一部分查询。

减载仅在使用合同到期后发生。此外，它们 仅影响查询操作 - 其他操作（写入、压缩、垃圾回收等）不受影响。