استخدام Chrome لإصلاح خطأ ملف DevToolsActivePort في السيلينيوم في إجراءات GitHub

التغلب على فشل اختبار Chrome في خطوط أنابيب CI/CD

إجراء اختبارات السيلينيوم في كروم مقطوعة الرأس على إجراءات جيثب يجب أن تكون سلسة. ومع ذلك، يواجه العديد من المطورين الخطأ المحبط "ملف DevToolsActivePort غير موجود". يحدث هذا عندما يفشل Chrome، لسبب أو لآخر، في بدء التشغيل بشكل صحيح في بيئة CI.

تشير رسالة الخطأ عادةً إلى أن Chrome يتعطل بشكل غير متوقع، والذي غالبًا ما يكون نتيجة لعدم التطابق الكروم و ChromeDriver الإصدارات أو الخيارات التي تم تكوينها بشكل خاطئ في إعداد الاختبار. مثل العديد من المطورين، واجهت هذا التحدي، خاصة عند نشر الاختبارات الآلية في بيئة التكامل المستمر بيئة.

في هذا الإعداد، يمكن لأصغر اختلال في المحاذاة، مثل عدم تطابق إصدار ChromeDriver، أن يؤدي إلى توقف تنفيذ الاختبار، مما يكلف وقتًا وموارد ثمينة. ولحسن الحظ، فإن فهم المشكلات الأساسية يجعل حلها أسهل بكثير 🛠️.

في هذا الدليل، سنتعمق في الخطوات العملية لمنع هذا الخطأ الشائع واستكشاف أخطائه وإصلاحها. بدءًا من تفاصيل تثبيت Chrome وحتى التهيئة الصحيحة لبرنامج التشغيل، ستجد عملية خطوة بخطوة لضمان تشغيل الاختبار بسلاسة في كل مرة. دعونا نعالج هذه المشكلة ونعيد اختباراتك إلى المسار الصحيح!

الحل التفصيلي لإعداد Chrome وChromeDriver في CI

تم تصميم البرامج النصية أعلاه لتثبيت وتكوين كل من Chrome وChromeDriver إجراءات جيثب البيئات، وتحديدًا معالجة الخطأ "ملف DevToolsActivePort غير موجود". تحدث هذه المشكلة عادةً عندما يتعذر على Chrome، الذي يعمل في وضع مقطوعة الرأس، بدء التشغيل بشكل صحيح بسبب عدم التطابقات أو قيود الذاكرة. يعالج النص البرمجي الأول هذه المشكلة عن طريق تحديد إصدار Chrome والتأكد من توافقه مع ChromeDriver، وهو أمر بالغ الأهمية للتشغيل السيلينيوم الاختبارات. تقوم الأوامر الأولية بتحديث الحزم apt وتستخدم wget لجلب إصدار معين من Google Chrome من المرآة. يضمن استخدام المرآة تثبيت الإصدار الصحيح، خاصة إذا كان المستودع الافتراضي يفتقر إلى هذا الإصدار. يضمن هذا الأسلوب استخدام إصدار ثابت من Chrome عبر عمليات تشغيل اختبارية مختلفة.

بعد ذلك، يتابع البرنامج النصي تثبيت ChromeDriver المتوافق مع الإصدار عن طريق عزل الإصدار الرئيسي من Chrome (على سبيل المثال، "117" من "117.0.5938.62") باستخدام أمر لتحليله. يسمح هذا للبرنامج النصي بإحضار برنامج ChromeDriver الدقيق المطلوب لهذا الإصدار الرئيسي المحدد باستخدام نمط عنوان URL المصمم لإصدارات ChromeDriver. من خلال التأكد من محاذاة هذه الإصدارات، يمنع الإعداد الإصدارات غير المتطابقة من التسبب في فشل تهيئة ChromeDriver، والذي يؤدي غالبًا إلى ظهور خطأ DevTools. إذا فشل ChromeDriver في تنزيل الإصدار المحدد، يتضمن البرنامج النصي خيارًا احتياطيًا لتنزيل أحدث إصدار، مع الحفاظ على المرونة. تعتبر هذه الخطوات مفيدة بشكل خاص في خطوط أنابيب CI/CD الآلية حيث تكون الحلول السريعة والموثوقة ذات أولوية 🔧.

