Sign inSign up
browser-e2e logo

lzocateli/browser-e2e

By lzocateli

•Updated 8 days ago

Image
0

149

lzocateli/browser-e2e repository overview

⁠browser-e2e

Docker Hub Version Base Platforms Repository code license Build

Executa testes E2E em Node.js 24 LTS: Playwright com Chrome, Edge e Brave estáveis, e Selenium com geckodriver para Firefox ESR e estável. A imagem cobre também testes de extensões de navegador; no Firefox, isso é feito pelo comando webExtension.install do WebDriver BiDi. Em relação a lzocateli/playwright-e2e (Python), usa Node.js e inclui navegadores de marca e o Firefox ESR.

⁠Referência da imagem

ItemValor
Imagemlzocateli/browser-e2e:1.65.0-v1
Imagem baselzocateli/node:24.22.1-bookworm-v1 (fixada por digest)
Plataformaslinux/amd64
Usuário padrãonode (1000:1000)
Entry pointnenhum; CMD ["playwright", "--version"]
Diretório de trabalho/workspace
Código-fontehttps://github.com/lzocateli/containers/tree/main/browser-e2e
Documentaçãohttps://github.com/lzocateli/containers/tree/main/browser-e2e

⁠Conteúdo e finalidade

⁠Incluído
  • Node.js 24.22.1 (LTS), da imagem base.
  • playwright e @playwright/test 1.65.0, instalados globalmente.
  • Chromium do Playwright (Chrome for Testing), além de Google Chrome e Microsoft Edge estáveis, instalados pelo Playwright.
  • Brave estável, do repositório oficial da Brave.
  • Firefox estável e Firefox ESR, do repositório oficial da Mozilla.
  • selenium-webdriver 4.52.0 e geckodriver 0.37.1 (com SHA-256 verificado).
  • xvfb, para extensões que exigem modo com interface.
⁠Não incluído
  • Os testes do projeto consumidor, que são montados em /workspace.
  • WebKit do Playwright.
  • linux/arm64, porque o Edge não é distribuído para essa arquitetura no Linux.

⁠Início rápido

docker pull lzocateli/browser-e2e:1.65.0-v1
docker run --rm lzocateli/browser-e2e:1.65.0-v1

Rodar a suíte Playwright do projeto:

docker run --rm --ipc=host \
  --volume "$PWD:/workspace" \
  lzocateli/browser-e2e:1.65.0-v1 \
  npx playwright test

⁠Docker Compose

services:
  e2e:
    image: lzocateli/browser-e2e:1.65.0-v1
    ipc: host
    working_dir: /workspace
    volumes:
      - ./frontend:/workspace
    command: ["npx", "playwright", "test"]

⁠Testes de extensão

Resultado verificado pelo smoke test (scripts/probe-extensions.mjs), que carrega uma extensão MV3 por --load-extension:

NavegadorCarrega extensão por linha de comandoUso recomendado
Chromium (Chrome for Testing)SimExtensões em Playwright (channel: "chromium")
Microsoft EdgeSimExtensões em Playwright (channel: "msedge")
BraveSimExtensões em Playwright (executablePath: process.env.BRAVE_EXECUTABLE)
Google Chrome estávelNão, desde a versão 137Páginas comuns; extensões só por outra via, como o WebDriver BiDi
Firefox estável e ESRNão se aplicaExtensões via Selenium e webExtension.install do WebDriver BiDi

⁠Configuração

⁠Variáveis de ambiente
VariávelObrigatóriaSecretaPadrãoDescrição
PLAYWRIGHT_BROWSERS_PATHNãoNão/ms-playwrightNavegadores e dependências do Playwright.
BRAVE_EXECUTABLENãoNão/usr/bin/brave-browserUse em executablePath do Playwright.
FIREFOX_EXECUTABLENãoNão/usr/bin/firefoxFirefox estável para o Selenium.
FIREFOX_ESR_EXECUTABLENãoNão/usr/bin/firefox-esrFirefox ESR para o Selenium.
NODE_PATHNãoNão/usr/local/lib/node_modulesPermite require dos pacotes globais.
⁠Portas

A imagem não expõe portas.

⁠Persistência e mounts
Caminho no contêinerModoConteúdoBackup necessário
/workspacerwTestes, relatórios e tracesNão
⁠Secrets

Credenciais de teste devem vir de variáveis injetadas pelo CI ou do arquivo de secrets externo do projeto. Não versione nem copie esses valores para a imagem.

⁠Inicialização e ciclo de vida

