MNT: Consolidate BACKPORT_BRANCH into ci/versions.yml (#1311)

* Initial plan

* Migrate BACKPORT_BRANCH from file to versions.yml

Co-authored-by: leofang <5534781+leofang@users.noreply.github.com>

* remove the leftover from previous hack

The version check is no longer needed, see context: #1041 (comment).

* install yq in GH-hosted Win runners

* remove outdated WAR

* zstd is now installed in self-hosted Windows runners

* install yq in self-hosted Linux runners

* avoid installing yq on self-hosted Linux runners...

the Debian package is unfortunately discontinued, and it is simpler if we consolidate the yq calls in the same job where yq is available

* CAN WE GO CONTAINERLESS?!

* try this

* try this

* try this

* revert changes for the containerless experiment

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: leofang <5534781+leofang@users.noreply.github.com>

Author: leofang

.github/BACKPORT_BRANCH

@@ -28,7 +28,7 @@ jobs:
       - name: Load branch name
         id: get-branch
         run: |
-          OLD_BRANCH=$(cat .github/BACKPORT_BRANCH)
+          OLD_BRANCH=$(yq '.backport_branch' ci/versions.yml)
           echo "OLD_BRANCH=${OLD_BRANCH}" >> $GITHUB_ENV
 
       - name: Create backport pull requests

.github/workflows/backport.yml

@@ -75,6 +75,23 @@ jobs:
         if: ${{ startsWith(inputs.host-platform, 'win') }}
         uses: ilammy/msvc-dev-cmd@v1  # TODO: ask admin to allow pinning commits
 
+      - name: Set up yq
+        # GitHub made an unprofessional decision to not provide it in their Windows VMs,
+        # see https://github.com/actions/runner-images/issues/7443.
+        if: ${{ startsWith(inputs.host-platform, 'win') }}
+        env:
+          # doesn't seem there's an easy way to avoid hard-coding it?
+          YQ_URL: https://github.com/mikefarah/yq/releases/latest/download/yq_windows_amd64.exe
+          YQ_DIR: yq_latest
+        shell: pwsh -command ". '{0}'"
+        run: |
+          mkdir -Force -ErrorAction SilentlyContinue "${env:YQ_DIR}" | Out-Null
+          Invoke-WebRequest -UseBasicParsing -OutFile "${env:YQ_DIR}/yq.exe" -Uri "$env:YQ_URL"
+          ls -l $env:YQ_DIR
+          echo "$((Get-Location).Path)\\$env:YQ_DIR" >> $env:GITHUB_PATH
+          $env:Path += ";$((Get-Location).Path)\\$env:YQ_DIR"
+          yq --version
+
       - name: Set environment variables
         env:
           CUDA_VER: ${{ inputs.cuda-version }}
@@ -275,8 +292,7 @@ jobs:
         id: setup-python2
         uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5.6.0
         with:
-          # workaround for actions/runner-images#12377 (the cached 3.13.4 is buggy on Windows)
-          python-version: ${{ matrix.python-version == '3.13' && '3.13.5' || matrix.python-version }}
+          python-version: ${{ matrix.python-version }}
 
       - name: verify free-threaded build
         if: endsWith(matrix.python-version, 't')
@@ -334,7 +350,6 @@ jobs:
           cuda-path: "./cuda_toolkit_prev"
 
       - name: Download cuda.bindings build artifacts from the prior branch
-        if: startsWith(matrix.python-version, '3.14')
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
@@ -350,7 +365,7 @@ jobs:
             && apt install gh -y
           fi
 
-          OLD_BRANCH=$(cat .github/BACKPORT_BRANCH)
+          OLD_BRANCH=$(yq '.backport_branch' ci/versions.yml)
           OLD_BASENAME="cuda-bindings-python${PYTHON_VERSION_FORMATTED}-cuda*-${{ inputs.host-platform }}*"
           LATEST_PRIOR_RUN_ID=$(gh run list -b ${OLD_BRANCH} -L 1 -w "ci.yml" -s completed -R NVIDIA/cuda-python --json databaseId | jq '.[]| .databaseId')
           if [[ "$LATEST_PRIOR_RUN_ID" == "" ]]; then

.github/workflows/build-wheel.yml

@@ -33,6 +33,7 @@ jobs:
                 (inputs.host-platform == 'linux-aarch64' && 'arm64') }}
     outputs:
       MATRIX: ${{ steps.compute-matrix.outputs.MATRIX }}