بعد التنزيل، يقوم البرنامج النصي بحذف أي ChromeDriver تم تثبيته مسبقًا من النظام باستخدام "sudo rm -f" لتجنب التعارض مع برامج التشغيل الأقدم. وهذا يضمن وجود الإصدار الصحيح فقط، مما يقلل من مخاطر تعارضات الإصدار التي يمكن أن تعطل استقرار الاختبار. تم أيضًا تعيين أذونات ChromeDriver لتكون قابلة للتنفيذ، وهي خطوة ضرورية لتشغيل برنامج التشغيل في بيئات CI/CD. يؤدي استخدام Chrome في الوضع "بدون رأس" مع خيارات مثل "--no-sandbox" و"--disable-dev-shm-usage" أيضًا إلى تقليل أثر موارد Chrome. تعمل هذه الخيارات على تمكين الاختبارات من التشغيل في بيئات ذات موارد محدودة (مثل الخوادم السحابية أو خطوط أنابيب CI) دون التسبب في تعطل Chrome، وهو أحد الأسباب الشائعة وراء خطأ DevToolsActivePort.

أخيرًا، في إعداد WebDriver، تضمن خيارات مثل "--disable-gpu" و"-remote-debugging-port=9222" تشغيل Chrome أكثر استقرارًا في الوضع بدون رأس. تعمل العلامة "--disable-gpu" على تعطيل عرض GPU، وهو أمر غير ضروري ويشكل مشكلة في بعض الأحيان في وضع مقطوعة الرأس. وفي الوقت نفسه، يتيح خيار "-remote-debugging-port" لمتصفح Chrome فتح منفذ تصحيح الأخطاء الضروري لاتصال السيلينيوم به في CI. باختصار، يمنع هذا الإعداد اختناقات الأتمتة الشائعة، مما يتيح بيئة اختبار أكثر موثوقية وقوة. ونتيجة لذلك، فإن هذه البرامج النصية تجعل تشغيل Chrome بدون تشغيل على أنظمة CI/CD تجربة أكثر سلاسة، مما يضمن تشغيل الاختبارات التلقائية بشكل متسق دون حدوث عوائق 🚀.

