aloknecessary/puppeteer-az-cli repository overview

⁠Puppeteer CI Docker Image

A CI-optimized Docker image for running Puppeteer-based UI automation with zero setup time during CI runs.

This image is intended for containerized CI environments such as:

• GitHub Actions self-hosted runners
• Kubernetes / AKS runner pods
• Docker Compose–based runners

The workflow is intentionally simple and deterministic:

⁠What’s Included

• Node.js 20 (Debian bookworm-slim)
• Puppeteer 24.32.1 (pinned)
• System-installed Chromium
• Azure CLI (for uploading reports to Azure Blob Storage)
• Required Chromium runtime libraries
• Hardened for container-based execution

⁠Design Approach

This image intentionally does not download Chromium via Puppeteer.

Instead:

• Chromium is installed at the OS level
• Puppeteer is configured to reuse the system browser

This approach provides:

• Faster CI startup times
• Predictable and reproducible builds
• Improved stability in containerized environments

Runtime configuration baked into the image:

PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
CI=true

⁠Azure CLI Support

Azure CLI is preinstalled to support workflows such as:

• Authenticating using a service principal
• Uploading HTML test reports to Azure Blob Storage

This enables publishing test artifacts externally without relying on CI-native artifact storage.

⁠🏗️ Image Tags

• Versioned tags (e.g. 1.0.0)
• latest – points to the most recent stable release

Each tag is published as a multi-architecture manifest, so Docker automatically pulls the correct image for your platform. Also, I am keeping a version match against playwright image to avoid any confusion. You may notice a minor version difference bcz of maintenance.

⁠📦 Source & Maintenance

• Source repository: https://github.com/aloknecessary/puppeteer-az-cli⁠

• Built and maintained by aloknecessary