angr/ci

ci-settings

镜像概述和主要用途

本镜像包含用于CI（持续集成）的Docker镜像。大多数用户无需使用此镜像，应使用常规镜像。此镜像主要适用于CI开发人员，或需要排查拉取请求（PR）测试失败原因的场景。

核心功能和特性

CI选项

angr CI支持自定义CI运行的指令：

• 启用nightly测试：在PR描述中添加以下行可启用nightly测试：

  ci: include-nightly
  

• 使用其他PR替代默认分支：通过链接PR即可使用其他PR替代默认分支，例如：

  sync: angr/angr#<id>
  

使用场景和适用范围

• CI开发人员进行CI相关开发工作
• 排查PR测试失败原因时手动复现和调试CI流程

详细使用方法和配置说明

手动构建和测试步骤

1. 运行容器

使用以下命令手动启动容器：

sh
docker run -it \
    --cap-add=SYS_PTRACE \
    --security-opt seccomp:unconfined \
    -v /var/run/docker.sock:/var/run/docker.sock \  # 用于archr
    angr/ci:2

2. 容器内操作

进入容器后，执行以下步骤：

sh
# 此脚本将把您置于与Azure相同的目录，并设置所有必要的环境变量
source /root/scripts/manual_defaults.sh

可选：自定义环境变量

如需自定义环境变量，以下是重要变量及其默认值：

• 仓库和分支设置（更改为相关仓库和分支，PR对应refs/pull/{id}）：

  sh
  export GITHUB_REPOSITORY=angr/angr  # 默认仓库
  export GITHUB_REF=refs/heads/master  # 默认分支，PR使用refs/pull/{id}
  

• 测试执行分片（当前分为10个工作节点，可修改以运行测试子集，无需重建即可在运行ga-test.sh前更改）：

  sh
  export WORKER=0          # 当前工作节点，默认0
  export NUM_WORKERS=10    # 总工作节点数，默认10
  

运行具体步骤

sh
# 构建步骤
/root/scripts/ga-build.sh

# 代码检查步骤
/root/scripts/ga-lint.sh

# 测试步骤
/root/scripts/ga-test.sh

3. 构建后操作

构建完成后，会生成build目录，其中包含virtualenv和src目录，可用于在标准测试脚本外运行特定测试。