Merge branch 'feature/test-new-features-for-pipeline' into 'main'

Extend test coverage by using also other node images

See merge request belle2/software/display!13

Author: GiacomoXT

.gitlab-ci.yml

@@ -3,29 +3,31 @@ stages:
   - build
   - documentation
 
-image:
-  node:20
-
 workflow:
   rules:
     - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
     - if: $CI_PIPELINE_SOURCE == 'push' && $CI_COMMIT_BRANCH == 'main'
 
-before_script:
-  # Check for updates and install build-essential
-  - apt-get update -y
-  - apt-get upgrade -y
-  - apt-get install -y build-essential
-  # Print the exact versions of node and npm
-  - node --version
-  - npm --version
+default:
+  image: node:20
+  interruptible: true  # All the jobs can be interrupted by newer pipelines
+  before_script:
+    # Check for updates and install build-essential
+    - apt-get update -y
+    - apt-get upgrade -y
+    - apt-get install -y build-essential
+    # Print the exact versions of node and npm
+    - node --version
+    - npm --version
 
 formatting:
   stage: formatting
   rules:
     # Run this stage only during pipelines associated to merge requests
     - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
   script:
+    # Start the job
+    - echo "Running job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\"..."
     # Install angular
     - npm install -g @angular/[email protected]
     # Install the dependencies
@@ -42,20 +44,27 @@ formatting:
           echo "Run locally \`npm run prettier\` and commit the formatted files."
           exit 1
       fi
-    # Stage successfully completed
-    - echo "${CI_JOB_STAGE} stage successfully completed"
+    # Job successfully completed
+    - echo "Successfully completed job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\""
 
 build:
   stage: build
+  # Run this job using multiple node images
+  image: $IMAGE
+  parallel:
+    matrix:
+      - IMAGE: ['node:16', 'node:18', 'node:20']  # All the images we want to use
   script:
+    # Start the job
+    - echo "Running job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\"..."
     # Install angular
     - npm install -g @angular/[email protected]
     # Install the dependencies
     - npm ci
     # Build the application
     - npm run build
-    # Stage successfully completed
-    - echo "${CI_JOB_STAGE} stage successfully completed"
+    # Job successfully completed
+    - echo "Successfully completed job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\""
 
 documentation:
   stage: documentation
@@ -66,6 +75,8 @@ documentation:
     expose_as: 'sphinx documentation'
     when: on_success
   script:
+    # Start the job
+    - echo "Running job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\"..."
     # Install python3-venv and create a virtual environment
     - apt-get install -y python3-venv
     - python3 -m venv display-env
@@ -74,5 +85,5 @@ documentation:
     - pip3 install -r requirements-docs.txt
     # Build the documentation
     - sphinx-build docs/source/ docs/build
-    # Stage successfully completed
-    - echo "${CI_JOB_STAGE} stage successfully completed"
+    # Job successfully completed
+    - echo "Successfully completed job \"${CI_JOB_NAME}\" with the image \"${CI_JOB_IMAGE}\""

docs/source/developer/installation.rst

@@ -9,7 +9,7 @@ For developers, to set up the local environment, please follow the steps below.
    `official website`_.
 
    Note that the recommended version of Angular CLI (see below) requires a minimum Node.js version
-   of v14.20, v16.30, v18.10 or v20.0.
+   of v16.30, v18.10 or v20.0.
 
 .. _official website: https://nodejs.org/en/download