https://github.com/ntut-xuan/nuoj-sandbox

NuOJ 所使用的沙盒，基於 ioi 的 Isolate 開源進行開發
https://github.com/ntut-xuan/nuoj-sandbox

Last synced: 21 days ago
JSON representation

NuOJ 所使用的沙盒，基於 ioi 的 Isolate 開源進行開發

• Host: GitHub
• URL: https://github.com/ntut-xuan/nuoj-sandbox
• Owner: ntut-xuan
• Created: 2022-07-05T15:30:11.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-09T12:50:13.000Z (9 months ago)
• Last Synced: 2024-04-20T11:59:49.402Z (9 months ago)
• Language: C++
• Size: 2.58 MB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# NuOJ - Sandbox

[![codecov](https://codecov.io/gh/ntut-xuan/NuOJ-Sandbox/graph/badge.svg?token=UVQXFQDTCK)](https://codecov.io/gh/ntut-xuan/NuOJ-Sandbox)

## Introduction

The sandbox system based on [Isolate by IOI](https://github.com/ioi/isolate) for [Nu Online Judge](https://github.com/ntut-xuan/NuOJ).

We provide the routes for judging the code, it also handling various exceptions caused by submission code, solution and checker. 

Moreover, we wrote a utility to operate the Isolate that provide create file, run binary, compile code, execute the code, and judge the code. (See `backend/utils/isolate/util.py`)

## Supported platform

The sandbox system needs the version 1 of the control group. We provide a dockerfile to deploy the application in Docker, and make the application can work in most of the platform.

If your platfrom using the version 2 of the control group, you need to downgrade the control group to the version 1. 

The downgrade of the control group only work on Linux platform.

## Installation

### Using docker compose to deploy the application

First, you need the Docker to deploy the application. You should install the docker in [Docker official page](https://docker.com)

Check the docker is working, and use docker-compose to deploy the application.

```

docker compose up --build --no-deps --force-recreate

```

And it should be deploy the application by various steps.

When the deploy is successful, it should creating the application and running the tests to test the application working correctly.

The applicaiton will listen in 4439 port.

### Failed at environment doctor

If the steps failed in check the control group, it means the version of the control group working in this machine is version 2.

We provide a `env_setting.py` python script in `/backend` folder to downgrade the control group to version 1.

The script only work in Linux platform since the control group of WSL is version 1.

```

cd backend && python3 env_setting.py

```