selenium/node-kubernetes

Kubernetes集群中具备动态能力的Selenium Grid Node

镜像概述和主要用途

该镜像提供https://www.selenium.dev/documentation/grid/getting_started/#hub-and-node%EF%BC%8C%E5%8F%AF%E5%9C%A8Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%AD%E5%8A%A8%E6%80%81%E5%88%9B%E5%BB%BA%E6%B5%8F%E8%A7%88%E5%99%A8%E4%BC%9A%E8%AF%9D%E4%BD%9C%E4%B8%BAKubernetes%E4%BB%BB%E5%8A%A1%EF%BC%8C%E9%9C%80%E4%B8%8Ehttps://www.selenium.dev/documentation/grid/getting_started/#hub-and-node%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%AE%9E%E7%8E%B0https://www.selenium.dev/documentation/webdriver/drivers/remote_webdriver/%E3%80%82

核心功能和特性

动态Grid

Grid 4支持按需启动容器/Pod：针对每个新会话请求，在后台启动浏览器Pod，测试执行完成后自动删除该Pod。此模式可用于Standalone或Node角色，需通过TOML配置文件指定使用的浏览器镜像及Kubernetes相关配置。

在Kubernetes集群中应用相同动态Grid概念：Grid为每个会话请求精确创建一个浏览器Pod，会话关闭后立即删除。

InheritedPodSpec扩展策略

https://github.com/SeleniumHQ/selenium/blob/selenium-4.41.0/java/src/org/openqa/selenium/grid/node/kubernetes/InheritedPodSpec.java%E4%BD%BF%E5%A4%9ANode%E9%83%A8%E7%BD%B2%E6%9B%B4%E5%BC%BA%E5%A4%A7%E3%80%82Dynamic Grid Node在Kubernetes中运行时，会检查自身Pod规范，并自动将匹配字段（容忍度、亲和性规则、节点选择器、资源请求与限制、镜像拉取密钥、服务账户、DNS配置、安全上下文、PVC挂载等）传播到创建的每个浏览器任务，确保浏览器Pod与生成它的Dynamic Node具有相同的部署约束（如节点池、可用区）。

独立配置与最小权限

• 浏览器类型和动态Grid配置通过TOML文件管理，由ConfigMap挂载到Node Pod，支持独立更新，无需重新部署Node。
• 通过RBAC配置仅授予Node必要权限（在指定命名空间内对pods和pods/log的create、delete、get权限），无集群级权限。

使用场景和适用范围

• Kubernetes集群中的WebDriver自动化测试
• 多区域/节点池的分布式测试部署
• 资源高效利用的测试环境（仅在测试运行时消耗资源）
• 大规模Kubernetes集群中的按需浏览器资源调度

使用方法和配置说明

最小Hub+Node设置

参考Kubernetes清单位于https://github.com/SeleniumHQ/docker-selenium/tree/4.41.0-20260222/kubernetes/DynamicGrid%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E6%9C%AC%E5%9C%B0%E5%AE%9E%E8%B7%B5%E5%92%8C%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8%E3%80%82

1. ConfigMap配置（浏览器类型与能力）

通过ConfigMap提供TOML配置文件，定义浏览器镜像与对应的能力描述：

yaml
# configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: selenium-kubernetes-config
data:
  kubernetes.toml: |
    [kubernetes]
    configs = [
        "selenium/standalone-chrome:4.41.0-20260222", '{"browserName": "chrome", "platformName": "linux"}',
        "selenium/standalone-firefox:4.41.0-20260222", '{"browserName": "firefox", "platformName": "linux"}',
        "selenium/standalone-edge:4.41.0-20260222", '{"browserName": "MicrosoftEdge", "platformName": "linux"}'
    ]

• configs数组：每对元素包含浏览器镜像和对应的能力描述JSON字符串，Node使用这些配置匹配会话请求与浏览器镜像。

2. Node部署配置

部署Node并挂载ConfigMap及会话资源PVC：

