Add swap for haddocks

Author: carbolymer

.github/workflows/github-page.yml

@@ -1,6 +1,8 @@
 name: "Haddock documentation"
 
 on:
+  workflow_dispatch:
+  pull_request: # TODO: remove
   push:
     branches:
       - master
@@ -14,42 +16,44 @@ jobs:
         shell: bash
 
     steps:
-    - name: Install Nix
-      uses: cachix/install-nix-action@v18
+    - uses: actions/checkout@v6
+
+    - uses: cachix/install-nix-action@v31
       with:
-        # Use last stable nixos channel and the same nix as in channel:
-        nix_path: nixpkgs=channel:nixos-24.05
         github_access_token: ${{ secrets.GITHUB_TOKEN }}
         extra_nix_config: |
+          accept-flake-config = true
           access-tokens = github.com=${{ secrets.GITHUB_TOKEN }}
-          experimental-features = nix-command flakes
-          allow-import-from-derivation = true
-          substituters = https://cache.nixos.org https://cache.iog.io
-          trusted-public-keys = hydra.iohk.io:f/Ea+s+dFdN+3Y/G+FDgSq+a5NEWhJGzdjvKNGv0/EQ= cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY=
 
-    - uses: actions/checkout@v4
+    - uses: rrbutani/use-nix-shell-action@v1
+
+    # Haddock exhausts the runner's 7GB RAM and gets OOM-killed.
+    - name: Set up swap
+      run: |
+        sudo fallocate -l 10G /swapfile
+        sudo chmod 600 /swapfile
+        sudo mkswap /swapfile
+        sudo swapon /swapfile
+        free -h
 
-    - name: Fetch nix cache and update cabal indices
+    - name: Update cabal indices
       run: |
-        nix develop --command \
-          cabal update
+        cabal update
 
     - name: Build whole project
       run: |
-        nix develop --command \
-          cabal build all
+        cabal build all
 
     - name: Build documentation
       run: |
-        nix develop --command \
-          cabal haddock-project --local --output=./haddocks --internal --foreign-libraries
+        cabal haddock-project --local --output=./haddocks --internal --foreign-libraries
 
     - name: Compress haddocks
       run: |
         tar -czf haddocks.tgz -C haddocks .
 
     - name: Upload haddocks artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       if: ${{ always() }}
       continue-on-error: true
       with:
@@ -58,7 +62,7 @@ jobs:
 
     - name: Deploy documentation to gh-pages 🚀
       if: github.ref == 'refs/heads/master'
-      uses: peaceiris/actions-gh-pages@v4
+      uses: peaceiris/actions-gh-pages@v6
       with:
         github_token: ${{ secrets.GITHUB_TOKEN || github.token }}
         publish_dir: haddocks

.gitignore

@@ -77,3 +77,5 @@ cardano-tracer/cardano-tracer-test
 .idea/
 
 .codex
+
+.serena