sudo apt-get update
sudo apt-get install -y wget apt-transport-https curl
CHROME_VERSION="117.0.5938.62"
CHROME_DEB="google-chrome-stable_${CHROME_VERSION}-1_amd64.deb"
wget https://mirror.cs.uchicago.edu/google-chrome/pool/main/g/google-chrome-stable/$CHROME_DEB
sudo dpkg -i $CHROME_DEB || sudo apt-get install -f -y
# Install ChromeDriver matching Chrome
sudo apt-get install -y wget unzip
MAJOR_VERSION=$(echo $CHROME_VERSION | cut -d '.' -f1)
LATEST_DRIVER=$(wget -qO- https://chromedriver.storage.googleapis.com/LATEST_RELEASE_$MAJOR_VERSION)
if [ -z "$LATEST_DRIVER" ]; then
  echo "Falling back to latest ChromeDriver version."
  LATEST_DRIVER=$(wget -qO- https://chromedriver.storage.googleapis.com/LATEST_RELEASE)
fi
sudo rm -f /usr/local/bin/chromedriver
wget https://chromedriver.storage.googleapis.com/$LATEST_DRIVER/chromedriver_linux64.zip
unzip chromedriver_linux64.zip
sudo mv chromedriver /usr/local/bin/
sudo chmod +x /usr/local/bin/chromedriver

// Import necessary libraries
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import io.github.bonigarcia.wdm.WebDriverManager;
// Set up ChromeDriver
WebDriverManager.chromedriver().setup();
ChromeOptions options = new ChromeOptions();
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");
options.addArguments("--headless");
options.addArguments("--disable-gpu");
options.addArguments("--remote-debugging-port=9222");
ChromeDriver driver = new ChromeDriver(options);
// Start Selenium test logic here
driver.quit();

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
class WebDriverTests {
  private WebDriver driver;
  @BeforeEach
  void setUp() {
    ChromeOptions options = new ChromeOptions();
    options.addArguments("--headless");
    options.addArguments("--no-sandbox");
    driver = new ChromeDriver(options);
  }
  @Test
  void testDriverInitialization() {
    driver.get("https://www.google.com");
    assertEquals("Google", driver.getTitle());
  }
  @AfterEach
  void tearDown() {
    driver.quit();
  }
}

تحسين اختبارات السيلينيوم باستخدام إجراءات GitHub وChrome مقطوعة الرأس

جانب واحد مهم من الجري كروم مقطوعة الرأس مع السيلينيوم في خطوط أنابيب CI/CD مثل GitHub Actions هو فهم القيود البيئية. إن تشغيل Chrome في وضع مقطوعة الرأس يعني أنه يعمل بدون واجهة رسومية، مما يجعله مثاليًا لبيئات CI. ومع ذلك، يمكن أن يكون Chrome بدون رأس أكثر حساسية لتكوينات النظام ويتطلب إعدادًا إضافيًا مقارنة بالبيئة المحلية. عادةً ما يرتبط الخطأ "ملف DevToolsActivePort غير موجود" بفشل في تهيئة Chrome، وغالبًا ما يكون ذلك بسبب قيود الذاكرة أو عدم تطابق التكوين. تنفيذ تكوينات موفرة للذاكرة مثل --disable-dev-shm-usage و --لا يوجد رمل يساعد في التغلب على هذه المشكلات ويمكنه تثبيت الاختبارات بشكل كبير في بيئات CI/CD ذات الذاكرة المحدودة.

لضمان التوافق، من الضروري الحفاظ على توافق إصداري Chrome وChromeDriver. تعد الإصدارات غير المتسقة مصدرًا متكررًا للأخطاء في إجراءات GitHub، حيث قد يستخدم المُشغل الإصدار الأحدث افتراضيًا، والذي قد لا يتطابق مع متطلبات ChromeDriver. لمعالجة هذه المشكلة، يتضمن الحل الذي نقدمه تحليل إصدار Chrome الرئيسي لجلب إصدار ChromeDriver الدقيق الذي يتوافق معه، مما يؤدي إلى تحسين الاستقرار. بالإضافة إلى ذلك، الإعداد منفذ التصحيح عن بعد يسمح لـ ChromeDriver بالتفاعل مع المتصفح بشكل أكثر موثوقية من خلال تمكين منفذ الاتصال. يعد هذا الإعداد ضروريًا عند استخدام GitHub Actions أو الأدوات المشابهة للتشغيل الآلي اختبارات المتصفح على الجهاز الظاهري.

تُحدث هذه التكوينات فرقًا كبيرًا في الكفاءة، مما يقلل الأخطاء ويحسن موثوقية عمليات التشغيل الاختبارية. من خلال ضمان خيارات موفرة للموارد واستخدام الإصدارات الصحيحة، من المرجح أن يتم تنفيذ عمليات تشغيل Chrome بدون مراقبة بنجاح، مما يوفر على المطورين من التعامل مع الأخطاء المحبطة في منتصف الاختبار. في النهاية، تعمل التكوينات القوية والتبعيات المتوافقة على جعل تجربة اختبار CI/CD أكثر سلاسة، مما يمكّن المطورين من التركيز على إنشاء تطبيقاتهم وتحسينها دون تعطيل مشكلات الإعداد المستمرة 🚀.