BCF-6186: [ReaR] Run unit tests during CI

.github/workflows/create-release-branch.yml

@@ -0,0 +1,63 @@
+name: Create release branch
+
+on:
+  workflow_dispatch:
+    inputs:
+      jira_ticket:
+        description: "Jira ticket to create PR (e.g. BCF-7777)"
+        type: string
+        required: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  create-release-branch:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        ref: develop
+
+    - name: Configure Git
+      run: |
+        git config user.name "github-actions"
+        git config user.email "github-actions@github.com"
+
+    - name: Authenticate GitHub CLI
+      run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+
+    - name: Determine version
+      id: determine_version
+      run: |
+        inc_version=$(git tag \
+          | grep -E '^[0-9]+\.[0-9]+-[0-9]+-cove$' \
+          | awk -F'-' '{print $(NF-1)}' \
+          | sort -n \
+          | tail -1)
+        inc_version=$((inc_version + 1))
+        version="2.9-$inc_version-cove"
+        echo "Version: $version"
+        echo "version=$version" >> $GITHUB_OUTPUT
+
+    - name: Create release branch
+      env:
+        VERSION: ${{ steps.determine_version.outputs.version }}
+      run: |
+        git checkout -b release/$VERSION
+        git push origin release/$VERSION
+
+    - name: Create PR to master
+      env:
+        VERSION: ${{ steps.determine_version.outputs.version }}
+        JIRA_TICKET: ${{ github.event.inputs.jira_ticket }}
+      run: |
+        gh pr create \
+          --base master \
+          --head release/$VERSION \
+          --title "${JIRA_TICKET}: Merge release/$VERSION to master" \
+          --body "Automated release PR"

.github/workflows/create-release-tag.yml

@@ -0,0 +1,45 @@
+name: Create release tag
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+
+jobs:
+  create-release-tag:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        ref: master
+
+    - name: Configure Git
+      run: |
+        git config user.name "github-actions"
+        git config user.email "github-actions@github.com"
+
+    - name: Determine version
+      id: determine_version
+      run: |
+        inc_version=$(git tag \
+          | grep -E '^[0-9]+\.[0-9]+-[0-9]+-cove$' \
+          | awk -F'-' '{print $(NF-1)}' \
+          | sort -n \
+          | tail -1)
+        inc_version=$((inc_version + 1))
+        version="2.9-$inc_version-cove"
+        echo "Version: $version"
+        echo "version=$version" >> $GITHUB_OUTPUT
+
+    - name: Create release tag
+      env:
+        VERSION: ${{ steps.determine_version.outputs.version }}
+      run: |
+        git tag $VERSION
+        git push origin $VERSION

Jenkinsfile

@@ -0,0 +1,126 @@
+@Library('cove')
+import nable.cove.helpers.ShellHelper
+import nable.cove.SecretManager
+
+final String jobName = env.JOB_NAME.split('/')[-2]
+final String branchName = env.CHANGE_BRANCH ?: env.BRANCH_NAME
+final boolean isProd = jobName.endsWith('-prd')
+final boolean isProdBranch = branchName == 'master' || branchName.startsWith('release')
+final String envType = isProd ? 'prd' : 'dev'
+
+def String repositoryName = 'rear'
+
+def config = [
+    cloud: "backup-${envType}",
+    serviceAccount: "backup",
+    buildImage: "${nsbuild.ecrHost()}/cove/onprem/develop/rear-builder:v1.7"
+]
+
+def secrets = [
+    jenkins: [
+        'github-app': [
+            usernamePassword: [
+                usernameVariable: 'GITHUB_USERNAME',
+                passwordVariable: 'GITHUB_PASSWORD'
+            ]
+        ]
+    ],
+    kubernetes: [
+        'artifactory': [
+            'JFROG_USERNAME': 'ARTIFACTORY_USERNAME_COVE',
+            'JFROG_ACCESS_TOKEN': 'ARTIFACTORY_TOKEN_COVE'
+        ]
+    ]
+]
+
+def secretManager
+def shellHelper
+def shouldBuild = true
+
+pipeline {
+    agent {
+        kubernetes {
+            cloud "${config.cloud}"
+            yaml nsbuild.agentYaml(config)
+            defaultContainer nsbuild.defaultContainer(config)
+        }
+    }
+
+    options {
+        ansiColor('xterm')
+    }
+
+    stages {
+        stage('Prepare') {
+            steps {
+                script {
+                    if (isProd != isProdBranch) {
+                        echo "Environment mismatch: isProd=${isProd}, isProdBranch=${isProdBranch}. Skipping build."
+                        shouldBuild = false
+                    }
+
+                    secretManager = new SecretManager(
+                        this,
+                        envType,
+                        jenkinsWhitelist: [
+                            'github-app'
+                        ],
+                        k8sWhitelist: [
+                            'artifactory'
+                        ]
+                    )
+                    shellHelper = new ShellHelper(this, isUnix: true)
+                }
+            }
+        }
+        stage('Load secrets') {
+            when {
+                expression { shouldBuild }
+            }
+            agent {
+                kubernetes {
+                    cloud "${config.cloud}"
+                    yaml secretManager.getK8sPodYaml(secrets)
+                    defaultContainer 'secrets'
+                    customWorkspace 'w'
+                }
+            }
+            steps {
+                script {
+                    secretManager.loadJenkinsSecrets(secrets.jenkins)
+                    secretManager.loadK8sSecrets(secrets.kubernetes, shellHelper)
+                }
+            }
+        }
+        stage('Build') {
+            when {
+                expression { shouldBuild }
+            }
+            environment {
+                ARTIFACTORY_URL = 'https://mspsolarwinds.jfrog.io/artifactory'
+            }
+            steps {
+                script {
+                    secretManager.withSecrets {
+                        shellHelper.exec('Validate', """
+                            make validate
+                        """)
+                        shellHelper.exec('Run unit tests', """
+                            make test-cove
+                        """)
+                        shellHelper.exec('Build', """
+                            make dist
+                        """)
+                        def repository = (envType == 'dev') ? 'cove-generic-develop-local' : 'cove-generic-release-local'
+                        shellHelper.exec('Upload', """
+                            PACKAGE="rear-\$(make version).tar.gz"
+                            curl -sSf -X PUT -T dist/\${PACKAGE} \
+                                -u \${ARTIFACTORY_USERNAME_COVE}:\${ARTIFACTORY_TOKEN_COVE} \
+                                \${ARTIFACTORY_URL}/${repository}/rear/\${PACKAGE}
+                        """)
+                    }
+                }
+            }
+        }
+    }
+}

