Umple Code Execution

This code base provides the functionality to securely execute Java code using Docker containers.

Setup

1. Create config.cfg file from config.cfg.template with correct parameters (Explained below).
2. Run ./setup.sh
3. (Optional) Run the following command to compile and use latest Javascript changes if haven't done yet.
   ant -DshouldPackageUmpleOnline=true -Dmyenv=wlocal -f build.umple.xml packageUmpleonline

Config.cfg

umplePath
Path to the Umple's ump folder where temporary user folders are created. The full path to umpleonline/ump tempPath
A directory where temporary files can be written. Suggested: /tmp mainContainerName
Name of the always running container and image. Use the default unless you are running more than one instance. tempContainerName
Name of the temporary java container and image created for Java execution. Use the default unless you are running more than one instance. portToUse Port that the Umple Php code uses to communicate with the Docker image. Suggested: 4400. If you are running more than one instance, then each would need a new port. timeoutValue How many seconds execution will run before the execution is ended. Default 20, but reduce if the server resources are limited.

Setup.sh

This shell script contains commands to build docker images and to run the main docker container. The server will start at the following url by default.
http:localhost:4400

Other Issues

1. If timeout is coming even though the docker is running, make sure that umplePath in config.cfg does not start with '~'.