yaml
# node-kubernetes-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: selenium-node-kubernetes
spec:
  replicas: 1
  template:
    spec:
      serviceAccountName: selenium-node  # 需具备Pod创建/删除RBAC权限
      terminationGracePeriodSeconds: 300
      containers:
        - name: selenium-node-kubernetes
          image: docker.xuanyuan.run/selenium/node-kubernetes:4.41.0-20260222
          ports:
            - containerPort: 5555
          env:
            - name: SE_EVENT_BUS_HOST
              value: "selenium-hub"  # 事件总线主机（Hub地址）
            - name: SE_NODE_SESSION_TIMEOUT
              value: "600"          # 会话超时时间（秒）
            - name: SE_DYNAMIC_OVERRIDE_MAX_SESSIONS
              value: "true"         # 启用动态覆盖最大会话数
            - name: SE_DYNAMIC_MAX_SESSIONS
              value: "10"           # 动态最大会话数
          volumeMounts:
            - name: selenium-config
              mountPath: /opt/selenium/kubernetes.toml  # TOML配置文件路径
              subPath: kubernetes.toml
              readOnly: true
            - name: session-assets                      # 会话资产（视频/日志）共享PVC
              mountPath: /opt/selenium/assets
      volumes:
        - name: selenium-config
          configMap:
            name: selenium-kubernetes-config            # 引用上述ConfigMap
        - name: session-assets
          persistentVolumeClaim:
            claimName: selenium-assets

3. RBAC权限配置

授予Node必要的Pod管理权限：

yaml
# rbac.yaml（示例片段）
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: selenium-node-role
rules:
  - apiGroups: [""]
    resources: ["pods", "pods/log"]
    verbs: ["create", "delete", "get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: selenium-node-role-binding
subjects:
  - kind: ServiceAccount
    name: selenium-node
roleRef:
  kind: Role
  name: selenium-node-role
  apiGroup: rbac.authorization.k8s.io

多Node部署架构

可部署多个Dynamic Grid Node，每个通过nodeSelector或affinity固定到不同集群片段（如可用区），均注册到同一Hub。Hub在Node间分发会话请求，每个Node创建的浏览器Pod继承其部署约束：

                         ┌─────────────────────────────────┐
                         │             Hub                  │
                         └──────┬──────────────┬───────────┘
                                │              │
               ┌────────────────▼──┐      ┌────▼───────────────┐
               │ NodeKubernetes    │      │ NodeKubernetes      │
               │ nodeSelector:     │      │ nodeSelector:       │
               │   zone=us-west    │      │   zone=us-east      │
               └────────┬──────────┘      └─────────┬───────────┘
                        │ inherits spec             │ inherits spec
              ┌─────────▼──────────┐    ┌──────────▼──────────┐
              │  browser Pod       │    │  browser Pod         │
              │  (us-west, same    │    │  (us-east, same      │
              │   tolerations...)  │    │   tolerations...)    │
              └────────────────────┘    └─────────────────────┘

版本标签示例

Selenium Grid Server 4.41.0（发布日期20260222）对应的镜像标签：

e126989f151e        selenium/node-kubernetes   4
e126989f151e        selenium/node-kubernetes   4.41
e126989f151e        selenium/node-kubernetes   4.41.0
e126989f151e        selenium/node-kubernetes   4.41.0-20260222

可使用不同标签获取对应版本，如4.41.0-20260222为完整版本标签。

完整文档

Docker-Selenium项目在GitHub提供详细https://github.com/SeleniumHQ/docker-selenium%EF%BC%8C%E5%B8%AE%E5%8A%A9%E6%A0%B9%E6%8D%AE%E5%85%B7%E4%BD%93%E5%9C%BA%E6%99%AF%E9%85%8D%E7%BD%AE%E5%92%8C%E8%BF%90%E8%A1%8C%E9%95%9C%E5%83%8F%E3%80%82

许可证

项目由志愿者贡献，源代码基于https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E5%BC%80%E6%BA%90%E3%80%82