运行评测程序

Seele 提供了两种用于执行评测相关任务的动作任务。它们分别通过给 action 指定 seele/run-judge/compile@1 和 seele/run-judge/run@1 来被使用。前者主要是为了使用一些源文件进行编译，保存产生的文件。后者主要是为了运行待评测的程序。

编译任务和执行任务通过 Linux 容器技术来构建安全沙箱，从而确保要运行的程序在一个隔离的环境中运行，这不仅能够避免不同的评测任务之间相互干扰，还可以在限制程序能够使用的资源的同时防止恶意程序破坏评测系统。要正确使用编译任务和执行任务，你可能需要掌握一些有关 Linux 容器的知识。

编译任务

编译任务通常结合添加文件任务使用，将后者添加的文件挂载到容器中供编译程序使用。当编译程序运行成功后，编译任务会将指定的文件从容器中复制到根文件夹中。

参数列表

编译任务接受的参数列表如下表所示：

cache 属性

Seele 支持通过 cache 属性来为编译任务启用缓存功能。它的参数如下表所示：

编译任务会按顺序使用下面列出的值计算 SHA-256 哈希值来决定是否命中缓存。当缓存命中时，编译任务会跳过运行容器，并直接复用缓存中的 saves 指定的文件。

1. command 的值。
2. extra 中的每个字符串。
3. saves 中的每个字符串，按字典序排序。
4. sources 中的每个字符串，按字典序排序。
5. sources 中的每个字符串指向的文件内容。

示例

下面的示例在 prepare 步骤中向根文件夹添加了一个 main.c 文件，然后在 compile 步骤中向容器挂载这个 main.c 文件并执行容器中的 gcc 程序进行编译，最后将输出的 main 程序保存到根文件夹，供后续步骤使用。

steps:
  prepare:
    action: "seele/add-file@1"
    files:
      - path: "main.c"
        plain: |
          #include <stdio.h>
          int main(void) {
            printf("Hello, world!\n");
            return 0;
          }
 
  compile:
    action: "seele/run-judge/compile@1"
    image: "gcc:11-bullseye"
    command: "gcc -O2 -Wall main.c -o main"
    sources: ["main.c"]
    saves: ["main"]

执行任务

执行任务一般用于运行需要评测的程序，用户常常需要限制评测程序的运行时间、内存占用等。

参数列表

执行任务接受的参数列表如下表所示：

示例

下面的示例在 prepare 步骤中向根文件夹添加了一个 main 可执行文件，然后在 run 步骤中执行这个程序。

steps:
  prepare:
    action: "seele/add-file@1"
    files:
      - path: "main"
        url: "http://darkyzhou.net/main"
 
  compile:
    action: "seele/run-judge/run@1"
    image: "gcc:11-bullseye"
    command: "main"
    files: ["main:exec"]

公共配置

ContainerConfig

编译任务和执行任务共用的一些用于构建安全沙箱的参数，它的参数如下表所示：

fd 配置项

fd 配置项能够将评测程序的标准输入、标准输出和标准错误流重定向到根文件夹的文件中。它的参数如下表所示：

limits 配置项

limits 配置项能够限制评测程序使用的资源等。安全沙箱会在程序使用超出限制的资源时终止程序。

它的参数如下表所示：

评测报告

编译任务和执行任务返回的评测报告包含以下属性：

status 属性

表示程序终止运行的原因。它的取值如下表所示：