Použití Chromu k opravě chyby souboru DevToolsActivePort v Selenium na akcích GitHubu

Překonání selhání testu Chrome v kanálech CI/CD

Spuštění testů selenu bezhlavý Chrome na Akce GitHubu by měla být bezproblémová. Přesto se mnoho vývojářů potýká s frustrující chybou „Soubor DevToolsActivePort neexistuje“. K tomu dochází, když se Chrome z toho či onoho důvodu nespustí správně v prostředí CI.

Chybová zpráva obvykle signalizuje, že Chrome neočekávaně padá, což je často způsobeno neshodou Chrome a ChromeDriver verze nebo nesprávně nakonfigurované možnosti v nastavení testu. Jako mnoho vývojářů jsem se s touto výzvou setkal, zejména při nasazování automatických testů v a kontinuální integrace prostředí.

V tomto nastavení může sebemenší nesoulad, jako je nesoulad verze ovladače ChromeDriver, zastavit provádění testu, což stojí drahocenný čas a zdroje. Naštěstí pochopení základních problémů je mnohem snazší 🛠️.

V této příručce se ponoříme do praktických kroků, jak této běžné chybě předejít a odstranit ji. Od specifikací instalace Chromu až po správnou inicializaci ovladače najdete postup krok za krokem, který pokaždé zajistí hladký průběh testování. Pojďme se s tímto problémem vypořádat a vraťte své testy do správných kolejí!

Podrobné řešení pro nastavení Chrome a ChromeDriver v CI

Výše uvedené skripty jsou navrženy k instalaci a konfiguraci Chrome i ChromeDriver Akce GitHubu prostředí, konkrétně řeší chybu „Soubor DevToolsActivePort neexistuje“. K tomuto problému obvykle dochází, když Chrome běžící v bezhlavém režimu nemůže správně spustit kvůli neshodám nebo omezením paměti. První skript to řeší tak, že specifikuje verzi Chrome a zajišťuje její kompatibilitu s ChromeDriver, což je klíčové pro spuštění Selen testy. Počáteční příkazy provádějí aktualizaci balíčků apt a používají wget k načtení konkrétní verze Google Chrome ze zrcadla. Použití zrcadlení zajišťuje, že je nainstalována správná verze, zejména pokud výchozí úložiště tuto verzi postrádá. Tento přístup zaručuje, že se v různých testovacích běhech používá konzistentní verze prohlížeče Chrome.

Dále skript nainstaluje ChromeDriver kompatibilní s verzí tak, že izoluje hlavní verzi od Chromu (např. „117“ od „117.0.5938.62“) pomocí příkazu k její analýze. To skriptu umožňuje načíst přesný ChromeDriver potřebný pro danou konkrétní hlavní verzi pomocí vzoru adresy URL navrženého pro vydání ChromeDriver. Tím, že se ujistíte, že jsou tyto verze zarovnané, nastavení zabrání tomu, aby neshodné verze způsobily selhání inicializace ChromeDriver, což často způsobuje chybu DevTools. Pokud se aplikaci ChromeDriver nepodaří stáhnout konkrétní verzi, skript obsahuje záložní možnost stažení nejnovější verze, přičemž je zachována flexibilita. Tyto kroky jsou užitečné zejména v automatizovaných CI/CD potrubích, kde jsou prioritou rychlá a spolehlivá řešení 🔧.

Po stažení skript odstraní ze systému všechny dříve nainstalované ovladače ChromeDriver pomocí příkazu „sudo rm -f“, aby se předešlo konfliktům se staršími ovladači. To zajišťuje, že je na místě pouze správná verze, čímž se minimalizuje riziko konfliktů verzí, které mohou narušit stabilitu testu. Oprávnění pro ChromeDriver jsou také nastavena jako spustitelná, což je nezbytný krok pro spuštění ovladače v prostředí CI/CD. Používání Chromu v „bezhlavém“ režimu s možnostmi jako „--no-sandbox“ a „--disable-dev-shm-usage“ také snižuje nároky na zdroje Chrome. Tyto možnosti umožňují spouštět testy v prostředích s omezenými prostředky (např. cloudové servery nebo kanály CI), aniž by došlo k selhání prohlížeče Chrome, což je jedna z běžných příčin chyby DevToolsActivePort.

A konečně, v nastavení WebDriver možnosti jako „--disable-gpu“ a „--remote-debugging-port=9222“ zajišťují stabilnější běh Chrome v bezhlavém režimu. Příznak „--disable-gpu“ zakáže vykreslování GPU, což je v bezhlavém režimu zbytečné a někdy problematické. Mezitím možnost „--remote-debugging-port“ umožňuje Chromu otevřít ladicí port nezbytný pro připojení Selenium k němu v CI. Stručně řečeno, toto nastavení zabraňuje běžným úzkým místům automatizace a umožňuje spolehlivější a robustnější testovací prostředí. Výsledkem je, že díky těmto skriptům je spouštění bezhlavého Chrome na systémech CI/CD mnohem plynulejší a zajišťuje konzistentní běh automatických testů bez škytání 🚀.

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();
  }
}

Optimalizace testů selenu pomocí GitHub Actions a Headless Chrome

Jeden důležitý aspekt běhu bezhlavý Chrome se selenem v kanálech CI/CD, jako je GitHub Actions, rozumí omezením životního prostředí. Spuštění Chromu v bezhlavém režimu znamená, že funguje bez grafického rozhraní, takže je ideální pro prostředí CI. Bezhlavý Chrome však může být citlivější na systémové konfigurace a vyžaduje dodatečné nastavení ve srovnání s místním prostředím. Chyba „Soubor DevToolsActivePort neexistuje“ je běžně spojena se selháním inicializace prohlížeče Chrome, často kvůli omezení paměti nebo nesouladu konfigurace. Implementace paměťově efektivních konfigurací, jako je --disable-dev-shm-usage a --žádné pískoviště pomáhá překonat tyto problémy a může významně stabilizovat testy v prostředích CI/CD s omezenou pamětí.

Aby byla zajištěna kompatibilita, je nezbytné udržovat obě verze Chrome a ChromeDriver zarovnané. Nekonzistentní verze jsou častým zdrojem chyb v akcích GitHub, protože běžec může ve výchozím nastavení používat nejnovější verzi, která nemusí odpovídat požadavkům ChromeDriver. Abychom tento problém vyřešili, naše řešení zahrnuje analýzu hlavní verze prohlížeče Chrome, aby bylo možné načíst přesnou verzi ovladače ChromeDriver, která odpovídá, a zlepšit tak stabilitu. Navíc nastavení port pro vzdálené ladění umožňuje ovladači ChromeDriver spolehlivěji komunikovat s prohlížečem povolením komunikačního portu. Toto nastavení je nezbytné, když používáte GitHub Actions nebo podobné nástroje pro automatické spouštění testy prohlížeče na virtuálním stroji.

Tyto konfigurace mají velký rozdíl v účinnosti, snižují chybovost a zlepšují spolehlivost testovacích běhů. Zajištěním možností efektivních z hlediska zdrojů a používáním správných verzí je mnohem pravděpodobnější, že se bezhlavé běhy Chromu úspěšně spustí, což vývojářům ušetří práci s frustrujícími chybami uprostřed testování. V konečném důsledku robustní konfigurace a kompatibilní závislosti usnadňují testování CI/CD a umožňují vývojářům soustředit se na vytváření a vylepšování svých aplikací, aniž by to narušilo přetrvávající problémy s nastavením 🚀.