ci(gha): add hst workflows and actions

Signed-off-by: Dave Wallace <dwallacelf@gmail.com>

Author: dwallacelf

.github/actions/vpp-build/README.md

@@ -14,6 +14,7 @@ The action compiles VPP from source, optionally building a static `vppctl` binar
   with:
     MAKE_PARALLEL_JOBS: '16'
     BUILD_TYPE: 'release'
+    BUILD_HST: 'false'
 ```
 
 ## Inputs
@@ -22,6 +23,7 @@ The action compiles VPP from source, optionally building a static `vppctl` binar
 |-------|-------------|----------|---------|
 | `MAKE_PARALLEL_JOBS` | Number of parallel jobs for `make` to control build parallelism | No | `""` (empty, uses make's default) |
 | `BUILD_TYPE` | Type of build to perform: `debug` or `release` | No | `release` |
+| `BUILD_HST` | Build for HostStack Test (HST) framework | No | `false` |
 | `TUI_LINE` | Delimiter line for terminal UI output formatting | No | `*******************************************************************` |
 
 ## Outputs
@@ -34,19 +36,42 @@ This action does not produce explicit outputs, but it will:
 
 ## Build Behavior
 
-### Release Build (default)
+The action supports two distinct build modes: **Standard VPP Build** and **HST (HostStack Test) Build**.
+
+### Standard VPP Build (`BUILD_HST: "false"` - default)
+
+#### Release Build (default)
 - Runs `make UNATTENDED=yes MAKE_PARALLEL_JOBS=<value> pkg-verify`
 - Builds and verifies VPP packages
 - Suitable for production releases and package validation
 
-### Debug Build
+#### Debug Build
 - Runs `make UNATTENDED=yes MAKE_PARALLEL_JOBS=<value> build`
 - Builds VPP with debug symbols
 - Suitable for development and debugging
 
-### Static vppctl
+#### Static vppctl
 If `extras/scripts/build_static_vppctl.sh` exists, it will be executed before the main build to create a statically-linked vppctl binary.
 
+### HST (HostStack Test) Build (`BUILD_HST: "true"`)
+
+The HST build mode is optimized for HostStack Testing framework and uses different make targets:
+
+#### HST Release Build
+- Runs `make UNATTENDED=yes MAKE_PARALLEL_JOBS=<value> build-release`
+- Builds VPP optimized for HST testing
+- Does not include package verification step
+
+#### HST Debug Build
+- Runs `make UNATTENDED=yes MAKE_PARALLEL_JOBS=<value> build`
+- Same as standard debug build but in HST context
+- Builds VPP with debug symbols for HST testing
+
+#### HST Build Features
+- **No Static vppctl**: HST builds skip the static vppctl build step
+- **Optimized Targets**: Uses HST-specific make targets for better test performance
+- **Streamlined Process**: Simplified build process focused on test execution needs
+
 ## Prerequisites
 
 Before using this action, ensure the following actions have been run:
@@ -83,6 +108,7 @@ jobs:
         with:
           MAKE_PARALLEL_JOBS: '16'
           BUILD_TYPE: ${{ matrix.build-type }}
+          BUILD_HST: 'false'
 ```
 
 ## Error Handling
@@ -100,12 +126,53 @@ The following environment variables are expected to be set by upstream actions:
 - `OS_VERSION_ID`: OS version identifier (e.g., `22.04`, `24.04`)
 - `OS_ARCH`: CPU architecture (e.g., `x86_64`, `aarch64`)
 
