Self-hosting

Selenium Grid sur VPS : vos tests de navigateur dans la CI

Vos tests de bout en bout ont besoin d'un vrai navigateur. Installer Chrome et son pilote sur chaque runner de la CI coûte du temps à chaque build, et la version change d'une machine à l'autre. Selenium Grid règle le problème autrement : un serveur WebDriver qui tourne en permanence, auquel vos tests demandent un navigateur. Ce guide l'installe sur un VPS avec l'image officielle docker-selenium, le protège par un mot de passe, le publie en HTTPS derrière nginx et branche des tests Python, JavaScript et GitHub Actions dessus.

Déployer sur un VPS Cloud →
7 min de lecture5 étapes
Sommaire· Ce que fait Selenium Grid1/11
  1. 01Ce que fait Selenium Grid
  2. 02Ce que la grille vous apporte
  3. 03Chrome installé sur le runner ou grille Selenium sur votre VPS
  4. 04Préparer le serveur
  5. 05Installer Selenium Grid avec Docker Compose
  6. 06N'ouvrez jamais la grille sans mot de passe
  7. 07Brancher vos tests sur la grille
  8. 08Lancer les tests depuis GitHub Actions ou GitLab CI
  9. 09Suivre une session et débloquer la grille
  10. 10Capacité, mémoire et autres navigateurs
  11. 11Installer Selenium Grid en un clic depuis le Marketplace ServOrbit

Ce que fait Selenium Grid

Selenium Grid est le serveur du projet Selenium, publié sous licence Apache-2.0. Il parle le protocole WebDriver normalisé par le W3C : un test écrit en Java, Python, JavaScript, C# ou Ruby lui demande une session, la grille démarre un navigateur, exécute les commandes (ouvrir une page, cliquer, remplir un champ, lire un texte) et renvoie les résultats.