+      OLD_BRANCH: ${{ steps.compute-matrix.outputs.OLD_BRANCH }}
     steps:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
@@ -67,6 +68,10 @@ jobs:
 
           echo "MATRIX=${MATRIX}" | tee --append "${GITHUB_OUTPUT}"
 
+          # This job has yq already installed, so let's do it here
+          OLD_BRANCH=$(yq '.backport_branch' ci/versions.yml)
+          echo "OLD_BRANCH=${OLD_BRANCH}" >> "$GITHUB_OUTPUT"
+
   test:
     name: py${{ matrix.PY_VER }}, ${{ matrix.CUDA_VER }}, ${{ (matrix.LOCAL_CTK == '1' && 'local') || 'wheels' }}, ${{ matrix.GPU }}
     needs: compute-matrix
@@ -147,7 +152,7 @@ jobs:
           && apt update \
           && apt install gh -y
 
-          OLD_BRANCH=$(cat .github/BACKPORT_BRANCH)
+          OLD_BRANCH=${{ needs.compute-matrix.outputs.OLD_BRANCH }}
           OLD_BASENAME="cuda-bindings-python${PYTHON_VERSION_FORMATTED}-cuda*-${{ inputs.host-platform }}*"
           LATEST_PRIOR_RUN_ID=$(gh run list -b ${OLD_BRANCH} -L 1 -w "ci.yml" -s completed -R NVIDIA/cuda-python --json databaseId | jq '.[]| .databaseId')
           if [[ "$LATEST_PRIOR_RUN_ID" == "" ]]; then
@@ -219,7 +224,7 @@ jobs:
         with:
           python-version: ${{ matrix.PY_VER }}
         env:
-          # we use self-hosted runners on which setup-python behaves weirdly...
+          # we use self-hosted runners on which setup-python behaves weirdly (Python include can't be found)...
           AGENT_TOOLSDIRECTORY: "/opt/hostedtoolcache"
 
       - name: Set up mini CTK

.github/workflows/test-wheel-linux.yml

@@ -125,27 +125,12 @@ jobs:
           name: ${{ env.CUDA_BINDINGS_ARTIFACT_NAME }}
           path: ${{ env.CUDA_BINDINGS_ARTIFACTS_DIR }}
 
-      - name: Install zstd
-        # the GPU runner image does not have zstd pre-installed... and it's needed by actions/cache
-        if: ${{ matrix.LOCAL_CTK == '1' }}
-        env:
-          # doesn't seem there's an easy way to avoid hard-coding it?
-          ZSTD_URL: https://github.com/facebook/zstd/releases/download/v1.5.7/zstd-v1.5.7-win64.zip
-          ZSTD_DIR: zstd-v1.5.7-win64
-        run: |
-          Invoke-WebRequest -Uri "$env:ZSTD_URL" -OutFile "zstd-win64.zip"
-          Expand-Archive -Path "zstd-win64.zip" -DestinationPath .
-          ls -l $env:ZSTD_DIR
-          echo "$((Get-Location).Path)\\$env:ZSTD_DIR" >> $env:GITHUB_PATH
-          $env:Path += ";$((Get-Location).Path)\\$env:ZSTD_DIR"
-          zstd --version
-
       - name: Download cuda-python & cuda.bindings build artifacts from the prior branch
         if: ${{ env.SKIP_CUDA_BINDINGS_TEST == '1'}}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          $OLD_BRANCH = Get-Content .github/BACKPORT_BRANCH
+          $OLD_BRANCH = yq '.backport_branch' ci/versions.yml
           $OLD_BASENAME = "cuda-bindings-python${env:PYTHON_VERSION_FORMATTED}-cuda*-${{ inputs.host-platform }}*"
           $runData = gh run list -b $OLD_BRANCH -L 1 -w "ci.yml" -s completed -R NVIDIA/cuda-python --json databaseId | ConvertFrom-Json
           if (-not $runData -or $runData.Length -eq 0 -or -not $runData[0].databaseId -or [string]::IsNullOrEmpty($runData[0].databaseId)) {

.github/workflows/test-wheel-windows.yml

@@ -5,7 +5,6 @@ LICENSE
 *.png
 .gitattributes
 .gitignore
-.github/BACKPORT_BRANCH
 requirements*.txt
 cuda_bindings/examples/*
 

.spdx-ignore

@@ -1,6 +1,8 @@
 # SPDX-FileCopyrightText: Copyright (c) 2024-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+backport_branch: "12.9.x"
+
 cuda:
   build:
     version: "13.1.0"