ci: remove /ci-all — Pi cannot sustain parallel Docker containers
Some checks failed
C++ Tests / test-fast (push) Successful in 1m55s
C++ Tests / test-cgal (push) Has been cancelled
C++ Tests / quality-gates (push) Has started running
API Docs / doc-build (push) Has been cancelled
Markdown link check / check (push) Has been cancelled
C++ Tests / test-fast (pull_request) Successful in 2m16s
C++ Tests / quality-gates (pull_request) Has been skipped
C++ Tests / test-cgal (pull_request) Has been skipped

The Pi runner (3-4 GB RAM, swap heavily loaded) OOMs when /ci-all
triggers test-cgal + quality-gates + doc-build + links simultaneously:
four Docker containers start at once after test-fast completes, each
consuming 150-400 MB, exhausting available RAM.

Fix: /ci-all removed from all three workflow files.  Each keyword
now triggers exactly one job — no parallel container competition.

Safe workflow: one keyword per commit.
  Typical sequence:
    git commit -m 'fix: ... /test-cgal'   → CGAL tests (~5 min)
    git commit -m 'chore: /quality-gates' → style checks (~30 s)

CLAUDE.md: CI table updated with Pi-runner warning note.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Tarik Moussa
2026-05-31 02:00:39 +02:00
parent a7b966c850
commit d4ea5fdd2e
4 changed files with 13 additions and 12 deletions

View File

@@ -3,11 +3,13 @@ name: C++ Tests
# Trigger keywords in commit message (checked via head_commit.message): # Trigger keywords in commit message (checked via head_commit.message):
# /test-cgal — full CGAL test suite (277 tests, ~5 min build) # /test-cgal — full CGAL test suite (277 tests, ~5 min build)
# /quality-gates — license, codespell, shellcheck, CGAL conventions # /quality-gates — license, codespell, shellcheck, CGAL conventions
# /ci-all — all of the above + /docs + /links (across all workflows) #
# ⚠ /ci-all was removed: the Pi runner (3-4 GB RAM) cannot sustain
# multiple Docker containers simultaneously. Use one keyword per commit.
# #
# Examples: # Examples:
# git commit -m "fix: correct angle formula /test-cgal" # git commit -m "fix: correct angle formula /test-cgal"
# git commit -m "release prep /ci-all" # git commit -m "chore: update headers /quality-gates"
# #
# test-fast always runs on every push — it is fast (< 5 s) and cheap. # test-fast always runs on every push — it is fast (< 5 s) and cheap.
@@ -76,9 +78,7 @@ jobs:
# ───────────────────────────────────────────────────────────────────────────── # ─────────────────────────────────────────────────────────────────────────────
test-cgal: test-cgal:
needs: test-fast needs: test-fast
if: | if: contains(github.event.head_commit.message, '/test-cgal')
contains(github.event.head_commit.message, '/test-cgal') ||
contains(github.event.head_commit.message, '/ci-all')
runs-on: eulernest runs-on: eulernest
container: container:
image: git.eulernest.eu/conformallab/ci-cpp:latest image: git.eulernest.eu/conformallab/ci-cpp:latest
@@ -133,9 +133,7 @@ jobs:
# Cheap (~30 s): license headers, CGAL conventions, codespell, shellcheck. # Cheap (~30 s): license headers, CGAL conventions, codespell, shellcheck.
# ───────────────────────────────────────────────────────────────────────────── # ─────────────────────────────────────────────────────────────────────────────
quality-gates: quality-gates:
if: | if: contains(github.event.head_commit.message, '/quality-gates')
contains(github.event.head_commit.message, '/quality-gates') ||
contains(github.event.head_commit.message, '/ci-all')
runs-on: eulernest runs-on: eulernest
container: container:
image: git.eulernest.eu/conformallab/ci-cpp:latest image: git.eulernest.eu/conformallab/ci-cpp:latest

View File

@@ -27,8 +27,7 @@ jobs:
doc-build: doc-build:
if: | if: |
github.event_name == 'workflow_dispatch' || github.event_name == 'workflow_dispatch' ||
contains(github.event.head_commit.message, '/docs') || contains(github.event.head_commit.message, '/docs')
contains(github.event.head_commit.message, '/ci-all')
runs-on: eulernest runs-on: eulernest
container: container:
image: git.eulernest.eu/conformallab/ci-cpp:latest image: git.eulernest.eu/conformallab/ci-cpp:latest

View File

@@ -27,8 +27,7 @@ jobs:
if: | if: |
github.event_name == 'schedule' || github.event_name == 'schedule' ||
github.event_name == 'workflow_dispatch' || github.event_name == 'workflow_dispatch' ||
contains(github.event.head_commit.message, '/links') || contains(github.event.head_commit.message, '/links')
contains(github.event.head_commit.message, '/ci-all')
runs-on: eulernest runs-on: eulernest
container: container:
image: git.eulernest.eu/conformallab/ci-cpp:latest image: git.eulernest.eu/conformallab/ci-cpp:latest

View File

@@ -270,6 +270,11 @@ Three jobs in `.gitea/workflows/cpp-tests.yml`:
| `doc-build` | *(none)* | Doxygen | `/docs` in commit message or `workflow_dispatch` | **active** | | `doc-build` | *(none)* | Doxygen | `/docs` in commit message or `workflow_dispatch` | **active** |
| `markdown-links` | *(none)* | python3 | `/links` in commit message, weekly cron, `workflow_dispatch` | **active** | | `markdown-links` | *(none)* | python3 | `/links` in commit message, weekly cron, `workflow_dispatch` | **active** |
> **⚠ Pi runner limit:** use **one keyword per commit**. The Pi (3-4 GB RAM) cannot run
> multiple Docker containers simultaneously. `/ci-all` was removed for this reason.
> Typical workflow: one commit with `/test-cgal`, then if green a separate commit with
> `/quality-gates`.
Runner: `eulernest` — self-hosted Raspberry Pi, ARM64, Ubuntu 22.04. Docker image: `git.eulernest.eu/conformallab/ci-cpp:latest`. `test-cgal` and `quality-gates` both need `test-fast` to pass first (`needs: test-fast`). Runner: `eulernest` — self-hosted Raspberry Pi, ARM64, Ubuntu 22.04. Docker image: `git.eulernest.eu/conformallab/ci-cpp:latest`. `test-cgal` and `quality-gates` both need `test-fast` to pass first (`needs: test-fast`).
`quality-gates` runs four required structural gates: `license-headers.sh`, `cgal-conventions.py`, `codespell.sh`, `shellcheck.sh --strict`. Seven more gates (clang-format, cmake-format, cppcheck, sanitizers, clang-tidy, multi-compiler, reproducible-build) are local-only — see `scripts/quality/README.md`. `quality-gates` runs four required structural gates: `license-headers.sh`, `cgal-conventions.py`, `codespell.sh`, `shellcheck.sh --strict`. Seven more gates (clang-format, cmake-format, cppcheck, sanitizers, clang-tidy, multi-compiler, reproducible-build) are local-only — see `scripts/quality/README.md`.