+### HST-Specific Workflow
+
+```yaml
+jobs:
+  build-vpp-hst:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        build-type: ['debug', 'release']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Environment
+        uses: fdio/.github/.github/actions/setup-executor-env@main
+
+      - name: Install VPP Dependencies
+        uses: fdio/vpp/.github/actions/vpp-install-deps@master
+
+      - name: Install VPP External Dependencies
+        uses: fdio/vpp/.github/actions/vpp-install-ext-deps@master
+
+      - name: Build VPP for HST
+        uses: fdio/vpp/.github/actions/vpp-build@master
+        with:
+          MAKE_PARALLEL_JOBS: '16'
+          BUILD_TYPE: ${{ matrix.build-type }}
+          BUILD_HST: 'true'
+```
+
+## Build Target Reference
+
+| Build Mode | Build Type | Make Target | Use Case |
+|------------|------------|-------------|----------|
+| Standard | Release | `pkg-verify` | Production packages with verification |
+| Standard | Debug | `build` | Development and debugging |
+| HST | Release | `build-release` | HST framework testing |
+| HST | Debug | `build` | HST framework debugging |
+
 ## Notes
 
 - The action uses `UNATTENDED=yes` to prevent interactive prompts during the build
 - Build output includes visual separators for improved log readability
 - Parallel job count can be left empty to use make's default parallelism
-- The action supports both Makefile targets: `build` (debug) and `pkg-verify` (release)
+- The action supports multiple Makefile targets based on build mode and type
+- HST builds are optimized for HostStack Test framework requirements
 
 ## Troubleshooting
 
