stanfordlegion/gitlab-ci

镜像概述

stanfordlegion/gitlab-ci镜像为Gitlab CI环境提供Legion并行编程模型的支持。Legion是斯坦福大学开发的并行编程模型与运行时系统，旨在将并行算法的规范与分布式异构架构的映射解耦，适用于跨CPU、GPU等多种硬件的分布式计算场景。该镜像可用于在Gitlab CI流水线中构建、测试基于Legion的并行应用。

核心功能

1. 并行编程抽象：通过逻辑区域（Logical Regions）描述数据结构，支持隐式/显式并行任务启动，自动检测数据竞争；
2. 动态映射接口：允许自定义任务与数据的映射策略（如处理器选择、内存位置），映射决策仅影响性能不改变正确性；
3. 调试与分析工具：集成Legion Spy（任务依赖可视化）、Legion Prof（性能分析）等工具，辅助排查并行程序问题；
4. 多架构兼容：支持CPU、GPU（CUDA）、网络（GASNet）等异构环境，可通过配置启用相关特性。

使用场景

• 分布式并行算法的开发与持续集成验证；
• 异构架构下（CPU+GPU集群）并行应用的自动化测试；
• Legion项目的构建、部署与性能基准测试。

配置说明

Makefile变量

在Gitlab CI脚本中可设置以下变量调整编译选项：

• DEBUG=<0/1>：控制优化级别与动态检查（1为调试模式）；
• USE_CUDA=<0/1>：启用CUDA GPU支持；
• USE_GASNET=<0/1>：启用GASNet网络支持；
• USE_LLVM=<0/1>：启用LLVM动态代码生成。

编译Flags

通过CC_FLAGS添加编译标志：

• -DLEGION_SPY：启用Legion Spy工具；
• -DPRIVILEGE_CHECKS：启用额外权限检查；
• -DBOUNDS_CHECKS：启用动态边界检查。

命令行参数

运行应用时可通过参数调整运行时行为：

• -ll:cpu <int>：每个进程的CPU处理器数量；
• -ll:gpu <int>：每个进程的GPU处理器数量；
• -lg:prof <N>：启用性能分析（N为待分析节点数）；
• -lg:spy：启用任务依赖追踪。

Gitlab CI配置示例

yaml
stages:
  - build
  - test

build_legion:
  stage: build
  image: stanfordlegion/gitlab-ci
  script:
    - git clone https://github.com/StanfordLegion/legion.git
    - export LG_RT_DIR="$PWD/legion/runtime"
    - cd legion/examples/full_circuit
    - make DEBUG=0 USE_CUDA=1
    - ./ckt_sim -ll:cpu 4 -ll:gpu 1

test_legion_spy:
  stage: test
  image: stanfordlegion/gitlab-ci
  script:
    - cd legion/examples/full_circuit
    - make DEBUG=1 CC_FLAGS="-DLEGION_SPY"
    - ./ckt_sim -lg:spy -logfile spy_%.log
    - $LG_RT_DIR/../tools/legion_spy.py -lpa spy_*.log