SeleniumHQ/docker-selenium 中配置OTLP端点至Node主机Daemonset的技术方案

背景介绍

在现代Kubernetes环境中，将Selenium网格与可观测性工具集成是一个常见需求。SeleniumHQ/docker-selenium项目支持通过OpenTelemetry协议(OTLP)导出遥测数据，但在Kubernetes环境中，当OTLP收集器以Daemonset形式部署在节点上时，配置端点地址会遇到一些挑战。

核心问题

在Kubernetes集群中，当OTLP收集器作为Daemonset部署时，每个节点都会运行一个收集器实例。理想情况下，Selenium容器应该将遥测数据发送到同一节点上的收集器实例。然而，默认情况下，Pod无法直接获取节点IP地址来构建OTLP端点URL。

技术解决方案

环境变量注入方案

Kubernetes提供了通过Downward API将节点信息注入Pod环境变量的能力。具体实现方式如下：

1. 注入节点IP：通过Pod规范中的环境变量定义，将节点IP注入到容器中

env:
- name: KUBERNETES_NODE_HOST_IP
  valueFrom:
    fieldRef:
      fieldPath: status.hostIP

2. 构建OTLP端点：使用注入的节点IP构建OTLP端点地址

- name: SE_OTEL_EXPORTER_ENDPOINT
  value: "http://$(KUBERNETES_NODE_HOST_IP):4317"

Helm配置实现

对于使用Helm部署的场景，可以通过extraEnvironmentVariables配置项统一为所有组件注入这些环境变量。这种方式确保了Selenium Hub和所有节点都能正确地将遥测数据发送到同一节点上的收集器。

技术细节

1. 环境变量解析：Kubernetes支持在环境变量值中引用其他环境变量，格式为$(VAR_NAME)。这种引用方式会在容器启动时被解析。

2. 组件一致性：在Selenium网格中，需要确保Hub和所有Node都使用相同的配置方式，以保证整个网格的遥测数据收集行为一致。

3. 端口配置：默认OTLP gRPC端口为4317，HTTP端口为4318，需要根据收集器的实际配置进行调整。

实施建议

1. 全面测试：在部署到生产环境前，应验证环境变量是否正确注入和解析。

2. 安全考虑：确保节点间的网络策略允许Pod访问节点的OTLP收集器端口。

3. 备选方案：如果环境变量解析遇到问题，可以考虑使用init容器预先构建完整的端点URL并写入共享卷。

总结

通过Kubernetes Downward API和Helm配置，可以优雅地解决Selenium容器访问节点本地OTLP收集器的问题。这种方案不仅适用于SeleniumHQ/docker-selenium项目，也可作为其他需要在Pod中访问节点服务的参考模式。