A place to start

Author: jan-molak

.github/funding.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [ serenity-js ]

.github/workflows/main.yaml

@@ -0,0 +1,68 @@
+name: Main
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+    types: [ opened, synchronize ]
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build-test-publish:
+    name: "Build -> Test -> Publish"
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Set up Docker BuildX
+        uses: docker/setup-buildx-action@v3.11.1
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3.6.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Playwright version
+        id: playwright_version
+        run: |
+          version=$(node -p "require('./playwright-installer/package.json').dependencies['@playwright/test']")
+          echo "version=$version" >> $GITHUB_OUTPUT
+
+      - name: Get Ubuntu distro codename from Dockerfile
+        id: distro
+        run: |
+          from_line=$(grep '^FROM' Dockerfile)
+          # Extract the tag part after 'ubuntu:' and before '@' or end of line
+          distro=$(echo "$from_line" | sed -n 's/^FROM ubuntu:\([^@]*\).*/\1/p')
+          # Fallback to default if not found
+          distro=${distro:-noble}
+          echo "distro=$distro" >> $GITHUB_OUTPUT
+
+      - name: Set image tag
+        id: tag
+        run: |
+          tag="v${{ steps.playwright_version.outputs.version }}-${{ steps.distro.outputs.distro }}"
+          echo "tag=$tag" >> $GITHUB_OUTPUT
+
+      - name: Build image
+        id: build
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          push: false
+          tags: serenity-js:latest
+
+      - name: Test image
+        run: |
+          docker run --rm serenity-js:latest whoami
+          docker run --rm serenity-js:latest node --version
+          docker run --rm serenity-js:latest java --version
+          docker run --rm serenity-js:latest google-chrome --version
+          docker run --rm serenity-js:latest microsoft-edge --version

.gitignore

@@ -0,0 +1,4 @@
+.idea
+
+# Playwright Installer
+playwright-installer/node_modules/

Dockerfile

@@ -0,0 +1,60 @@
+FROM ubuntu:noble@sha256:728785b59223d755e3e5c5af178fab1be7031f3522c5ccd7a0b32b80d8248123
+
+ARG USERNAME=serenity-js
+
+ARG DEBIAN_FRONTEND=noninteractive
+ARG TZ=UTC
+
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
+ENV PLAYWRIGHT_BROWSERS_PATH=/opt/playwright
+
+## OS Layer
+
+RUN \
+    apt-get -y update && \
+    apt-get -y upgrade && \
+### Install certificate tools
+    apt-get install -y ca-certificates curl gpg libnss3-tools p11-kit && \
+    update-ca-certificates && \
+### Update sources
+    mkdir -p /etc/apt/keyrings && \
+    curl -sL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg && \
+    echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_24.x nodistro main" >> /etc/apt/sources.list.d/nodesource.list && \
+    curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg && \
+    echo "deb [signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/edge stable main" > /etc/apt/sources.list.d/microsoft-edge.list && \
+    curl -sL https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor -o /etc/apt/keyrings/google-chrome.gpg && \
+    echo "deb [signed-by=/etc/apt/keyrings/google-chrome.gpg] https://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list && \
+    apt-get -y update && \
+### Install Node.js
+    apt-get install -y default-jre google-chrome-stable microsoft-edge-stable nodejs && \
+### Feature-parity with node.js base images.
+    apt-get install -y --no-install-recommends git openssh-client && \
+### Clean up
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*;
+
+## Application Layer
+
+COPY playwright-installer /tmp/playwright-installer/
+
+RUN \
+### Install Playwright
+    mkdir "$PLAYWRIGHT_BROWSERS_PATH" && \
+    cd /tmp/playwright-installer/ && \
+    npm ci  && \
+    npm exec --no -- playwright install --with-deps && \
+    cd - && \
+    chmod -R 755 "$PLAYWRIGHT_BROWSERS_PATH"  && \
+### Clean up
+    rm -rf /tmp/* && \
+    npm cache clean --force > /dev/null 2>&1 && \
+    rm -rf "$HOME/.npm/" && \
+### Add user
+    adduser "$USERNAME" && \
+### Set permissions
+    chown -R "$USERNAME":"$USERNAME" "$PLAYWRIGHT_BROWSERS_PATH";
+
+USER $USERNAME
+WORKDIR /home/$USERNAME

playwright-installer/package-lock.json

@@ -0,0 +1,16 @@
+{
+  "name": "playwright-installer",
+  "description": "Playwright installer for Serenity/JS",
+  "version": "1.0.0",
+  "private": true,
+  "author": {
+    "name": "Jan Molak",
+    "email": "jan.molak@smartcodeltd.co.uk",
+    "url": "https://janmolak.com"
+  },
+  "homepage": "https://serenity-js.org",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@playwright/test": "1.56.1"
+  }
+}