Continuous Integration

The FoamAdapter project uses a two-level Continuous Integration (CI) system to ensure correct builds, GPU compatibility, and automated benchmarking.

The main repository is hosted on GitHub, and GPU-based workflows are delegated to LRZ GitLab, where jobs are executed on both NVIDIA and AMD GPUs. The CI architecture for FoamAdapter is illustrated below.

Overview of the CI architecture for FoamAdapter

Continuous Integration on GitHub

GitHub CI is responsible for managing the overall FoamAdapter CI workflow.

Responsibilities:

  • Build and test FoamAdapter on CPU across different platforms (Linux, macOS, Windows).

  • Push the source code and commit metadata to LRZ GitLab.

  • Cancel outdated pipelines on LRZ GitLab for the same branch.

  • Trigger new LRZ GitLab pipelines for GPU builds and benchmarks.

Note

The GitHub CI acts as the control layer for all FoamAdapter CI operations. Developers interact only with GitHub — all LRZ GitLab pipelines are triggered automatically.

Continuous Integration on LRZ GitLab

The LRZ GitLab CI handles GPU-related operations.

Responsibilities:

  • Build and test FoamAdapter on NVIDIA and AMD GPUs on Linux.

  • Run benchmark jobs after successful build and test stages.

  • Report the status and results back to GitHub for unified monitoring.

Development Workflow

The development workflow for FoamAdapter proceeds as follows:

  1. A developer opens a pull request (PR) or pushes a commit to an existing PR on GitHub.

  2. GitHub CI builds and tests FoamAdapter on CPUs.

  3. GitHub CI pushes the same branch to LRZ GitLab.

  4. GitHub CI cancels all pending or running LRZ GitLab pipelines for that branch.

  5. GitHub CI triggers a new LRZ GitLab pipeline.

  6. LRZ GitLab CI builds and tests FoamAdapter on GPUs.

  7. (Optional) Benchmark jobs are executed after successful testing.

  8. The developer monitors all results directly on GitHub.

Pull Request Labels

FoamAdapter’s GitHub repository uses labels to control the CI behavior.

Relevant Labels:

  • Skip-build — Skip all build-and-test jobs on both GitHub and LRZ GitLab.

  • benchmark — Enable GPU benchmarking jobs after successful build-and-test jobs.

These labels allow developers to customize the CI process according to their needs.

Summary

The FoamAdapter CI system provides:

  • Unified GitHub-driven CI management.

  • Transparent CPU and GPU build workflows.

  • Automatic synchronization between GitHub and LRZ GitLab.

  • Branch-aware pipeline handling and cancellation.

  • On-demand GPU benchmarking via PR labels.

See also