Containerization.md

Containerization

Docker on Linux

The text below shows how you can use (code of) the new Network class in a Docker container on a Linux host. The description on how to move the interface of the Docker container is an adaption of an article/video from the “Chemnitzer Linux-Tage”.

Creating a Docker Image

To create a Docker image that contains ICOc just install the package with pip inside your Dockerfile. We recommend that you use a virtual environment to install the package. For an example, please take a look at the Dockerfile in the folder Docker.

Building the Docker Image

If you do not want to create a Dockerfile yourself, you can build an image based on our Docker example file:

docker build -t mytoolit/icoc -f Docker/Dockerfile .

Using ICOc in the Docker Container

1. Run the container (Terminal 1)

   1. Open a new terminal window

   2. Open a shell in the Docker container

      docker run --rm -it --name icoc mytoolit/icoc

2. Move the CAN interface into the network space of the Docker container (Terminal 2)

   export DOCKERPID="$(docker inspect -f '{{ .State.Pid }}' icoc)"
   sudo ip link set can0 netns "$DOCKERPID"
   sudo nsenter -t "$DOCKERPID" -n ip link set can0 type can bitrate 1000000
   sudo nsenter -t "$DOCKERPID" -n ip link set can0 up

   Note: Alternatively you can also add the option --network host to the Docker command from step 1. Please check out the Docker documentation to learn more about the consequences of using this option.

3. Run a test command in Docker container (Terminal 1) e.g.:

   icon list