mahboob-a / rcee Goto Github PK

The Algocode RCE Engine (C++ Judge) uses the following services to serve the request during Production Stage.

a. Docker to securely execute the user submitted code
b. Portainer to manage and monitor docker container in RCE Engine
c. RabbitMQ for asynchronous message processig.
d. Django as backend. 
e. Docker to containerize the service. 

The Code Manager Service is deployed in AWS EC2 Ubuntu 22.04 Server.

RCE Engine is the heart behind the Algocode platform. It executes the user submitted code that was published by Code Manager Service to a RabbitMQ instance, and finally publishes the result to a unified result queue that is consumed by the Code Manager service.

The client can not directly interact with the RCE Engine Service as RCE Engine is isolated, secure service and it is only accessible to Message Queue.

The C++ Judge in the RCE Engine works in sibling containers architecture. The host docker container for the RCE Engine is capable of spawning sibling containers to execute the code submitted by the user. The sibling container spawned by the host docker container is secure, non-privileged and restricted container. The sibling containers are capable of fighting any potential malicious code execution such as fork-bomb, resource exhaustion file-hijacking etc.

Please visit Online Judge, it is a PoC of the C++ Judge implemented in the RCE Engine. You will find more in-depth analytical documentation on the various state of C++ Judge in the Prototype of C++ Judge.

A separate light-weight prototype for the C++ Judge is also available. This prototype is a PoC for the C++ Judge and easier to test and manage. It can handle API requests as well as preset question to test the PoC of C++ Judge.

Please visit the FAQ of Online Judge to learn more about the Prototype of the C++ Judge. It has more detailed and analytical comparisons between the various state of the C++ Judge.

• Watch from 16:30 for code execution begin and 18:30 for code submission result.

• Watch from 09:30 for code execution begin and 11:30 for code submission result.

The Code Manager Service publishes the user submitted code to C++ Queue and the RCE Engine consumes from a C++ Queue to execute the code.

Once the RCE Engine consumes from the queue, it processes the data and prepares for the code execution.

As the pre-processing is completed, the C++ Judge compiles and executes the code.

Finally, the RCE Engine compares the testcases against the code execution output, if the code execution is successful, or it processes the error occurred during the compilation or execution stage, and publishes the final result to a unified result queue.

This unified result queue is consumed by the Code Manager Service to cache the result in Redis and finally store the result in MongoDB database for persistence.

Please fork and clone this development branch of Algocode RCE Engine (C++ Judge) Service, and follow along with the envs-examples.

cd to src and create a virtual environment. Activate the virtual environment.

Run make docker-up and the development setup will start running. Please install make in your host machine.

If you use Windows Operating System, please run the respective docker commands from the dev.yml docker compose file.

You are always welcome to contribute to the project. Please open an issue or raise a PR on the project.