.gitlab-ci.yml

stages:
  - prepare-pipeline
  - build-gcc
  - run-tests
  - build-clang
  - build-doc
  - release-validation

variables:
  # GitLab CI variables
  GIT_STRATEGY: clone
  GIT_DEPTH: 0
  # GitLab specific variables
  GITLAB_BELLE2_TOOLS_B2SETUP: "/cvmfs/belle.cern.ch/tools/b2setup"
  GITLAB_IS_FIRST_STAGE: "no"
  GITLAB_FORCE_RUNNING_PIPELINE: "no"
  GITLAB_RUNNER: "none"
  # Define cvmfs as source for conditions metadata
  BELLE2_CONDB_METADATA: "/cvmfs/belle.cern.ch/conditions/database.sqlite"
  # The other BELLE2_ variables are defined in the "Variables" section of the CI/CD settings

workflow:
  rules:
    # We run the pipeline only if:
    # - it is a merge request event
    # - it is a merge commit in the main, release or upgrade branch
    # - we force the pipeline
    # Moreover, the pipelines are redirected to the runners extagent4 or extagent8
    # according to some rules defined below
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event' && $CI_MERGE_REQUEST_IID =~ /[02468]$/  # merge request event and even merge request ID
      variables:
        GITLAB_RUNNER: "extagent4"
      when: always
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event' && $CI_MERGE_REQUEST_IID =~ /[13579]$/  # merge request event and odd merge request ID
      variables:
        GITLAB_RUNNER: "extagent8"
      when: always
    - if: $CI_PIPELINE_SOURCE == 'push' && $CI_COMMIT_BRANCH == 'main' && $CI_COMMIT_TITLE =~ /Merge branch.*/  # merge commit in main branch
      variables:
        GITLAB_RUNNER: "extagent4"
      when: always
    - if: $CI_PIPELINE_SOURCE == 'push' && ($CI_COMMIT_BRANCH =~ /^release/ || $CI_COMMIT_BRANCH == 'upgrade') && $CI_COMMIT_TITLE =~ /Merge branch.*/  # merge commit in release or upgrade branch
      variables:
        GITLAB_RUNNER: "extagent8"
      when: always
    - if: $GITLAB_FORCE_RUNNING_PIPELINE == 'yes'  # forced pipeline
      variables:
        GITLAB_RUNNER: "extagent4"
      when: always

default:
  image: belle2/belle2-base-ubuntu2004:latest
  tags:
    - $GITLAB_RUNNER  # The runner is dynamically assigned by the workflow rules
  cache:
    key: $CI_COMMIT_REF_SLUG
    paths:
      - .sconf_temp/
      - .sconsign.dblite
      - bin/
      - build/
      - config.log
      - data/
      - include/
      - lib/
      - modules/
      - target_head_hash.txt
  before_script:
    # Preliminary operations with Git
    - git config user.email "something@something.com"
    - git config user.name "someone"
    - git config --global --add safe.directory $(dirname ${GITLAB_BELLE2_TOOLS_B2SETUP})
    # Clean the current directory by stashing the remaining modified files from previous builds
    - git stash && git stash clear
    # If this is not the first stage: merge the HEAD of the target branch
    - |
      if [ "${CI_PIPELINE_SOURCE}" == "merge_request_event" ]; then
        if [ "${GITLAB_IS_FIRST_STAGE}" != "yes" ]; then
            echo "Merging the branch ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME} up to commit $(< target_head_hash.txt) into this branch"
            git fetch --all && git merge $(< target_head_hash.txt) --strategy-option ours --no-commit --allow-unrelated-histories
        fi
      fi
    # Preliminary operations necessary for basf2
    - unset DISPLAY
    - if [ ! -f .release ]; then echo "head" > .release; fi
    - rm -rf .git/hooks && ln -sf $(dirname ${GITLAB_BELLE2_TOOLS_B2SETUP})/hooks .git/hooks
    - ln -fs site_scons/SConstruct
    - source ${GITLAB_BELLE2_TOOLS_B2SETUP}
  interruptible: true  # All the jobs can be interrupted by newer pipelines

prepare-pipeline:
  stage: prepare-pipeline
  needs: []
  variables:
    GITLAB_IS_FIRST_STAGE: "yes"
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    # Identify the current HEAD of the target branch and cache it
    - |
      if [ "${CI_PIPELINE_SOURCE}" == "merge_request_event" ]; then
        git rev-parse origin/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME} > target_head_hash.txt
        echo "The current HEAD of the branch ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME} is $(< target_head_hash.txt)"
      fi
    - echo "stage stop time -> $(date +%H:%M:%S)"

build-gcc:
  stage: build-gcc
  needs: [prepare-pipeline]
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    - b2code-option opt
    - scons --no-debuginfo
    - basf2 --info
    - echo "stage stop time -> $(date +%H:%M:%S)"

run-tests:
  stage: run-tests
  needs: [build-gcc]
  artifacts:
    when: always
    reports:
      junit:
          - tests_report/tests-google.xml
          - tests_report/tests-framework.xml
          - tests_report/tests-non-framework.xml
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    - mkdir -p tests_report
    - b2code-option opt
    - b2test-units --gtest_output=xml:${BELLE2_LOCAL_DIR}/tests_report/tests-google.xml
    - b2test-scripts -j $(nproc) --filter "^framework/tests/(?!(foreach.py))" --xml=${BELLE2_LOCAL_DIR}/tests_report/tests-framework.xml --timeout 1200
    - b2test-scripts -j $(nproc) --filter "^(?!framework/tests/.*)" --xml=${BELLE2_LOCAL_DIR}/tests_report/tests-non-framework.xml --timeout 1200
    - echo "stage stop time -> $(date +%H:%M:%S)"

build-clang:
  stage: build-clang
  needs: [run-tests]
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    - b2code-option clang
    - scons --no-debuginfo
    - basf2 --info
    - echo "stage stop time -> $(date +%H:%M:%S)"

build-doc:
  stage: build-doc
  needs: [run-tests]
  artifacts:
    when: on_success
    expose_as: 'sphinx documentation'
    paths:
      - build/html/
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    - b2code-option opt
    - scons --no-debuginfo --sphinx html
    - echo "stage stop time -> $(date +%H:%M:%S)"

release-validation:
  stage: release-validation
  needs: [run-tests]
  artifacts:
    when: on_success
    paths:
      - automated_validation_*
    expire_in: 60 days
  rules:
    - if: $CI_PIPELINE_SOURCE == 'push' && $CI_COMMIT_BRANCH == $GITLAB_BRANCH_FOR_RELEASE_VALIDATION && $CI_COMMIT_TITLE =~ /Merge branch.*/
    - if: $GITLAB_FORCE_RUNNING_PIPELINE == 'yes'
  script:
    - echo "stage start time -> $(date +%H:%M:%S)"
    # Set release to branch name but replace / with -
    - export BELLE2_RELEASE=${CI_COMMIT_BRANCH//\//-}
    # In case this pipeline is manually triggered, let's check if the user passed a staging globaltag
    - |
      if [ "${GITLAB_FORCE_RUNNING_PIPELINE}" == "yes" ]; then
        if [ "${GITLAB_STAGING_GLOBALTAG}" != "none" ]; then
          export VALIDATION_GLOBALTAG=${GITLAB_STAGING_GLOBALTAG}
        fi
      fi
    - b2code-option opt
    - basf2 --info
    - hlt/tests/release_validation/run.sh automatic automated_validation_${CI_COMMIT_BRANCH//\//-}_$(date +%Y-%m-%d_%H-%M-%S)
    - echo "stage stop time -> $(date +%H:%M:%S)"