Merge pull request #2013 from kili-technology/feature/lab-4174-sdk-fix-release-doc-pipeline-for-lts

chore: fix deploy-doc & pre_release pipelines

Author: baptiste-olivier

.github/scripts/utils.sh

@@ -28,7 +28,17 @@ version_to_int() {
     echo "$((10#$as_int))"  # interpret as base 10
 }
 
-get_last_release_tag_github() {
-    last_tag=$(curl --silent "https://api.github.com/repos/kili-technology/kili-python-sdk/releases/latest" | jq -r .tag_name)
-    echo "$last_tag"
+
+# Get the previous release tag for a given version (closest inferior version)
+# $1: current version (e.g., "25.2.7")
+# Returns: previous tag (could be any major.minor.patch), or empty string if none
+get_previous_release_tag() {
+    local current_version="$1"
+
+    # List all semver tags, add current, sort, get line before current
+    (git tag -l | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$'; echo "$current_version") | \
+        sort -V -u | \
+        grep -B1 "^${current_version}$" | \
+        head -1 | \
+        grep -v "^${current_version}$"
 }

.github/workflows/deploy_doc.yml

@@ -22,13 +22,13 @@ jobs:
           if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
               echo "REF=${{ github.event.inputs.branch }}" >> $GITHUB_ENV
           else
-              release_payload=$(curl --silent "https://api.github.com/repos/kili-technology/kili-python-sdk/releases/latest")
-              last_version=$(echo "$release_payload" | jq -r .tag_name)
-              echo "Last version: $last_version"
-
-              release_branch=$(echo "$release_payload" | jq -r .target_commitish)
+              # Use the release that triggered this workflow, not the "latest" release
+              release_branch="${{ github.event.release.target_commitish }}"
+              tag_name="${{ github.ref_name }}"
+              echo "Release tag: $tag_name"
               echo "Release branch: $release_branch"
-              sanitized_version=${last_version#v}
+
+              sanitized_version=${tag_name#v}
               major_minor=$(echo "$sanitized_version" | awk -F. '{print $1 "." $2}')
 
               if [[ "$release_branch" == "main" ]]; then
@@ -62,7 +62,13 @@ jobs:
         run: |
           export version=$(python -c 'from kili import __version__; print(".".join(__version__.split(".")[:2]))')  # removes patch suffix
           git fetch origin gh-pages --depth=1
-          mike deploy --push --update-aliases $version latest
+          if [[ "${{ env.REF }}" == "main" ]]; then
+              # Only update "latest" alias for releases from main branch
+              mike deploy --push --update-aliases $version latest
+          else
+              # Maintenance releases: update version docs without changing "latest" alias
+              mike deploy --push $version
+          fi
 
       - name: Slack notification
         id: slack

.github/workflows/pre_release.yml

@@ -75,9 +75,9 @@ jobs:
           release_version=$(get_sdk_version_from_pyproject_toml)
           echo "Release version: $release_version"
 
-          # Get last release tag for release notes range
-          latest_release=$(get_last_release_tag_github)
-          echo "Latest release tag: $latest_release"
+          # Get previous release tag (closest inferior version)
+          latest_release=$(get_previous_release_tag "$release_version")
+          echo "Previous release tag: $latest_release"
 
           git fetch --tags --quiet