selenium/standalone-kubernetes

Selenium Grid Standalone（Kubernetes动态能力版）

镜像概述

本镜像提供Selenium Grid Standalone，能够在Kubernetes集群中动态创建浏览器会话作为Kubernetes Jobs，支持远程运行WebDriver测试。

核心功能和特性

动态Grid机制

• 按需创建资源：Grid 4支持根据会话请求动态启动容器（在K8s环境中为Pod），每个测试会话独立运行在专用Pod中
• 自动清理：测试完成后自动删除对应的浏览器Pod，避免资源浪费
• 灵活配置：通过TOML配置文件定义浏览器镜像与能力映射关系，支持多种浏览器类型

Kubernetes集成特性

• Pod级隔离：每个测试会话对应一个独立Pod，确保环境一致性
• 动态扩缩容：根据测试请求数量自动调整浏览器Pod数量
• 配置持久化：通过ConfigMap管理浏览器配置，支持动态更新

使用场景和适用范围

• 大规模Web自动化测试：需要并行执行多个WebDriver测试的场景
• CI/CD流程集成：在持续集成/部署流程中嵌入自动化UI测试
• 多浏览器兼容性测试：同时验证应用在Chrome、Firefox、Edge等浏览器上的表现
• 资源受限环境：需要按需分配测试资源的Kubernetes集群环境

使用方法和配置说明

前提条件

• 运行中的Kubernetes集群
• kubectl命令行工具配置完成
• 集群内可访问Docker镜像仓库

最小化部署步骤

1. 创建ConfigMap配置

ConfigMap用于存储浏览器镜像与能力映射关系，示例配置：

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"}'
    ]

应用配置：

bash
kubectl apply -f configmap.yaml

2. 部署Standalone服务

创建Deployment和Service，示例配置：

yaml
# standalone-kubernetes.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: selenium-standalone-kubernetes
  labels:
    app: selenium-standalone-kubernetes
    se/component: standalone
spec:
  replicas: 1
  selector:
    matchLabels:
      app: selenium-standalone-kubernetes
  template:
    metadata:
      labels:
        app: selenium-standalone-kubernetes
        se/component: standalone
    spec:
      serviceAccountName: selenium-node
      terminationGracePeriodSeconds: 300
      containers:
        - name: selenium-standalone-kubernetes
          image: selenium/standalone-kubernetes:4.41.0-20260222
          ports:
            - containerPort: 4444
          env:
            - name: SE_SESSION_REQUEST_TIMEOUT
              value: "600"
            - name: SE_SESSION_RETRY_INTERVAL
              value: "15"
            - name: SE_ROUTER_USERNAME
              value: "admin"
            - name: SE_ROUTER_PASSWORD
              value: "admin"
            - name: SE_NODE_SESSION_TIMEOUT
              value: "600"
            - name: SE_DYNAMIC_OVERRIDE_MAX_SESSIONS
              value: "true"
            - name: SE_DYNAMIC_MAX_SESSIONS
              value: "10"
          resources:
            requests:
              memory: "512Mi"
              cpu: "0.5"
            limits:
              memory: "2Gi"
              cpu: "1"
          livenessProbe:
            exec:
              command:
                - /bin/sh
                - -c
                - curl -G --fail --silent -u ${SE_ROUTER_USERNAME}:${SE_ROUTER_PASSWORD} localhost:4444/status
            initialDelaySeconds: 30
            timeoutSeconds: 5
          readinessProbe:
            httpGet:
              path: /readyz
              port: 4444
            initialDelaySeconds: 30
            timeoutSeconds: 5
          volumeMounts:
            - name: selenium-config
              mountPath: /opt/selenium/kubernetes.toml
              subPath: kubernetes.toml
              readOnly: true
            - name: session-assets
              mountPath: /opt/selenium/assets
      volumes:
        - name: selenium-config
          configMap:
            name: selenium-kubernetes-config
        - name: session-assets
          persistentVolumeClaim:
            claimName: selenium-assets
---
apiVersion: v1
kind: Service
metadata:
  name: selenium-standalone-kubernetes
spec:
  selector:
    app: selenium-standalone-kubernetes
  ports:
    - name: web
      port: 4444
      targetPort: 4444
      nodePort: 30444
  type: NodePort

应用部署：

bash
kubectl apply -f standalone-kubernetes.yaml

3. 配置测试脚本

将WebDriver测试指向Grid服务地址：

http://admin:admin@localhost:30444

4. 访问Grid UI（可选）

通过以下地址访问Grid管理界面：

http://admin:admin@localhost/ui/

环境变量配置

标签选择

镜像标签遵循以下结构：

selenium/standalone-kubernetes-<Major>.<Minor>.<Patch>-<YYYYMMDD>

标签示例（Selenium Grid 4.41.0，20260222发布）

• 4：最新4.x版本
• 4.41：最新4.41.x版本
• 4.41.0：指定4.41.0版本
• 4.41.0-20260222：完整版本（推荐用于版本固定）

完整文档

更多详细信息请参考Docker-Selenium项目的https://github.com/SeleniumHQ/docker-selenium%E3%80%82

许可证

本项目基于https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E5%BC%80%E6%BA%90%E5%8D%8F%E8%AE%AE%E3%80%82