Standalone docker image contains twister2 source code and prebuilt twister2. Examples can be easily run using this image.
We assume that docker is already installed on your machine.
Pulling twister2/standalone Image From twister2 dockerhub
dockerhub page for the image: https://hub.docker.com/r/twister2/standalone
To download the docker image:
docker pull twister2/standalone
Building twister2/standalone Image Using Dockerfile
If you want to build docker image by yourself, you can download the Dockerfile and in the same directory, use the command below:
docker build -t repositoryname:tag . # example: # docker build -t twister2/standalone:0.4.0 .
Running The Container
This command runs the container and starts an interactive bash session
docker run -it twister2/standalone bash
Docker image contains the source code and prebuilt twister2. Prebuilt twister2 is in the
~/twister2-0.4.0 So, make sure that you are in that directory
In order to run a job you can use the following command on the interactive bash session
twister2 submit slurm job-type job-file-name job-class-name [job-args]
Here is an example command
./bin/twister2 submit standalone jar examples/libexamples-java.jar edu.iu.dsc.tws.examples.basic.HelloWorld 8
In this mode, the job is killed immediately when you terminate the client using
Ctrl + C.
Building Twister2 Inside The Container
Docker image can be also used to build twister2. The source code inside the container is located at
~/twister2. To build the twister2 inside the docker container:
cd ~/twister2 bazel build --config=ubuntu scripts/package:tarpkgs
This will build twister2 distribution in the file:
If you want to modify the twister2 code and test without installing all the dependencies to your machine, you can mount the directory to the docker container:
docker run -v /path/in/host:/path/in/container -it twister2/standalone bash