Makefile

@@ -34,7 +34,7 @@ else
 			git_date := $(shell git log -n 1 --format="%ai")
 			git_ref := $(shell git rev-parse HEAD | cut -c 1-8)
 			git_count := $(shell git rev-list HEAD --no-merges | wc -l)
-			git_branch_suffix = $(shell git symbolic-ref HEAD | sed -e 's,^.*/,,' -e "s/[^A-Za-z0-9]//g")
+			git_branch_suffix = $(shell echo "$${CHANGE_BRANCH:-$${BRANCH_NAME:-$$(git symbolic-ref HEAD || echo unknown)}}" | sed -e 's,^.*/,,' -e "s/[^A-Za-z0-9]//g")
 			git_status := $(shell git status --porcelain)
 			git_stamp := $(git_count).$(git_ref).$(git_branch_suffix)
 			ifneq ($(git_status),)
@@ -101,6 +101,7 @@ help:
 \n\
   version         - Show ReaR version used\n\
   validate        - Check source code\n\
+  test-cove       - Run COVE unit tests with bats\n\
   install         - Install Relax-and-Recover (may replace files)\n\
   uninstall       - Uninstall Relax-and-Recover (may remove files)\n\
   dist            - Create tar file in dist/\n\
@@ -153,6 +154,16 @@ validate:
 		fi; \
 	done
 
+test-cove:
+	@echo "== Running COVE unit tests =="
+	@for test_file in tests/COVE/*.bats; do \
+		echo ""; \
+		echo "========================================"; \
+		echo "Executing: $${test_file}"; \
+		echo "========================================"; \
+		bats "$${test_file}"; \
+	done
+
 man:
 	@echo -e "\033[1m== Prepare manual ==\033[0;0m"
 	$(MAKE) -C doc man

README.md

@@ -1,6 +1,6 @@
 # Relax-and-Recover Linux Disaster Recovery & Bare Metal Restore
 
-Relax-and-Recover (abbreviated ReaR) is the de facto standard disaster recovery framework on Linux.
+Relax-and-Recover  (abbreviated ReaR) is the de facto standard disaster recovery framework on Linux.
 
 It is in particular used on enterprise Linux distributions like Red Hat Enterprise Linux (RHEL)
 and SUSE Linux Enterprise Server (SLES).
@@ -10,7 +10,7 @@ for bare metal disaster recovery with data backup restore on physical or virtual
 
 For bare metal disaster recovery the ReaR recovery system is booted on pristine replacement hardware.
 On replacement hardware first the storage setup/layout is recreated (disk partitioning, filesystems, mount points),
-then a backup restore program is called to restore the data (system files) into the recreated storage,
+then a backup restore program is called  to restore the data (system files) into the recreated storage,
 and finally a boot loader is installed.
 
 System administrators use the ReaR framework to set up a disaster recovery procedure

containers/builder/Dockerfile

@@ -0,0 +1,24 @@
+ARG CONTAINER_REPO=263262308774.dkr.ecr.eu-west-1.amazonaws.com
+
+FROM ${CONTAINER_REPO}/ns/mirror/prd/library/debian:12.11-slim
+
+RUN apt-get update && \
+    apt-get install -y \
+    git \
+    bats \
+    bash \
+    coreutils \
+    curl \
+    make \
+    && rm -rf /var/lib/apt/lists/*
+
+ARG user=build
+ARG group=build
+ARG uid=1000
+ARG gid=1000
+
+RUN groupadd -g "${gid}" "${group}"                                           \
+    && useradd -l -c "Build user" -d "/${user}" -u "${uid}" -g "${gid}"       \
+        -s /bin/bash -m "${user}"
+
+USER build

doc/user-guide/06-layout-configuration.adoc

@@ -631,7 +631,7 @@ disk <name> <size(B)> <partition label>
 
 === Partitions ===
 ----------------------------------
-part <disk name> <size(B)> <start(B)> <partition name/type> <flags/"none"> <partition name>
+part <disk name> <size(B)> <start(B)> <partition name/type> <flags/"none"> <partition name> <partition guid/"no-partuuid">
 ----------------------------------
 
 === Software RAID arrays ===