This repository provides source code for a microservice to relay Envelopes from one OD4Session to another OD4Session.
You need a C++14-compliant compiler to compile this project.
The following dependency is part of the source distribution:
- libcluon -
To run this microservice using docker-compose
, you can simply add the following
section to your docker-compose.yml
to relay only envelopes 12
and 13
from
CID 109
to CID 111
:
version: '2' # Must be present exactly once at the beginning of the docker-compose.yml file
services: # Must be present exactly once at the beginning of the docker-compose.yml file
relay-envelopes:
image: ghcr.io/chrberger/cluon-relay:latest
restart: always
network_mode: "host"
command: "--cid-from=109 --cid-to=111 --keep=12,13"
Command for commandline to display the resulting image after operations:
docker run --rm -ti --init --net=host ghcr.io/chrberger/cluon-relay:latest --cid-from=109 --cid-to=111 --keep=12,13
The parameters to the application are:
--cid-from
: relay Envelopes originating from this CID--cid-to
: relay Envelopes to this CID (must be different from source)--keep
: list of Envelope IDs to keep; example: --keep=19,25--drop
: list of Envelope IDs to drop; example: --drop=17,35--downsampling:
list of Envelope IDs to downsample; example:--downsample=12:2,31:10
keep every second of 12 and every tenth of 31
To build this software, you need cmake, C++14 or newer, libyuv, libvpx, and make.
Having these preconditions, just run cmake
and make
as follows:
mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=Release ..
make && make test && make install
- This project is released under the terms of the GNU GPLv3 License