Run tests on GitHub Action (#3)

.github/workflows/docker-tests.yml

@@ -1,5 +1,4 @@
 name: Run Docker Tests and Upload Results
-
 on:
   workflow_dispatch:
     inputs:
@@ -17,7 +16,7 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v2
-
+        
       - name: Set up Docker
         uses: docker/setup-buildx-action@v1
 

README.md

@@ -1,5 +1,6 @@
 # purple-a11y-tests
-#### [Cypress](https://www.cypress.io/) functional tests for [Purple A11y](https://github.com/govtechsg/purple-a11y) to verify the correctness of Purple A11y CLI and integration module.
+
+[Cypress](https://www.cypress.io/) functional tests for [Purple A11y](https://github.com/govtechsg/purple-a11y) to verify the correctness of Purple A11y CLI and integration module.
 
 ## Run Locally
 #### Step 1: 
@@ -51,6 +52,13 @@ shell_scripts/stop_docker.sh
 colima stop
 ```
 
-## Limitations
- - Docker can only run chromium in headless mode, using chrome and edge for Purple A11y will not be tested
+## Run on GitHub Actions
+Test changes to tests by triggering Actions to run the test on any branch of `tests` or `purple-a11y`.
 
+- Go to [Actions](https://github.com/GovTechSG/purple-a11y-tests/actions/workflows/docker-tests.yml) tab.
+- Select `Run workflow` and choose the branch under `Use workflow from` to change the tests branch.
+- Optionally, the different git+URL of Purple A11y to change the branch of Purple A11y in `Checkout a specific purple a11y branch`.
+
+## Limitations
+ - Docker can only run Chromium in headless mode or through Xvfb (`xvfb-run`).
+ - The tests will not run successfully on Chrome or Edge in Docker.

shell_scripts/host_websites_and_run_cypress.sh

@@ -6,7 +6,7 @@
 cd ./www
 
 # Run Python HTTP server in the www directory
-python3 http_server_auth.py --bind 0.0.0.0 --port 8000 &
+python3 http_server_auth.py --bind 0.0.0.0 --port 8000 > /dev/null 2>&1 &
 
 # Save the PID of the background process
 python_pid=$!
@@ -34,6 +34,9 @@ cd node_modules/@govtechsg/purple-hats && \
     npm run build || true && \
     cd ../../../
 
+# npm run build tests repo
+npm run build
+
 echo "Starting Cypress tests..."
 
 # Create exports directory

shell_scripts/start_docker.sh

@@ -7,7 +7,7 @@ fi
 docker build -t purple-a11y-tests .
 
 # Add hostname mappings and run the container
-docker run -dit --name purple-a11y-tests-instance --add-host=main.purplea11y.local:0.0.0.0 --add-host=diffHostname.purplea11y.local:0.0.0.0 purple-a11y-tests
+docker run -dit --name purple-a11y-tests-instance --add-host=main.purplea11y.local:0.0.0.0 --add-host=diffHostname.purplea11y.local:0.0.0.0 --add-host=docs.google.com:0.0.0.0 purple-a11y-tests
 
 # Copy the Cypress tests into the docker container
 if [[ "$(uname)" == "Darwin" ]]; then