fix(ci): Clean up GH environment so there is more disk space for workflows (#1108)

# Changes

- Add reusable environment cleanup action.
- Clean up environment before running CI to avoid - or at least lessen -
space issues.
- Added uv + apt-get cache cleanup.
- May not be necessary with the environment cleanups, but couldn't be
too cleared of cache.

# Context

I have recently seen instances
([1](https://github.com/kagent-dev/kagent/actions/runs/19438427104/job/55615392952?pr=1104),
[2](https://github.com/kagent-dev/kagent/actions/runs/19435624387/job/55614362470?pr=1059),
+2 others), where `test-e2e` is failing when setting up the test agents,
since it runs out of space during a build. this PR is meant to
_hopefully_ completely mitigate that by clearing up space.

## Note(s)

The cleanup action is lifted from [kgateway go prep
action](https://github.com/kgateway-dev/kgateway/blob/0b703049e4786fc524f428b6de3d01d8724c6c9e/.github/actions/prep-go-runner/action.yaml),
without the additional setup there, since this PR is currently focused
on clearing space before before running workflows. This is similar to
others actions in solo(org)-managed products, so it's a pattern
followed.

# Before & After

**Before clearing disk space:**
Filesystem      Size  Used Avail Use% Mounted on
/dev/root        72G   53G   19G  74% /
tmpfs           7.9G   84K  7.9G   1% /dev/shm
tmpfs           3.2G  1.1M  3.2G   1% /run
tmpfs           5.0M     0  5.0M   0% /run/lock
/dev/sdb16      881M   62M  758M   8% /boot
/dev/sdb15      105M  6.2M   99M   6% /boot/efi
/dev/sda1        74G  4.1G   66G   6% /mnt
tmpfs           1.6G   12K  1.6G   1% /run/user/1001

**After clearing disk space:**
Filesystem      Size  Used Avail Use% Mounted on
/dev/root        72G   34G   38G  48% /
tmpfs           7.9G   84K  7.9G   1% /dev/shm
tmpfs           3.2G  1.1M  3.2G   1% /run
tmpfs           5.0M     0  5.0M   0% /run/lock
/dev/sdb16      881M   62M  758M   8% /boot
/dev/sdb15      105M  6.2M   99M   6% /boot/efi
/dev/sda1        74G  4.1G   66G   6% /mnt
tmpfs           1.6G   12K  1.6G   1% /run/user/1001

**Summary:**
- Total disk freed: ~19 GB

---------

Signed-off-by: Fabian Gonzalez <[email protected]>

Author: inFocus7

.github/actions/initialize-environment/action.yaml

@@ -0,0 +1,61 @@
+name: Initialize Environment
+
+description: Initialization steps for kagent actions
+
+runs:
+  using: "composite"
+  steps:
+    - name: Cancel Previous Actions
+      uses: styfle/cancel-workflow-action@85880fa0301c86cca9da44039ee3bb12d3bedbfa # 0.12.1
+      with:
+        access_token: ${{ github.token }}
+    - name: Free disk space
+      shell: bash
+      run: |
+        echo "Before clearing disk space:"
+        df -h
+        docker system df -v
+
+        # https://github.com/actions/runner-images/discussions/3242 github runners are bad at cleanup
+        echo "Removing large packages"
+        sudo apt-get remove -y '^dotnet-.*' || true
+        sudo apt-get remove -y '^llvm-.*' || true
+        sudo apt-get remove -y 'php.*' || true
+        sudo apt-get remove -y '^mongodb-.*' || true
+        sudo apt-get remove -y '^mysql-.*' || true
+        sudo apt-get remove -y azure-cli google-chrome-stable firefox powershell mono-devel libgl1-mesa-dri || true
+        sudo apt-get autoremove -y || true
+        sudo apt-get clean -y || true
+        echo "Done removing large packages"
+
+        # Clean up pre-installed tools
+        # For some reason, GHA often takes minutes (up to 20min observed) to clean up somehow.
+        # Presumably this is due to a slow disk?
+        function clean-dir() {
+          echo "Cleaning $1"
+          time sudo rm -rf "$1" || true
+        }
+        # These two were found to take very very long. Even though its large, its not worth the cost
+        # clean-dir /usr/local/lib/android  # 8.9gb
+        # clean-dir $AGENT_TOOLSDIRECTORY  # 5.6gb
+        clean-dir /usr/share/dotnet  # 3.4gb
+        clean-dir /usr/share/swift  # 3.1gb
+        clean-dir /usr/local/.ghcup  # 6.3gb
+        clean-dir /usr/local/share/powershell  # 1.2gb
+        clean-dir /usr/local/share/chromium  # 600mb
+
+        # Clean up images
+        docker image rm node:18 || true
+        docker image rm node:18-alpine || true
+        docker image rm node:20 || true
+        docker image rm node:20-alpine || true
+        # remove the dangling images and containers
+        docker images | tail -n +2 | awk '$1 == "<none>" {print $3}' | xargs --no-run-if-empty docker rmi
+        docker ps -a | tail -n +2 | awk '$2 ~ "^[0-9a-f]+$" {print $1}' | xargs --no-run-if-empty docker rm --volumes=true
+
+        # Clean up Docker
+        docker system prune -f || true
+
+        echo "After clearing disk space:"
+        df -h
+        docker system df -v

.github/workflows/ci.yaml

@@ -40,6 +40,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
+      - name: Initialize Environment
+        uses: ./.github/actions/initialize-environment
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
         with:

python/samples/crewai/poem_flow/Dockerfile

@@ -8,7 +8,8 @@ WORKDIR /app
 # Install system dependencies
 RUN apt-get update && apt-get install -y \
     build-essential \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get clean
 
 # Copy project files
 COPY samples samples
@@ -19,7 +20,8 @@ COPY .python-version .python-version
 COPY uv.lock uv.lock
 
 # Install dependencies
-RUN uv venv && uv sync --locked --no-dev --package poem-flow
+RUN uv venv && uv sync --locked --no-dev --package poem-flow \
+    && uv cache clean
 
 # Set environment variables
 ENV PORT=8080

python/samples/crewai/research-crew/Dockerfile

@@ -8,7 +8,8 @@ WORKDIR /app
 # Install system dependencies
 RUN apt-get update && apt-get install -y \
     build-essential \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get clean
 
 # Copy project files
 COPY samples samples
@@ -19,7 +20,8 @@ COPY .python-version .python-version
 COPY uv.lock uv.lock
 
 # Install dependencies
-RUN uv venv && uv sync --locked --no-dev --package research-crew
+RUN uv venv && uv sync --locked --no-dev --package research-crew \
+    && uv cache clean
 
 # Set environment variables
 ENV PORT=8080

python/samples/langgraph/currency/Dockerfile

@@ -8,7 +8,8 @@ WORKDIR /app
 # Install system dependencies
 RUN apt-get update && apt-get install -y \
     build-essential \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get clean
 
 # Copy project files
 COPY samples samples
@@ -19,7 +20,8 @@ COPY .python-version .python-version
 COPY uv.lock uv.lock
 
 # Install dependencies
-RUN uv sync --locked --no-dev
+RUN uv sync --locked --no-dev \
+    && uv cache clean
 
 # Set environment variables
 ENV PYTHONPATH=/app