Cada execução roda a suíte indicada e termina com o código de saída dela. Não há health check.

⁠Segurança

  • Executa como usuário não root node.
  • Use --ipc=host (ou --shm-size=1g) para o Chrome; não use --privileged.
  • Os repositórios de pacotes de Brave e Mozilla são verificados pelas chaves oficiais.
  • Os navegadores estáveis são instalados no momento do build; a versão exata fica registrada na saída do smoke test, e cada rebuild gera uma nova tag vN.

⁠Build local

docker build \
  --pull \
  --tag lzocateli/browser-e2e:1.65.0-v1 \
  browser-e2e

⁠Tags e compatibilidade

TagMutabilidadeCompatibilidadeUso recomendado
1.65.0-v1ImutávelPlaywright 1.65.0, Selenium 4.52.0, geckodriver 0.37.1CI e E2E

Uma troca de versão do Playwright gera nova tag. Um rebuild com navegadores mais novos sobre o mesmo Playwright incrementa vN.

⁠Validação

Antes da publicação, confirme:

  • .gitignore e .dockerignore presentes;
  • análise do Dockerfile com BuildKit;
  • bash browser-e2e/scripts/smoke-test.sh --image <ref>, que verifica o usuário não root, a presença das versões, o Firefox ESR e o geckodriver, a abertura de Chrome, Edge e Brave pelo Playwright e o carregamento de uma extensão MV3 no Chromium, no Edge e no Brave;
  • inspeção de vulnerabilidades com tools/scripts/scan-container-vulnerabilities.ps1 -ContextPath browser-e2e;
  • SBOM e proveniência na publicação.

⁠Publicação

Use Actions > Publicar imagem de container > Run workflow e informe:

  • context_path: browser-e2e;
  • image_name: browser-e2e;
  • image_tag: 1.65.0-v1;
  • dockerfile: Dockerfile;
  • platforms: linux/amd64.

⁠Operação

Reconstrua periodicamente para receber correções de segurança dos navegadores, gerando nova tag vN.

⁠Troubleshooting

SintomaCausa provávelVerificaçãoCorreção
Chrome fecha ao iniciar/dev/shm pequenoLogs do PlaywrightUse --ipc=host ou --shm-size=1g
Extensão não carrega no ChromeO Chrome de marca ignora --load-extension desde a versão 137node scripts/probe-extensions.mjs --extension <dir>Use channel: "chromium" (Chrome for Testing) ou Edge
Selenium não encontra o FirefoxBinário não informadoecho $FIREFOX_ESR_EXECUTABLEDefina binary nas opções do Firefox

⁠Limitações conhecidas

  • Somente linux/amd64.
  • O suporte do Playwright ao Brave não é oficial; a imagem só fornece o binário.

⁠Licenças e fontes

ComponenteVersãoLicençaFonte
Conteúdo original deste repositórioAtualMIThttps://github.com/lzocateli/containers
Imagem base lzocateli/node24.22.1-bookworm-v1MIT e licenças upstreamhttps://github.com/lzocateli/containers/tree/main/node
Playwright1.65.0Apache-2.0https://github.com/microsoft/playwright
Chromium (Chrome for Testing)da versão do PlaywrightBSD-3-Clause e licenças do Chromiumhttps://googlechromelabs.github.io/chrome-for-testing/
selenium-webdriver4.52.0Apache-2.0https://github.com/SeleniumHQ/selenium
geckodriver0.37.1MPL-2.0https://github.com/mozilla/geckodriver
Firefox e Firefox ESRestável e ESR no buildMPL-2.0https://www.mozilla.org/firefox/
Google Chromeestável no buildTermos de serviço do Google Chromehttps://www.google.com/chrome/
Microsoft Edgeestável no buildTermos de licença do Microsoft Edgehttps://www.microsoft.com/edge
Braveestável no buildMPL-2.0https://brave.com

O badge MIT descreve somente o conteúdo original deste repositório. A imagem inclui componentes de terceiros que permanecem sujeitos aos termos e avisos de suas fontes. Chrome e Edge são distribuídos sob termos próprios dos fabricantes. Use esta imagem apenas para testes, sem redistribuir os navegadores separadamente. Consulte a política de licenciamento⁠, preserve as atribuições upstream e verifique também os avisos distribuídos dentro da imagem.

⁠Histórico de alterações

  • 1.65.0-v1: primeira versão.

Tag summary

Content type

Image

Digest

sha256:2ecd9e970…

Size

1.8 GB

Last updated

8 days ago

docker pull lzocateli/browser-e2e:1.65.0-v1