Merge branch 'master' into chore/add_internal_20_18_1_image

Author: AtofStryker

.github/workflows/example-tests.yml

@@ -0,0 +1,28 @@
+name: Example Tests
+# This workflow tests examples from the examples directory of this repo.
+
+on:
+  push:
+    paths:
+      - examples/**
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  example:
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        directory: [
+          basic-mini,
+          basic,
+          chromium,
+          firefox-esr,
+          included-as-non-root
+          ]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run test script
+        working-directory: examples/${{ matrix.directory }}
+        run: ./scripts/test.sh

README.md

@@ -157,6 +157,34 @@ container:
 
 See [Tag Selection](#tag-selection) above for advice on selecting a non-default image tag.
 
+## EACCES permission denied binary_state.json
+
+### Problem
+
+If a custom Docker image is built from a `cypress/base` or `cypress/browsers` Cypress Docker image, using a `Dockerfile` to install the Cypress binary (for instance with `npx cypress install`), and the custom image is then run as a container with a non-root user, Cypress will fail to run with an error message:
+
+> Error: EACCES: permission denied, open '/root/.cache/Cypress/`<Cypress version>`/binary_state.json'
+
+This is due to an open Cypress issue [#30684](https://github.com/cypress-io/cypress/issues/30684) where Cypress fails to verify the installed Cypress binary if it does not have write access to the Cypress binary directory.
+
+### Workaround
+
+To workaround this issue, either make the Cypress binary directory writable, or skip the Cypress binary verification.
+
+To make the complete Cypress binary directory writable, add the following to the `Dockerfile` after the step to install the Cypress binary:
+
+```Dockerfile
+RUN chmod -R 777 /root/.cache/Cypress
+```
+
+To skip Cypress binary verification using the environment variable `CYPRESS_SKIP_VERIFY`, described in the Cypress documentation [Advanced Installation](https://docs.cypress.io/app/references/advanced-installation#Environment-variables), either add the following to the `Dockerfile`:
+
+```Dockerfile
+ENV CYPRESS_SKIP_VERIFY=true
+```
+
+or pass the environment variable as an additional CLI option `--env CYPRESS_SKIP_VERIFY=true` to the [docker run](https://docs.docker.com/reference/cli/docker/container/run/) command.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)

examples/basic-mini/scripts/test.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -e # fail on error
+#
+# Run in examples/basic-mini directory
+# (amd64 only)
+#
+echo Test base-mini with cypress/included in Chrome
+docker run --rm -v .:/app -w /app --entrypoint cypress cypress/included run -b chrome