Autoalojamiento

Selenium Grid en un VPS: pruebas de navegador para su CI

Sus pruebas de extremo a extremo necesitan un navegador real. Instalar Chrome y su driver en cada runner de la CI cuesta tiempo en cada build, y la versión cambia de una máquina a otra. Selenium Grid lo resuelve de otra forma: un servidor WebDriver que funciona permanentemente y entrega un navegador a sus pruebas cuando lo piden. Esta guía lo instala en un VPS con la imagen oficial docker-selenium, lo protege con una contraseña, lo publica en HTTPS detrás de nginx y conecta a él pruebas en Python, JavaScript y GitHub Actions.

Desplegar en un VPS Cloud →
7 min de lectura5 pasos
Contenido· Qué hace Selenium Grid1/11
  1. 01Qué hace Selenium Grid
  2. 02Lo que le aporta la grid
  3. 03Chrome instalado en el runner o grid de Selenium en su VPS
  4. 04Preparar el servidor
  5. 05Instalar Selenium Grid con Docker Compose
  6. 06No abra nunca la grid sin contraseña
  7. 07Conectar sus pruebas a la grid
  8. 08Ejecutar las pruebas desde GitHub Actions o GitLab CI
  9. 09Seguir una sesión y desbloquear la grid
  10. 10Capacidad, memoria y otros navegadores
  11. 11Instalar Selenium Grid en un clic desde el Marketplace de ServOrbit

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 runnerSelenium Grid en su VPS
Instalación del navegadorEn cada buildUna vez, en el servidor
Versión probadaVaría de un runner a otroIdéntica para todas las baterías
Memoria del runnerCompartida con el buildLibre para el build
Observar una pruebaCapturas a posterioriVista en directo en la interfaz
Compartir entre proyectosImposibleUna 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

  1. Preparar la carpeta y la contraseña

    El archivo .env contiene 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 .env
  2. Escribir el archivo docker-compose.yml

    Un solo servicio, la imagen oficial con Chromium. shm_size da 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"
  3. Arrancar y comprobar la grid

    La imagen incluye su propio control de salud: --wait devuelve el control cuando la grid está lista. La página /status debe responder true.

    docker compose up -d --wait
    . ./.env
    curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.ready
  4. Publicar la grid detrás de nginx

    Las cabeceras Upgrade y Connection dejan 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;
        }
    }
  5. Activar HTTPS

    La contraseña de la grid viaja en cada petición: expóngala solo en HTTPS. Sin credenciales, /status debe 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/e2e

El 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.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-selenium-grid-vps

Su grid de Selenium, en su VPS

Precios sin IVA, mostrados con su precio de renovación.