chore(docker): setup sandboxed runtime containers and build script

- runner-base: alpine 3.18 + 非 root 用户 1000:1000 + /code 工作目录
- runner-python: 基于 base, apk add python3 + python 符号链接(对齐 run_cmd 'python')
- runner-node: 基于 base, apk add nodejs
- runner.toml: 镜像自描述(运行时实际配置由 Rust LANGUAGES 注册表 + 环境变量决定)
- build-runners.sh: 按 base→python→node 顺序构建, tag 与 languages.rs 严格对齐
This commit is contained in:
xfy 2026-07-03 18:48:03 +08:00
parent bbd4553467
commit 9851f98dc0
6 changed files with 91 additions and 0 deletions

24
docker/build-runners.sh Executable file
View File

@ -0,0 +1,24 @@
#!/bin/sh
# 构建代码运行器所需的沙箱镜像base → python / node。
#
# 依赖:本机已安装 docker。构建顺序固定python/node FROM base
# 镜像 tag 与 src/api/code_runner/languages.rs 的注册项严格对应:
# yggdrasil-runner-base:latest
# yggdrasil-runner-python:latest
# yggdrasil-runner-node:latest
set -e
SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
echo "==> Building yggdrasil-runner-base:latest"
docker build -t yggdrasil-runner-base:latest "$SCRIPT_DIR/runner-base"
echo "==> Building yggdrasil-runner-python:latest"
docker build -t yggdrasil-runner-python:latest "$SCRIPT_DIR/runner-python"
echo "==> Building yggdrasil-runner-node:latest"
docker build -t yggdrasil-runner-node:latest "$SCRIPT_DIR/runner-node"
echo "==> Done. Images:"
docker images --filter "reference=yggdrasil-runner-*" \
--format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"

View File

@ -0,0 +1,10 @@
# 代码运行器的共享基础镜像。
# 仅创建非 root 用户 1000:1000 与 /code 工作目录;具体语言镜像在此基础上安装运行时。
# 与 src/infra/docker.rs 的 user: "1000:1000"、working_dir: "/code" 对齐。
FROM alpine:3.18
RUN addgroup -S runner && adduser -S runner -G runner -u 1000 \
&& mkdir -p /code \
&& chown -R runner:runner /code
WORKDIR /code

View File

@ -0,0 +1,11 @@
# Node.js 运行沙箱镜像。
# 与 src/api/code_runner/languages.rs 的 node 注册项对齐:
# image: yggdrasil-runner-node:latest
# run_cmd: node /code/main.js
FROM yggdrasil-runner-base:latest
RUN apk add --no-cache nodejs
COPY runner.toml /runner.toml
USER runner

View File

@ -0,0 +1,15 @@
# Node runner 镜像的运行时默认值(参考用)。
# 实际生效配置由 Rust 侧 LANGUAGES 注册表 + CODE_RUNNER_* 环境变量决定(见
# src/api/code_runner/languages.rs、src/infra/runner_config.rs本文件仅作为
# 镜像构建产物的自描述,便于运维核对镜像与代码的契约一致。
language = "node"
extension = "js"
run_command = "node /code/main.js"
allow_network = false
[default_limits]
cpu_cores = 1.0
memory_mb = 256
timeout_secs = 5
output_bytes = 1048576
allow_network = false

View File

@ -0,0 +1,16 @@
# Python 运行沙箱镜像。
# 与 src/api/code_runner/languages.rs 的 python 注册项对齐:
# image: yggdrasil-runner-python:latest
# run_cmd: python /code/main.py
#
# 注意alpine 的 python3 包只提供 `python3`,这里建 `python` 符号链接以匹配 run_cmd。
# 运行时src/infra/docker.rs以 user 1000:1000、只读根文件系统 + tmpfs /code 挂载容器,
# 源码通过 stdin 写入 /code/main.py 后 exec run_cmd。
FROM yggdrasil-runner-base:latest
RUN apk add --no-cache python3 \
&& ln -sf /usr/bin/python3 /usr/bin/python
COPY runner.toml /runner.toml
USER runner

View File

@ -0,0 +1,15 @@
# Python runner 镜像的运行时默认值(参考用)。
# 实际生效配置由 Rust 侧 LANGUAGES 注册表 + CODE_RUNNER_* 环境变量决定(见
# src/api/code_runner/languages.rs、src/infra/runner_config.rs本文件仅作为
# 镜像构建产物的自描述,便于运维核对镜像与代码的契约一致。
language = "python"
extension = "py"
run_command = "python /code/main.py"
allow_network = false
[default_limits]
cpu_cores = 1.0
memory_mb = 256
timeout_secs = 5
output_bytes = 1048576
allow_network = false