Le projet docker-selenium publie des images prêtes à l'emploi. L'image standalone réunit dans un seul conteneur le routeur (la porte d'entrée HTTP), la file des sessions et un nœud qui porte le navigateur. Pour un VPS, c'est la forme la plus simple : un conteneur, un port, et aucun pilote à installer sur l'hôte. Les grandes grilles distribuées, avec un hub et des dizaines de nœuds, utilisent les mêmes images découpées autrement.

À la différence d'un service de test en ligne facturé à la minute, la grille vous appartient : les pages testées, les comptes de test et les captures restent sur votre serveur.

Ce que la grille vous apporte

  • Un navigateur stable — toutes vos suites testent la même version de Chromium, quel que soit le runner.
  • Des builds plus courts — plus d'installation de navigateur ni de pilote à chaque exécution.
  • Un point d'accès standard — n'importe quel client WebDriver s'y connecte, sans changer le code des tests.
  • Des sessions parallèles — plusieurs tests en même temps, dans la limite de la mémoire du VPS.
  • Une vue en direct — l'interface de la grille montre le navigateur pendant qu'il travaille.
  • Une grille partagée — plusieurs projets et plusieurs CI peuvent viser la même adresse.

Chrome installé sur le runner ou grille Selenium sur votre VPS

Faites défiler le tableau

Chrome sur chaque runnerSelenium Grid sur votre VPS
Installation du navigateurÀ chaque buildUne fois, sur le serveur
Version testéeVariable d'un runner à l'autreIdentique pour toutes les suites
Mémoire du runnerPartagée avec le buildLibre pour le build
Observer un testCaptures après coupVue en direct dans l'interface
Partage entre projetsImpossibleUne adresse pour tous

Préparer le serveur

Prévoyez un VPS Ubuntu 24.04 avec 2 Go de RAM et 2 vCPU : la grille seule consomme moins de 300 Mo au repos, mais chaque session Chromium en demande plusieurs centaines pendant un test. Passez à 4 Go pour tenir deux sessions en continu. 10 Go de disque suffisent, l'image pèse un peu plus d'un Go.

Installez Docker avec le plugin Compose, nginx et certbot. Il vous faut aussi un nom de domaine (ou un sous-domaine) pointé vers le VPS : vos pipelines se connecteront à la grille depuis l'extérieur, en HTTPS. Dans les exemples, l'adresse est grid.example.com.

Installer Selenium Grid avec Docker Compose

  1. Préparer le dossier et le mot de passe

    Le fichier .env porte l'identifiant et le mot de passe de la grille. Ce mot de passe protège aussi la vue en direct.

    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. Écrire le fichier docker-compose.yml

    Un seul service, l'image officielle avec Chromium. shm_size donne au navigateur la mémoire partagée dont il a besoin ; sans lui, les onglets plantent sur les pages lourdes. Le port n'est publié que sur la boucle locale : seul nginx sera exposé à 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. Démarrer et vérifier la grille

    L'image embarque son propre contrôle de santé : --wait rend la main quand la grille est prête. La page /status doit répondre true.

    docker compose up -d --wait
    . ./.env
    curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.ready
  4. Publier la grille derrière nginx

    Les en-têtes Upgrade et Connection laissent passer les websockets de la vue en direct, et le délai de lecture couvre les commandes longues.

    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. Activer HTTPS

    Le mot de passe de la grille circule dans chaque requête : ne l'exposez qu'en HTTPS. Sans identifiant, /status doit répondre 401.

    certbot --nginx -d grid.example.com
    curl -s -o /dev/null -w '%{http_code}\n' https://grid.example.com/status

N'ouvrez jamais la grille sans mot de passe

Une grille Selenium accessible sans authentification est un navigateur que n'importe qui peut piloter depuis votre serveur : visiter des sites, remplir des formulaires, contourner un filtrage par adresse IP. Les robots qui balaient Internet cherchent précisément le port 4444. Gardez SE_ROUTER_PASSWORD, laissez le port sur 127.0.0.1 et n'ouvrez au public que le 443 de nginx.

Brancher vos tests sur la grille

Côté test, seul le démarrage du navigateur change : au lieu d'un pilote local, on crée un RemoteWebDriver qui vise l'adresse de la grille, identifiants compris. Le reste du test ne bouge pas. 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 avec selenium-webdriver, même principe. Le nœud Chromium répond au nom de navigateur chrome. Les anciens clients qui ajoutent /wd/hub à l'adresse fonctionnent aussi, la grille accepte les deux formes.

const { Builder } = require("selenium-webdriver");

const driver = await new Builder()
  .usingServer("https://admin:[email protected]")
  .forBrowser("chrome")
  .build();

Lancer les tests depuis GitHub Actions ou GitLab CI

Rangez le mot de passe dans les secrets de la CI et construisez l'adresse au moment du job. Vos tests lisent SELENIUM_URL au lieu de démarrer un navigateur local :

- name: Tests de bout en bout
  env:
    SELENIUM_URL: https://admin:${{ secrets.SELENIUM_PASSWORD }}@grid.example.com
  run: pytest tests/e2e

Le même schéma vaut pour GitLab CI (variable masquée), Jenkins (identifiants du gestionnaire) ou Gitea Actions. Le site testé doit être joignable depuis le VPS : un environnement de préproduction public ou protégé par mot de passe convient, un serveur de développement lancé dans le runner non, sauf à l'exposer par un tunnel.

Suivre une session et débloquer la grille

L'interface https://grid.example.com/ui/ liste les sessions en cours. Cliquez sur une session puis sur l'icône de caméra pour regarder le navigateur ; le mot de passe demandé est celui de la grille. Un test qui plante sans appeler quit() garde son emplacement occupé jusqu'au délai SE_NODE_SESSION_TIMEOUT (cinq minutes ici). Pour libérer tout de suite une session bloquée :

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>

Les journaux du conteneur (docker compose logs -f selenium) donnent la cause d'une session refusée : capacité demandée inconnue, file pleine ou navigateur qui ne démarre pas.

Capacité, mémoire et autres navigateurs

La configuration ci-dessus ouvre deux sessions en parallèle. Au-delà, les demandes attendent dans la file, puis échouent après SE_SESSION_REQUEST_TIMEOUT (300 secondes par défaut). Pour monter en charge, augmentez la RAM du VPS avant SE_NODE_MAX_SESSIONS : un Chromium qui manque de mémoire ne ralentit pas, il plante.

Les images standalone-firefox et standalone-edge s'utilisent exactement de la même façon ; Edge et Google Chrome ne sont publiés que pour les processeurs x86-64, Chromium et Firefox existent aussi pour ARM. Pour tester plusieurs navigateurs, lancez un service par image sur des ports différents.

Installer Selenium Grid en un clic depuis le Marketplace ServOrbit

Le Marketplace ServOrbit installe cette même configuration sur votre VPS : image officielle avec Chromium, grille protégée par l'utilisateur admin et un mot de passe généré, port publié sur la boucle locale et reverse proxy nginx en HTTPS. Selenium Grid exige un domaine, puisque vos pipelines s'y connectent depuis l'extérieur : choisissez un sous-domaine de l'un de vos domaines, ou le sous-domaine gratuit du VPS, HTTPS compris. Le mot de passe s'affiche dans votre espace client.

Partager cet articleservorbit.com/ma-fr/blog/self-host-selenium-grid-vps

Votre grille Selenium, sur votre VPS

Prix HT affichés avec leur renouvellement.