管理您的 InfluxDB Clustered 许可证

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

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

安装您的 InfluxDB 许可证

1. 如果您尚未这样做，请请求 InfluxDB Clustered 许可证。

2. InfluxData 为您提供一个 license.yml 文件，该文件将您的许可证令牌封装为自定义 Kubernetes 资源。

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

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

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

验证您的许可证

激活许可证后，使用以下信号来验证许可证是否已激活并正常运行。

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

• NAMESPACE: 您的 InfluxDB 命名空间
• POD_NAME: 您的 InfluxDB Kubernetes Pod

验证数据库组件

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

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

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

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 版本，则集群中的许多 Pod 将在启动时崩溃，并且很可能进入 CrashLoopBackoff 状态，而永远不会运行或变得健康。由于 InfluxDB 将许可证存储在卷挂载的 Kubernetes Secret 中，因此无效的许可证会影响新旧 Pod。

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

InfluxDB 在您应用许可证时对其进行验证。如果您尝试应用许可证时许可证无效，则 license controller 将不会添加或更新所需的 Secret。

续订您的许可证

在您的许可证到期之前，您的 InfluxData 销售代表将与您联系以进行许可证续订。您也可以随时联系您的销售代表。

许可证强制执行

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

需要有效的许可证

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

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

定期许可证检查

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

许可证宽限期

当 InfluxData 颁发许可证时，它配置了两个到期日期。第一个是合同许可证的到期日期。第二个是许可证凭据的硬到期日期，在此之后，集群中的 Pod 将开始崩溃循环，直到安装新的有效许可证。

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

许可证到期日志

下表概述了许可证到期日志记录行为，以显示日志消息何时开始、级别（Warn 或 Error）以及重复周期。

查询 Brownout

从您的合同许可证到期后一个月开始，InfluxDB Querier 开始“Brownout”请求。Brownout 每小时向查询返回一部分 FailedPrecondition 响应代码。

Brownout 仅在许可证合同到期后才会发生。此外，它们仅影响查询操作——没有其他操作（写入、压缩、垃圾回收等）受到影响。