fix(ci): Resolve installation hangs and update deployment logic

This commit addresses several issues across the `notebook-test` and `docs` CI/CD workflows to improve reliability, efficiency, and compatibility with different environments (Gitea, GitHub Actions, local `act`).

Key changes:

1.  **Resolves `apt-get` Hangs and `pip` Errors:**
    *   Adds `DEBIAN_FRONTEND=noninteractive` to all `apt-get install` commands. This prevents the workflows from hanging on interactive prompts from packages like `tzdata`.
    *   Uses `pip install --ignore-installed` when upgrading `pip`, `setuptools`, and `wheel`. This fixes the `uninstall-no-record-file` error by preventing `pip` from attempting to uninstall packages managed by the system's package manager.
    *   Consolidates multiple `apt-get` steps in `notebook-test.yml` into a single, more efficient step.

2.  **Updates Gitea Documentation Deployment:**
    *   The deployment path for Gitea is updated to `/pages/docs/${{ github.event.repository.name }}` to align with the new server configuration, which serves docs from a subfolder.
    *   Adds a step to extract the `artifact.tar` created by `actions/upload-pages-artifact` before deploying the contents.

3.  **Improves Local `act` Runner Compatibility:**
    *   The `docs` workflow now skips the `upload-pages-artifact` and `deploy-pages` steps when running locally via `act` (`if: ${{ !env.ACT }}`). This prevents failures caused by the absence of GitHub-specific environment variables like `ACTIONS_RUNTIME_TOKEN`.

Author: SamoraHunter

.github/workflows/docs.yml

@@ -31,15 +31,15 @@ jobs:
       # Use CPU-only PyTorch to save disk space
       PIP_EXTRA_INDEX_URL: https://download.pytorch.org/whl/cpu
       TORCH_CPU_ONLY: "true"
-    
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       # Install Act dependencies FIRST (before any apt-get commands)
-      - name: Install Act dependencies 
-        if: ${{ env.ACT }} 
-        run: | 
+      - name: Install Act dependencies
+        if: ${{ env.ACT }}
+        run: |
           # Ensure apt-get is available and install sudo for 'act' environments
           if ! command -v apt-get &> /dev/null; then
             echo "apt-get not found, cannot proceed"
@@ -53,8 +53,8 @@ jobs:
         run: |
           sudo apt-get update
           # Install lsb-release, Node.js, and ca-certificates all at once
-          DEBIAN_FRONTEND=noninteractive sudo apt-get install -y lsb-release nodejs ca-certificates
-          
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y lsb-release nodejs ca-certificates
+
           # Trust your mounted certificate (from the act command)
           sudo update-ca-certificates
 
@@ -78,6 +78,7 @@ jobs:
         run: sphinx-build -b html docs/source docs/build
 
       - name: Upload artifact
+        if: ${{ !env.ACT }}
         uses: actions/upload-pages-artifact@v3
         with:
           path: ./docs/build
@@ -92,21 +93,22 @@ jobs:
     runs-on: ubuntu-latest
     env:
       NODE_EXTRA_CA_CERTS: /etc/ssl/certs/ca-certificates.crt
-      
+
     steps:
-      - name: Install Act dependencies 
-        if: ${{ env.ACT }} 
-        run: | 
+      - name: Install Act dependencies
+        if: ${{ env.ACT }}
+        run: |
           apt-get update && apt-get install -y sudo
 
       - name: Install Runner Dependencies & Configure CA
         run: |
           sudo apt-get update
-          sudo apt-get install -y nodejs ca-certificates
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nodejs ca-certificates
           sudo update-ca-certificates
-          
+
       - name: Deploy to GitHub Pages
         id: deployment
+        if: ${{ !env.ACT }}
         uses: actions/deploy-pages@v4
 
   # Deploy job for Gitea
@@ -118,15 +120,15 @@ jobs:
       NODE_EXTRA_CA_CERTS: /etc/ssl/certs/ca-certificates.crt
 
     steps:
-      - name: Install Act dependencies 
-        if: ${{ env.ACT }} 
-        run: | 
+      - name: Install Act dependencies
+        if: ${{ env.ACT }}
+        run: |
           apt-get update && apt-get install -y sudo
 
       - name: Install Runner Dependencies & Configure CA
         run: |
           sudo apt-get update
-          sudo apt-get install -y nodejs ca-certificates
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nodejs ca-certificates
           sudo update-ca-certificates
 
       - name: Download artifact
@@ -138,6 +140,12 @@ jobs:
       - name: Deploy to Gitea docs location
         run: |
           echo "Deploying documentation to Gitea's special directory..."
+          # Extract the artifact.tar (created by upload-pages-artifact)
+          tar -xf ./docs-site/artifact.tar -C ./docs-site
+          rm ./docs-site/artifact.tar
+
           # The '/pages' directory is a mounted volume on the Gitea runner for serving static content.
-          sudo mkdir -p /pages/
-          sudo cp -r ./docs-site/* /pages/
+          # Deploy to a subfolder named after the repository
+          TARGET_DIR="/pages/docs/${{ github.event.repository.name }}"
+          sudo mkdir -p "$TARGET_DIR"
+          sudo cp -r ./docs-site/* "$TARGET_DIR/"

.github/workflows/notebook-test.yml

@@ -51,38 +51,24 @@ jobs:
           # This trusts your mounted certificate (from the act command)
           sudo update-ca-certificates
 
-      - name: Install ping utility
+      - name: Install System Dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y iputils-ping
-
-      - name: Set timezone to UTC
-        run: |
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y \
+            iputils-ping \
+            tzdata \
+            libgomp1 \
+            default-jre \
+            build-essential
+          # Set timezone after installing tzdata
           sudo ln -fs /usr/share/zoneinfo/Etc/UTC /etc/localtime
           echo "Etc/UTC" | sudo tee /etc/timezone
-          sudo apt-get update
-          sudo apt-get install -y tzdata
           sudo dpkg-reconfigure -f noninteractive tzdata
 
-      - name: Install libgomp1 for LightGBM
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y libgomp1
-
-      - name: Install Java for H2O
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y default-jre
-
-      - name: Install build dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y build-essential
-
       - name: Install Python 3.12 and Git
         run: |
           sudo apt-get update
-          sudo apt-get install -y lsb-release software-properties-common gnupg curl git
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y lsb-release software-properties-common gnupg curl git
 
           # --- THIS IS THE GPG KEY FIX ---
 
@@ -93,7 +79,7 @@ jobs:
           echo "deb [signed-by=/usr/share/keyrings/deadsnakes-archive-keyring.gpg] http://ppa.launchpadcontent.net/deadsnakes/ppa/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/deadsnakes-ppa.list
 
           sudo apt-get update
-          sudo apt-get install -y python3.12 python3.12-venv python3.12-dev
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3.12 python3.12-venv python3.12-dev
 
           # Install pip for Python 3.12 (force reinstall to avoid Debian package conflicts)
           curl -sS https://bootstrap.pypa.io/get-pip.py | sudo python3.12 - --break-system-packages --ignore-installed
@@ -107,7 +93,7 @@ jobs:
         run: |
           cd $GITHUB_WORKSPACE
           chmod +x install.sh
-          sudo python -m pip install --upgrade pip setuptools wheel --break-system-packages
+          sudo python -m pip install --upgrade --ignore-installed pip setuptools wheel --break-system-packages
           # The install.sh will use PIP_EXTRA_INDEX_URL if set for CPU-only PyTorch
           ./install.sh