3. Docker Image (recommended)

Warning

Docker image of DDS Recorder will be updated soon in eProsima Downloads website.

eProsima distributes a Docker image of DDS Recorder with Ubuntu 22.04 as base image. This image launches an instance of DDS Recorder that is configured using a YAML configuration file provided by the user and shared with the Docker container. The steps to run DDS Recorder in a Docker container are explained below.

1. Download the compressed Docker image in .tar format from the eProsima Downloads website. It is strongly recommended to download the image corresponding to the latest version of DDS Recorder.

   
   

2. Extract the image by executing the following command:

   load ubuntu-ddsrecorder:<version>.tar
   

   where version is the downloaded version of DDS Recorder.

   
   

3. Build a DDS Recorder configuration YAML file on the local machine. This will be the DDS Recorder configuration file that runs inside the Docker container. To continue this installation manual, let’s use one of the configuration files provided in the Tutorials section. Open your preferred text editor and copy a full example from the Tutorials section into the /<dds_recorder_ws>/DDS_RECORDER_CONFIGURATION.yaml file, where dds_recorder_ws is the path of the configuration file. To make this accessible from the Docker container we will create a shared volume containing just this file. This is explained in next point.

   
   

4. Run the Docker container executing the following command:

   docker run -it \
       --net=host \
       --ipc=host \
       --privileged \
       -v /<dds_recorder_ws>/DDS_RECORDER_CONFIGURATION.yaml:/root/DDS_RECORDER_CONFIGURATION.yaml \
       ubuntu-ddsrecorder:v0.3.0
   

   It is important to mention that both the path to the configuration file hosted in the local machine and the one created in the Docker container must be absolute paths in order to share just one single file as a shared volume.

   After executing the previous command you should be able to see the initialization traces from the DDS Recorder running in the Docker container. If you want to terminate the application gracefully, just press Ctrl+C to stop the execution of DDS Recorder.