trampgeek/jobeinabox

JobeInABox

!https://img.shields.io/docker/stars/trampgeek/jobeinabox.svg !https://img.shields.io/docker/pulls/trampgeek/jobeinabox.svg !https://img.shields.io/docker/cloud/automated/trampgeek/jobeinabox.svg !https://img.shields.io/docker/cloud/build/trampgeek/jobeinabox.svg

https://moodle.org/plugins/qtype_coderunner%E9%9C%80%E8%A6%81Jobe%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9D%A5%E8%BF%90%E8%A1%8C%E5%AD%A6%E7%94%9F%E6%8F%90%E4%BA%A4%E7%9A%84%E4%BD%9C%E4%B8%9A%E3%80%82https://hub.docker.com/r/trampgeek/jobeinabox/%E6%98%AF%E4%B8%80%E4%B8%AADocker%E9%95%9C%E5%83%8F%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80Jobe%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%94%AF%E6%8C%81%E8%BF%90%E8%A1%8C%E6%89%80%E6%9C%89%E6%A0%87%E5%87%86%E8%AF%AD%E8%A8%80%E3%80%82%E6%9C%89%E5%85%B3Jobe%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E5%AE%8C%E6%95%B4%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85https://github.com/trampgeek/jobe%E3%80%82

注意：出于安全和性能考虑，强烈建议即使在容器中运行Jobe，也应在专用独立服务器上部署。

本地构建和运行自己的镜像（强烈推荐）

有多种方式构建和运行JobeInABox容器，例如：

• Podman
• https://docs.docker.com/

生产环境中，应使用本地时区构建自己的镜像。以下示例使用Docker：

从Github拉取https://github.com/trampgeek/jobeinabox%EF%BC%8C%E8%BF%9B%E5%85%A5jobeinabox%E7%9B%AE%E5%BD%95%EF%BC%8C%E6%89%A7%E8%A1%8C%E4%BB%A5%E4%B8%8B%E6%A0%BC%E5%BC%8F%E7%9A%84%E5%91%BD%E4%BB%A4%EF%BC%9A

bash
sudo docker build . -t my/jobeinabox --build-arg TZ="Europe/Amsterdam"

然后使用以下命令运行新构建的镜像：

bash
sudo docker run -d -p 4000:80 --name jobe my/jobeinabox

这将在4000端口启动Jobe服务器，可本地测试并供Moodle使用，详见下文“使用JobeInABox”部分。

使用Docker Hub上的预构建JobeInABox镜像

要运行预构建的Docker Hub镜像，只需执行：

bash
sudo docker run -d -p 4000:80 --name jobe trampgeek/jobeinabox:latest

这将在4000端口启动Jobe服务器，可本地测试并供Moodle使用，详见下文“使用JobeInABox”部分。

设置Jobe用户数量

默认情况下，Jobe最多同时运行8个作业。这通常适用于8核系统，但如果有更多核心，可能需要提高此数量。操作步骤如下：

通过以下命令在容器中执行shell：

bash
docker exec -it jobe bash

然后：

bash
nano /var/www/html/jobe/app/Config/Jobe.php

找到以下行：

php
public int $jobe_max_users = 8;

将值从8更改为机器的核心数，或如果主要运行I/O密集型作业，可设置更高值。

然后在容器内重新安装Jobe：

bash
cd /var/www/html/jobe
./install --purge

检查性能

可使用以下命令检查容器性能：

bash
docker exec -it jobe /var/www/html/jobe/testsubmit.py --perf

使用API密钥

可通过--secret选项在镜像构建时提供API密钥。

密钥可存储在单独文件中，格式如下：

'c1425880-2289-4b76-ae29-bcea34997256' => 0,
'de7970e6-0466-4ce2-a6a4-c1a51363bd03' => 90

有关API密钥的更多信息，请参阅Jobe文档。

以下命令会将jobeinabox目录中名为api_keys的文件中的密钥自动添加到/var/www/html/jobe/app/Config/Jobe.php，并将$require_api_keys选项设置为true：

bash
podman build . -t my/jobeinabox --secret id=api_keys,src=api_keys

如果未提供API密钥，配置保持不变。

警告：

1. 镜像大小超过1GB，首次启动可能需要较长时间，具体取决于下载带宽。

使用JobeInABox

通过上述任一方法启动JobeInABox容器后，可通过访问以下URL检查其运行状态：

http://[运行Docker的主机]:4000/jobe/index.php/restapi/languages

应返回JSON格式的支持语言列表：

json
[["c","7.3.0"],["cpp","7.3.0"],["java","10.0.2"],["nodejs","8.10.0"],["octave","4.2.2"],["pascal","3.0.4"],["php","7.2.7"],["python3","3.6.5"]]

要在容器内运行测试套件，使用：

bash
sudo docker exec -t jobe /usr/bin/python3 /var/www/html/jobe/testsubmit.py

要将Moodle/CodeRunner插件配置为使用此Docker化Jobe服务器，在CodeRunner管理设置（站点管理 > 插件 > 题目类型 > CodeRunner）中，将Jobe服务器字段设置为：

[运行Docker的主机]:4000

不要以[***]

停止运行中的服务器：

bash
sudo docker stop jobe

删除服务器容器：

bash
sudo docker rm jobe

检查残留容器：

bash
sudo docker ps -a

安全注意事项：

1. 尽管运行Jobe的容器本身应是安全的，但容器网络目前桥接到主机网络。这意味着可从任何能访问主机的位置访问Jobe，且Jobe可访问主机能访问的任何URI。生产环境中必须对主机进行防火墙配置。

2. 定期重建容器，确保运行最新的Jobe版本和安全更新。

变更历史（仅最近变更）

2024年10月18日：

• 现在可使用Docker的“--secret”功能在构建时指定API密钥配置（感谢@theLogicJB）。

• 修复了关于更改Jobe服务器数量的文档错误。