管理您的InfluxDB集群许可证

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

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

安装你的 InfluxDB 许可证

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

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

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

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

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

验证您的许可证

在您激活许可证后，使用以下信号来验证许可证是否处于活动状态并正常工作。

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

• NAMESPACE: 你的 InfluxDB 命名空间
• POD_NAME: 你的 InfluxDB Kubernetes pod

验证数据库组件

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

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

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

kubectl describe pod 
POD_NAME
 --namespace influxdb

验证 Secret 是否存在

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

kubectl get secret iox-license --namespace influxdb

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

查看 license controller 日志

许可控制器组件从您的 License 创建一个名为 iox-license 的 Secret。要查看 license controller 日志以进行故障排除，请运行以下命令：

kubectl logs deployment/license-controller --namespace influxdb

从许可证错误配置中恢复

如果您使用无效或过期的许可证部署了授权版本的 InfluxDB Clustered，您的集群中的许多 pods 在启动时将崩溃，并且很可能会进入一个 CrashLoopBackoff 状态，而不会运行或变得健康。由于 InfluxDB 将许可证存储在一个卷挂载的 Kubernetes 秘密中，无效许可证会影响旧的和新的 pods。

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

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

续订您的许可证

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

许可证强制执行

InfluxDB 集群通过 InfluxData 发行的许可证授权使用 InfluxDB 软件。以下部分提供有关 InfluxDB 集群许可证执行的信息。

需要有效的许可证

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

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

周期性许可证检查

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

许可宽限期

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

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

许可证到期日志

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

查询停电

在您的合同许可到期后一个月开始，InfluxDB Querier 开始“降级”请求。降级会在每小时的部分时间返回 FailedPrecondition 响应代码给查询。

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