@@ -118,6 +185,8 @@ Verify that `setup-executor-env` action has been executed to set `OS_ID`, `OS_VE
 ### Out of Memory Errors
 Reduce the `MAKE_PARALLEL_JOBS` value to decrease memory consumption during parallel compilation.
 
-## License
-
-This action is part of the VPP project. See the main repository LICENSE file for details.
+### HST Build Issues
+If HST builds fail:
+- Verify the VPP version supports HST-specific make targets (`build-release`)
+- Check that the build environment is properly configured for HST testing
+- Try switching to standard build mode (`BUILD_HST: 'false'`) to isolate HST-specific issues

.github/actions/vpp-build/action.yml

@@ -14,6 +14,11 @@ inputs:
     required: false
     default: "release"
     type: string
+  BUILD_HST:
+    description: "Build VPP for HostStack Test (HST) framework"
+    required: false
+    default: "false"
+    type: string
   TUI_LINE:
     description: "Delimiter line for TUI output"
     required: false
@@ -28,6 +33,7 @@ runs:
       env:
         MAKE_PARALLEL_JOBS: ${{ inputs.MAKE_PARALLEL_JOBS }}
         BUILD_TYPE: ${{ inputs.BUILD_TYPE }}
+        BUILD_HST: ${{ inputs.BUILD_HST }}
         TUI_LINE: ${{ inputs.TUI_LINE }}
       run: |
         set -euo pipefail
@@ -58,8 +64,29 @@ runs:
             fi
         }
 
+        build_hst_vpp() {
+            echo "Building VPP. Number of cores for build set with" \
+                  "MAKE_PARALLEL_JOBS=${MAKE_PARALLEL_JOBS}."
+
+            if [ "$BUILD_TYPE" == "debug" ] ; then
+                if ! make UNATTENDED=yes MAKE_PARALLEL_JOBS=${MAKE_PARALLEL_JOBS} build ; then
+                    BUILD_ERROR="FAILED HST BUILD 'make UNATTENDED=yes MAKE_PARALLEL_JOBS=${MAKE_PARALLEL_JOBS} build'"
+                    return
+                fi
+            else
+              if ! make UNATTENDED=yes MAKE_PARALLEL_JOBS=${MAKE_PARALLEL_JOBS} build-release ; then
+                  BUILD_ERROR="FAILED HST BUILD 'make UNATTENDED=yes MAKE_PARALLEL_JOBS=${MAKE_PARALLEL_JOBS} build-release'"
+                  return
+              fi
+            fi
+        }
+
         echo "$TUI_LINE"
-        build_vpp
+        if [ "$BUILD_HST" == "true" ] ; then
+            build_hst_vpp
+        else
+            build_vpp
+        fi
         if [ -n "${BUILD_ERROR}" ] ; then
             BUILD_RESULT="${BUILD_ERROR}"
             RETVAL="1"

.github/actions/vpp-hst-test/action.yml

@@ -0,0 +1,80 @@
+---
+name: "🛠️ Test VPP image using 'make test'"
+description: |
+  This GitHub Action tests the VPP image built using the vpp-build action.
+
+inputs:
+  BUILD_TYPE:
+    description: "Type of build: debug or release"
+    required: false
+    default: "debug"
+    type: string
+  HS_TEST_DIR:
+    description: "Directory containing HostStack Test (HST) framework tests"
+    required: false
+    default: "${WORKSPACE}/test-c/hs-test"
+    type: string
+  TUI_LINE:
+    description: "Delimiter line for TUI output"
+    required: false
+    default: "*******************************************************************"
+    type: string
+
+runs:
+  using: "composite"
+  steps:
+    - name: VPP Make Test
+      shell: bash
+      env:
+        BUILD_TYPE: ${{ inputs.BUILD_TYPE }}
+        HS_TEST_DIR: ${{ inputs.HS_TEST_DIR }}
+        TUI_LINE: ${{ inputs.TUI_LINE }}
+      run: |
+          set -euxo pipefail
+
+          BUILD_RESULT="SUCCESSFULLY COMPLETED"
+          BUILD_ERROR=""
+          RETVAL="0"
+
+          hst_debug_build_run() {
+              if ! make VERBOSE=true VPPSRC="${WORKSPACE}" -C "$HST_DIR" build-debug ; then
+                  BUILD_ERROR="FAILED 'make -C $HST_DIR build-debug'"
+                  return
+              fi
+              if ! make VERBOSE=true VPPSRC="${WORKSPACE}" -C "$HST_DIR" test-debug ; then
+                  BUILD_ERROR="FAILED 'make -C $HST_DIR test-debug'"
+                  return
+              fi
+          }
+
+          hst_build_run() {
+              if ! make VERBOSE=true VPPSRC="${WORKSPACE}" -C "$HST_DIR" build ; then
+                  BUILD_ERROR="FAILED 'make -C $HST_DIR build'"
+                  return
+              fi
+              if ! make VERBOSE=true VPPSRC="${WORKSPACE}" -C "$HST_DIR" test ; then
+                  BUILD_ERROR="FAILED 'make -C $HST_DIR test'"
+                  return
+              fi
+          }
+
+          echo "$TUI_LINE"
+          echo "Check for system core files"
+          ls -l /var/crash || true
+
+          if [ "${{ inputs.BUILD_TYPE }}" == "debug" ] ; then
+              hst_debug_build_run
+          else
+              hst_build_run
+          fi
+
+          echo "Check for system core files"
+          ls -l /var/crash || true
+
+          if [ -n "$BUILD_ERROR" ] ; then
+              BUILD_RESULT="$BUILD_ERROR"
+              RETVAL="1"
+          fi
+          echo -e "\n$TUI_LINE\n* VPP ${BUILD_TYPE^^} ${OS_ID^^}-${OS_VERSION_ID}-${OS_ARCH^^}" \
+                  "HST $BUILD_RESULT\n$TUI_LINE\n"
+          exit $RETVAL

.github/actions/vpp-make-test/action.yml

@@ -56,24 +56,25 @@ runs:
       run: |
           set -euxo pipefail
 
-          BUILD_RESULT="SUCCESSFULLY COMPLETED"
+          BUILD_RESULT="\n* MAKE TEST SUCCESSFULLY COMPLETED"
           BUILD_ERROR=""
           RETVAL="0"
 
           make_test() {
               if ! make UNATTENDED=yes test-dep ; then
-                  BUILD_ERROR="FAILED 'make test-dep'"
+                  BUILD_ERROR+="\n* FAILED 'make UNATTENDED=yes test-dep'"
                   return
               fi
               if grep -q "${OS_ID}-${OS_VERSION_ID}" <<< "${VPPAPIGEN_TEST_OS}"; then
                   if ! src/tools/vppapigen/test_vppapigen.py ; then
-                      BUILD_ERROR="FAILED src/tools/vppapigen/test_vppapigen.py"
+                      BUILD_ERROR+="\n* FAILED src/tools/vppapigen/test_vppapigen.py"
                       return
                   fi
               fi
               if grep -q "${OS_ID}-${OS_VERSION_ID}" <<< "${MAKE_TEST_OS}"; then
                   if ! make COMPRESS_FAILED_TEST_LOGS=yes TEST_JOBS="$TEST_JOBS" RETRIES=3 test ; then
-                      BUILD_ERROR="FAILED 'make test'"
+                      BUILD_ERROR+="\n* FAILED 'make COMPRESS_FAILED_TEST_LOGS=yes TEST_JOBS=$TEST_JOBS "
+                      BUILD_ERROR+="RETRIES=3 test'"
                       return
                   fi
               else
@@ -82,12 +83,12 @@ runs:
               if grep -q "${OS_ID}-${OS_VERSION_ID}" <<< "${MAKE_TEST_MULTIWORKER_OS}"; then
                   if ! make VPP_WORKER_COUNT="${VPP_WORKER_COUNT}" COMPRESS_FAILED_TEST_LOGS=yes \
                           TEST_RETRIES="${TEST_RETRIES}" TEST_JOBS="${TEST_JOBS}" test ; then
-                      BUILD_ERROR="FAILED 'make VPP_WORKER_COUNT=${VPP_WORKER_COUNT} COMPRESS_FAILED_TEST_LOGS=yes \
-                          RETRIES=${TEST_RETRIES} TEST_JOBS=${TEST_JOBS} test'"
+                      BUILD_ERROR+="\n* FAILED 'make VPP_WORKER_COUNT=${VPP_WORKER_COUNT} "
+                      BUILD_ERROR+="COMPRESS_FAILED_TEST_LOGS=yes "
+                      BUILD_ERROR+="RETRIES=${TEST_RETRIES} TEST_JOBS=${TEST_JOBS} test'"
                       return
                   else
-                      echo -e "\n* VPP ${OS_ID^^}-${OS_VERSION_ID}-${OS_ARCH^^}" \
-                              "MULTIWORKER MAKE TEST SUCCESSFULLY COMPLETED\n"
+                      BUILD_RESULT+="\n* MULTIWORKER MAKE TEST SUCCESSFULLY COMPLETED"
                   fi
               else
                   echo "Skip running MULTIWORKER MAKE TEST on ${OS_ID}-${OS_VERSION_ID}"
@@ -100,6 +101,6 @@ runs:
               BUILD_RESULT="$BUILD_ERROR"
               RETVAL="1"
           fi
-          echo -e "\n$TUI_LINE\n* VPP ${OS_ID^^}-${OS_VERSION_ID}-${OS_ARCH^^}" \
-                  "BUILD $BUILD_RESULT\n$TUI_LINE\n"
+          echo -e "\n$TUI_LINE\n* VPP ${OS_ID^^}-${OS_VERSION_ID}-${OS_ARCH^^} BUILD " \
+                  "$BUILD_RESULT\n$TUI_LINE\n"
           exit $RETVAL

.github/workflows/vpp-checkstyle.yml

@@ -67,7 +67,8 @@ concurrency:
 
 jobs:
   checkstyle:
-    name: Checkstyle on ${{ matrix.os }} ${{ matrix.executor_arch }}
+    name: vpp-checkstyle-${{ inputs.GERRIT_BRANCH }}-${{ matrix.os }}-${{ matrix.executor_arch }}
+    if: ${{ inputs.GERRIT_EVENT_TYPE == 'patchset-created' }}
     runs-on:
       - self-hosted
       - nomad