Qué hace Selenium Grid
Selenium Grid es el servidor del proyecto Selenium, publicado bajo licencia Apache-2.0. Habla el protocolo WebDriver normalizado por el W3C: una prueba escrita en Java, Python, JavaScript, C# o Ruby le pide una sesión, la grid inicia un navegador, ejecuta los comandos (abrir una página, hacer clic, rellenar un campo, leer un texto) y devuelve los resultados.
El proyecto docker-selenium publica imágenes listas para usar. La imagen standalone reúne en un solo contenedor el router (la puerta de entrada HTTP), la cola de sesiones y un nodo que lleva el navegador. En un VPS es la forma más sencilla: un contenedor, un puerto y ningún driver que instalar en el host. Las grandes grids distribuidas, con un hub y decenas de nodos, usan las mismas imágenes repartidas de otra manera.
A diferencia de un servicio de pruebas en línea facturado por minuto, la grid le pertenece: las páginas probadas, las cuentas de prueba y las capturas se quedan en su servidor.
Lo que le aporta la grid
- Un navegador estable — todas sus baterías prueban la misma versión de Chromium, sea cual sea el runner.
- Builds más cortos — se acabó instalar navegador y driver en cada ejecución.
- Un punto de acceso estándar — cualquier cliente WebDriver se conecta sin cambiar el código de las pruebas.
- Sesiones en paralelo — varias pruebas a la vez, dentro de la memoria del VPS.
- Una vista en directo — la interfaz de la grid muestra el navegador mientras trabaja.
- Una grid compartida — varios proyectos y varias CI pueden apuntar a la misma dirección.
Chrome instalado en el runner o grid de Selenium en su VPS
Desplace la tabla
| Chrome en cada runner | Selenium Grid en su VPS | |
|---|---|---|
| Instalación del navegador | En cada build | Una vez, en el servidor |
| Versión probada | Varía de un runner a otro | Idéntica para todas las baterías |
| Memoria del runner | Compartida con el build | Libre para el build |
| Observar una prueba | Capturas a posteriori | Vista en directo en la interfaz |
| Compartir entre proyectos | Imposible | Una dirección para todos |
Preparar el servidor
Prevea un VPS Ubuntu 24.04 con 2 GB de RAM y 2 vCPU: la grid sola consume menos de 300 MB en reposo, pero cada sesión de Chromium necesita varios cientos durante una prueba. Pase a 4 GB para sostener dos sesiones continuas. Bastan 10 GB de disco, la imagen pesa algo más de un GB.
Instale Docker con el plugin Compose, nginx y certbot. También necesita un nombre de dominio (o un subdominio) que apunte al VPS: sus pipelines se conectarán a la grid desde fuera, por HTTPS. En los ejemplos, la dirección es grid.example.com.
Instalar Selenium Grid con Docker Compose
Preparar la carpeta y la contraseña
El archivo
.envcontiene el usuario y la contraseña de la grid. Esta contraseña también protege la vista en directo.mkdir -p /opt/selenium-grid && cd /opt/selenium-grid cat > .env <<EOF ADMIN_USER=admin ADMIN_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envEscribir el archivo docker-compose.yml
Un solo servicio, la imagen oficial con Chromium.
shm_sizeda al navegador la memoria compartida que necesita; sin ella, las pestañas fallan en las páginas pesadas. El puerto solo se publica en el bucle local: solo nginx quedará expuesto a Internet.services: selenium: image: selenium/standalone-chromium:4.53.0-20261120 restart: unless-stopped shm_size: 2gb environment: SE_ROUTER_USERNAME: ${ADMIN_USER:-admin} SE_ROUTER_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD manquant} SE_VNC_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD manquant} SE_NODE_MAX_SESSIONS: "2" SE_NODE_OVERRIDE_MAX_SESSIONS: "true" SE_NODE_SESSION_TIMEOUT: "300" ports: - "127.0.0.1:4444:4444"Arrancar y comprobar la grid
La imagen incluye su propio control de salud:
--waitdevuelve el control cuando la grid está lista. La página/statusdebe respondertrue.docker compose up -d --wait . ./.env curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.readyPublicar la grid detrás de nginx
Las cabeceras
UpgradeyConnectiondejan pasar los websockets de la vista en directo, y el tiempo de lectura cubre los comandos largos.server { server_name grid.example.com; location / { proxy_pass http://127.0.0.1:4444; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_read_timeout 300s; } }Activar HTTPS
La contraseña de la grid viaja en cada petición: expóngala solo en HTTPS. Sin credenciales,
/statusdebe responder 401.certbot --nginx -d grid.example.com curl -s -o /dev/null -w '%{http_code}\n' https://grid.example.com/status
No abra nunca la grid sin contraseña
Una grid de Selenium accesible sin autenticación es un navegador que cualquiera puede controlar desde su servidor: visitar sitios, rellenar formularios, saltarse un filtrado por dirección IP. Los robots que barren Internet buscan precisamente el puerto 4444. Mantenga SE_ROUTER_PASSWORD, deje el puerto en 127.0.0.1 y abra al público solo el 443 de nginx.
Conectar sus pruebas a la grid
Del lado de la prueba, solo cambia el arranque del navegador: en lugar de un driver local, se crea un RemoteWebDriver que apunta a la dirección de la grid, credenciales incluidas. El resto de la prueba no cambia. En Python:
from selenium import webdriver
options = webdriver.ChromeOptions()
driver = webdriver.Remote(
command_executor="https://admin:[email protected]",
options=options,
)
driver.get("https://example.com")
print(driver.title)
driver.quit()En JavaScript con selenium-webdriver, mismo principio. El nodo Chromium responde al nombre de navegador chrome. Los clientes antiguos que añaden /wd/hub a la dirección también funcionan, la grid acepta ambas formas.
const { Builder } = require("selenium-webdriver");
const driver = await new Builder()
.usingServer("https://admin:[email protected]")
.forBrowser("chrome")
.build();Ejecutar las pruebas desde GitHub Actions o GitLab CI
Guarde la contraseña en los secretos de la CI y construya la dirección en el momento del job. Sus pruebas leen SELENIUM_URL en lugar de iniciar un navegador local:
- name: Tests de bout en bout
env:
SELENIUM_URL: https://admin:${{ secrets.SELENIUM_PASSWORD }}@grid.example.com
run: pytest tests/e2eEl mismo esquema sirve para GitLab CI (variable enmascarada), Jenkins (gestor de credenciales) o Gitea Actions. El sitio probado debe ser accesible desde el VPS: un entorno de preproducción público o protegido por contraseña sirve, un servidor de desarrollo lanzado dentro del runner no, salvo que lo exponga por un túnel.
Seguir una sesión y desbloquear la grid
La interfaz https://grid.example.com/ui/ lista las sesiones en curso. Haga clic en una sesión y después en el icono de la cámara para ver el navegador; la contraseña que se pide es la de la grid. Una prueba que falla sin llamar a quit() mantiene su hueco ocupado hasta el plazo SE_NODE_SESSION_TIMEOUT (cinco minutos aquí). Para liberar de inmediato una sesión bloqueada:
curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status \
| jq '.value.nodes[].slots[] | select(.session != null) | .session.sessionId'
curl -s -u "admin:$ADMIN_PASSWORD" -X DELETE http://127.0.0.1:4444/session/<id>Los registros del contenedor (docker compose logs -f selenium) dan la causa de una sesión rechazada: capacidad solicitada desconocida, cola llena o navegador que no arranca.
Capacidad, memoria y otros navegadores
La configuración anterior abre dos sesiones en paralelo. Por encima, las peticiones esperan en la cola y luego fallan tras SE_SESSION_REQUEST_TIMEOUT (300 segundos por defecto). Para crecer, aumente la RAM del VPS antes que SE_NODE_MAX_SESSIONS: un Chromium sin memoria no se ralentiza, se cae.
Las imágenes standalone-firefox y standalone-edge se usan exactamente igual; Edge y Google Chrome solo se publican para procesadores x86-64, Chromium y Firefox también existen para ARM. Para probar varios navegadores, lance un servicio por imagen en puertos distintos.
Instalar Selenium Grid en un clic desde el Marketplace de ServOrbit
El Marketplace de ServOrbit instala esta misma configuración en su VPS: imagen oficial con Chromium, grid protegida por el usuario admin y una contraseña generada, puerto publicado en el bucle local y proxy inverso nginx en HTTPS. Selenium Grid requiere un dominio, ya que sus pipelines se conectan a él desde fuera: elija un subdominio de uno de sus dominios, o el subdominio gratuito del VPS, HTTPS incluido. La contraseña aparece en su área de cliente.
servorbit.com/ma-es/blog/autoalojar-selenium-grid-vps