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 runner | Selenium Grid sur votre VPS | |
|---|---|---|
| Installation du navigateur | À chaque build | Une fois, sur le serveur |
| Version testée | Variable d'un runner à l'autre | Identique pour toutes les suites |
| Mémoire du runner | Partagée avec le build | Libre pour le build |
| Observer un test | Captures après coup | Vue en direct dans l'interface |
| Partage entre projets | Impossible | Une 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
Préparer le dossier et le mot de passe
Le fichier
.envporte 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Écrire le fichier docker-compose.yml
Un seul service, l'image officielle avec Chromium.
shm_sizedonne 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"Démarrer et vérifier la grille
L'image embarque son propre contrôle de santé :
--waitrend la main quand la grille est prête. La page/statusdoit répondretrue.docker compose up -d --wait . ./.env curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.readyPublier la grille derrière nginx
Les en-têtes
UpgradeetConnectionlaissent 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; } }Activer HTTPS
Le mot de passe de la grille circule dans chaque requête : ne l'exposez qu'en HTTPS. Sans identifiant,
/statusdoit 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/e2eLe 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.
servorbit.com/ma-fr/blog/self-host-selenium-grid-vps