Використання Chrome для виправлення помилки файлу DevToolsActivePort у Selenium на GitHub Actions

Подолання помилок тестування Chrome у конвеєрах CI/CD

Виконання тестів Selenium у безголовий Chrome на Дії GitHub має бути безшовним. Проте багато розробників стикаються з неприємною помилкою «Файл DevToolsActivePort не існує». Це трапляється, коли Chrome з тих чи інших причин не запускається належним чином у середовищі CI.

Повідомлення про помилку зазвичай означає, що Chrome несподівано аварійно завершує роботу, що часто є результатом невідповідності Chrome і ChromeDriver версії або неправильно налаштовані параметри в налаштуваннях тестування. Як і багато розробників, я зіткнувся з цією проблемою, особливо під час розгортання автоматизованих тестів у безперервна інтеграція середовище.

У цьому налаштуванні найменша неузгодженість, як-от невідповідність версії драйвера ChromeDriver, може призупинити виконання тесту, втрачаючи дорогоцінний час і ресурси. На щастя, розуміння глибинних проблем значно полегшує їх вирішення 🛠️.

У цьому посібнику ми зануримося в практичні кроки для запобігання та усунення цієї поширеної помилки. Від особливостей встановлення Chrome до правильної ініціалізації драйвера, ви знайдете покроковий процес, щоб забезпечити плавне тестування кожного разу. Давайте розберемося з цією проблемою та повернемо ваші тести на правильний шлях!

Детальне рішення для Chrome і налаштування драйвера Chrome у CI

Наведені вище сценарії призначені для встановлення та налаштування Chrome і ChromeDriver Дії GitHub середовищ, зокрема усунення помилки «Файл 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» вимикає візуалізацію графічного процесора, що є непотрібним і іноді проблематичним у безголовому режимі. Тим часом параметр «--remote-debugging-port» дозволяє Chrome відкрити порт налагодження, необхідний Selenium для підключення до нього в 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();
  }
}

Оптимізація тестів Selenium за допомогою GitHub Actions і Headless Chrome

Один важливий аспект бігу безголовий Chrome з Selenium у конвеєрах CI/CD, таких як GitHub Actions, це розуміння обмежень навколишнього середовища. Запуск Chrome у безголовому режимі означає, що він працює без графічного інтерфейсу, що робить його ідеальним для середовища CI. Однак безголовий Chrome може бути більш чутливим до конфігурацій системи та потребує додаткового налаштування порівняно з локальним середовищем. Помилка «Файл DevToolsActivePort не існує» зазвичай пов’язана зі збоєм ініціалізації Chrome, часто через обмеження пам’яті або невідповідність конфігурації. Реалізація конфігурацій з ефективним використанням пам’яті, наприклад --disable-dev-shm-usage і --без пісочниці допомагає подолати ці проблеми та може значно стабілізувати тести в середовищах CI/CD з обмеженою пам’яттю.

Щоб забезпечити сумісність, важливо підтримувати узгодженість версій Chrome і ChromeDriver. Неузгоджені версії є частим джерелом помилок у GitHub Actions, оскільки програма запуску може за умовчанням використовувати останню версію, яка може не відповідати вимогам ChromeDriver. Щоб вирішити цю проблему, наше рішення включає аналіз основної версії Chrome для отримання точної відповідної версії ChromeDriver, покращуючи стабільність. Додатково налаштування порт віддаленого налагодження дозволяє ChromeDriver надійніше взаємодіяти з браузером, увімкнувши комунікаційний порт. Це налаштування є необхідним під час використання GitHub Actions або подібних інструментів для автоматизованого запуску тести браузера на віртуальній машині.

Ці конфігурації значно покращують ефективність, зменшують кількість помилок і підвищують надійність тестових прогонів. Завдяки ресурсозберігаючим параметрам і використанню правильних версій безконтрольні запуски Chrome мають набагато більше шансів на успішне виконання, позбавляючи розробників від неприємних помилок під час тестування. Зрештою, надійні конфігурації та сумісні залежності роблять процес тестування CI/CD більш плавним, дозволяючи розробникам зосередитися на створенні та вдосконаленні своїх програм без переривання постійних проблем із налаштуванням 🚀.