Using the following instructions you'll be able to run Jumper Virtual Lab using Docker. With Docker, you can run Jumper Virtual Lab on any OS that has Docker installed. Using Docker comes handy for continuous integration pipelines and test automation runners as well.
- Install Docker on your host machine.
Run Jumper Virtual Lab Docker Container
Head to Jumper Labs Docker hub, to get the links of all Jumper Docker images.
Each time you want to run Jumper Virtual Lab using Docker just run the following commands (for the basic Docker container):
- Get latest updates, run:
docker pull jumperio/jumper-vlab
- Run Docker container:
docker run -it --rm -v C:/FULL/PATH/TO/MY/DIRECTORY:/my_files_in_docker -v C:/FULL/PATH/TO/.jumper:/root/.jumper -p LOCAL_HOST_GDB_PORT:5555 jumperio/jumper-vlab
- Windows Subsystem Linux, macOS and Linux:
docker run -it --rm -v /FULL/PATH/TO/MY/DIRECTORY:/my_files_in_docker -v /FULL/PATH/TO/.jumper:/root/.jumper -p LOCAL_HOST_GDB_PORT:5555 jumperio/jumper-vlab
/FULL/PATH/TO/MY/DIRECTORY- working directory in your host machine. The directory where your firmware executables are.
my_files_in_docker- working directory in the docker container. We are mapping the working directory from the host machine to this directory.
/FULL/PATH/TO/.jumper- path to the directory where you saved the secure token file when you opened Jumper Account.
/root/.jumper- the folder in the docker container to which you'll map the .jumper folder with your personal token in your host machine. If you don't map this folder, you must use
jumper runwith the
--tokenflag on each run.
-p LOCAL_HOST_GDB_PORT:5555- mapping ports for the GDB server and client. On the local host machine we map the GDB client port, for example 5566. On the Docker container the GDB server port is 5555. This port mapping is needed when you want to connect a GDB client to the virtual device for debug purpose.
- Mapping the GDB ports and the directories is not a must, for example when running the container from CI runner.
- To run different Docker image by Jumper, change
jumperio/jumper-vlabto the image you'd like to run.
- On the Jumper Labs Docker hub you'll find the recpies for the Docker images of each container.