ما الذي يفعله Selenium Grid
Selenium Grid هو خادم مشروع Selenium، المنشور برخصة Apache-2.0. يتحدث بروتوكول WebDriver الذي وحّده W3C: يطلب منه اختبار مكتوب بـ Java أو Python أو JavaScript أو C# أو Ruby جلسة، فتشغّل الشبكة متصفحًا، وتنفّذ الأوامر (فتح صفحة، نقر، ملء حقل، قراءة نص) وتعيد النتائج.
ينشر مشروع docker-selenium صورًا جاهزة للاستخدام. تجمع صورة standalone في حاوية واحدة الموجّه (مدخل HTTP) وطابور الجلسات وعقدة تحمل المتصفح. على خادم VPS هذه هي الصيغة الأبسط: حاوية واحدة، ومنفذ واحد، ولا مشغّل يجب تثبيته على المضيف. وتستخدم الشبكات الموزعة الكبيرة، بمحور وعشرات العقد، الصور نفسها مقسّمة بشكل آخر.
على عكس خدمة اختبار عبر الإنترنت تُفوتر بالدقيقة، الشبكة ملكك: تبقى الصفحات المختبَرة وحسابات الاختبار ولقطات الشاشة على خادمك.
ما الذي تمنحك إياه الشبكة
- متصفح ثابت — تختبر كل مجموعاتك إصدار Chromium نفسه، أيًّا كان جهاز CI.
- عمليات بناء أقصر — لا تثبيت للمتصفح ولا للمشغّل في كل تشغيل.
- نقطة وصول قياسية — يتصل بها أي عميل WebDriver دون تغيير كود الاختبارات.
- جلسات متوازية — عدة اختبارات في الوقت نفسه، ضمن حدود ذاكرة الخادم.
- عرض مباشر — تعرض واجهة الشبكة المتصفح أثناء عمله.
- شبكة مشتركة — يمكن لعدة مشاريع وعدة أنظمة CI استهداف العنوان نفسه.
Chrome مثبّت على جهاز CI أم شبكة Selenium على خادمك
مرّر الجدول أفقيًا
| Chrome على كل جهاز CI | Selenium Grid على خادمك | |
|---|---|---|
| تثبيت المتصفح | في كل بناء | مرة واحدة على الخادم |
| الإصدار المختبَر | يتغيّر من جهاز لآخر | واحد لكل المجموعات |
| ذاكرة جهاز CI | مشتركة مع البناء | متاحة للبناء |
| مراقبة اختبار | لقطات بعد انتهائه | عرض مباشر في الواجهة |
| المشاركة بين المشاريع | غير ممكنة | عنوان واحد للجميع |
تحضير الخادم
خصّص خادم VPS بنظام Ubuntu 24.04 بذاكرة 2 غيغابايت و2 vCPU: تستهلك الشبكة وحدها أقل من 300 ميغابايت في وضع الخمول، لكن كل جلسة Chromium تحتاج إلى عدة مئات أثناء الاختبار. انتقل إلى 4 غيغابايت لتشغيل جلستين باستمرار. تكفي 10 غيغابايت من القرص، فحجم الصورة يزيد قليلًا على غيغابايت.
ثبّت Docker مع إضافة Compose وnginx وcertbot. تحتاج أيضًا إلى اسم نطاق (أو نطاق فرعي) يشير إلى الخادم: ستتصل خطوط CI بالشبكة من الخارج عبر HTTPS. في الأمثلة، العنوان هو grid.example.com.
تثبيت Selenium Grid باستخدام Docker Compose
تحضير المجلد وكلمة المرور
يحمل ملف
.envاسم المستخدم وكلمة مرور الشبكة. وتحمي كلمة المرور هذه العرض المباشر أيضًا.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كتابة ملف docker-compose.yml
خدمة واحدة، الصورة الرسمية مع Chromium. يمنح
shm_sizeالمتصفح الذاكرة المشتركة التي يحتاجها؛ ومن دونه تتعطل التبويبات في الصفحات الثقيلة. لا يُنشر المنفذ إلا على الحلقة المحلية: وحده nginx سيكون مكشوفًا للإنترنت.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"تشغيل الشبكة والتحقق منها
تتضمن الصورة فحص صحة خاصًا بها: يعيد
--waitالتحكم عندما تصبح الشبكة جاهزة. يجب أن تجيب صفحة/statusبالقيمةtrue.docker compose up -d --wait . ./.env curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.readyنشر الشبكة خلف nginx
تسمح الترويستان
UpgradeوConnectionبمرور websockets الخاصة بالعرض المباشر، وتغطي مهلة القراءة الأوامر الطويلة.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; } }تفعيل HTTPS
تنتقل كلمة مرور الشبكة مع كل طلب: لا تكشفها إلا عبر HTTPS. من دون بيانات الدخول، يجب أن تجيب
/statusبالرمز 401.certbot --nginx -d grid.example.com curl -s -o /dev/null -w '%{http_code}\n' https://grid.example.com/status
لا تفتح الشبكة أبدًا دون كلمة مرور
شبكة Selenium يمكن الوصول إليها دون مصادقة هي متصفح يستطيع أي شخص التحكم فيه من خادمك: زيارة مواقع، وملء نماذج، والالتفاف على تصفية حسب عنوان IP. والروبوتات التي تمسح الإنترنت تبحث تحديدًا عن المنفذ 4444. احتفظ بـ SE_ROUTER_PASSWORD، واترك المنفذ على 127.0.0.1، ولا تفتح للعموم إلا المنفذ 443 الخاص بـ nginx.
ربط اختباراتك بالشبكة
في جهة الاختبار، لا يتغيّر إلا تشغيل المتصفح: بدل مشغّل محلي، تنشئ RemoteWebDriver يشير إلى عنوان الشبكة مع بيانات الدخول. ويبقى باقي الاختبار كما هو. بلغة 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()وبلغة JavaScript مع selenium-webdriver، المبدأ نفسه. تستجيب عقدة Chromium لاسم المتصفح chrome. وتعمل أيضًا العملاء القديمة التي تضيف /wd/hub إلى العنوان، فالشبكة تقبل الصيغتين.
const { Builder } = require("selenium-webdriver");
const driver = await new Builder()
.usingServer("https://admin:[email protected]")
.forBrowser("chrome")
.build();تشغيل الاختبارات من GitHub Actions أو GitLab CI
احفظ كلمة المرور في أسرار CI وكوّن العنوان عند تشغيل المهمة. تقرأ اختباراتك SELENIUM_URL بدل تشغيل متصفح محلي:
- name: Tests de bout en bout
env:
SELENIUM_URL: https://admin:${{ secrets.SELENIUM_PASSWORD }}@grid.example.com
run: pytest tests/e2eينطبق النمط نفسه على GitLab CI (متغير مقنَّع) وJenkins (مدير بيانات الاعتماد) وGitea Actions. يجب أن يكون الموقع المختبَر قابلًا للوصول من الخادم: تصلح بيئة ما قبل الإنتاج العامة أو المحمية بكلمة مرور، ولا يصلح خادم تطوير يعمل داخل جهاز CI، إلا إذا كشفته عبر نفق.
متابعة جلسة وتحرير الشبكة
تعرض الواجهة https://grid.example.com/ui/ الجلسات الجارية. انقر على جلسة ثم على أيقونة الكاميرا لمشاهدة المتصفح؛ كلمة المرور المطلوبة هي كلمة مرور الشبكة. الاختبار الذي يتعطل دون استدعاء quit() يُبقي خانته مشغولة حتى انتهاء مهلة SE_NODE_SESSION_TIMEOUT (خمس دقائق هنا). لتحرير جلسة عالقة فورًا:
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>تكشف سجلات الحاوية (docker compose logs -f selenium) سبب رفض الجلسة: قدرة مطلوبة غير معروفة، أو طابور ممتلئ، أو متصفح لا يبدأ.
السعة والذاكرة والمتصفحات الأخرى
تفتح الإعدادات أعلاه جلستين متوازيتين. وما يزيد على ذلك ينتظر في الطابور ثم يفشل بعد SE_SESSION_REQUEST_TIMEOUT (300 ثانية افتراضيًا). للتوسّع، زد ذاكرة الخادم قبل SE_NODE_MAX_SESSIONS: متصفح Chromium الذي تنقصه الذاكرة لا يتباطأ، بل يتعطل.
تُستخدم صورتا standalone-firefox وstandalone-edge بالطريقة نفسها تمامًا؛ لا تُنشر Edge وGoogle Chrome إلا لمعالجات x86-64، بينما يتوفر Chromium وFirefox أيضًا لمعالجات ARM. لاختبار عدة متصفحات، شغّل خدمة لكل صورة على منافذ مختلفة.
تثبيت Selenium Grid بنقرة واحدة من متجر ServOrbit
يثبّت متجر ServOrbit هذه الإعدادات نفسها على خادمك: الصورة الرسمية مع Chromium، وشبكة محمية بالمستخدم admin وكلمة مرور مولَّدة، ومنفذ منشور على الحلقة المحلية، ووكيل عكسي nginx عبر HTTPS. يتطلب Selenium Grid نطاقًا لأن خطوط CI تتصل به من الخارج: اختر نطاقًا فرعيًا من أحد نطاقاتك، أو النطاق الفرعي المجاني للخادم مع HTTPS. تظهر كلمة المرور في مساحة العميل.
servorbit.com/ma-ar/المدونة/استضافة-selenium-grid-على-vps