- Download & Extract - You can find the latest release of Shotover Proxy at our GitHub release page. So download and extract from there onto your Linux machine. Alternatively you can build and run from source.
- Run - cd into the extracted
shotoverfolder and run
./shotover-proxy. Shotover will launch and display some logs.
- Examine Config - Shotover has two configuration files:
config/config.yaml- This is used to configure logging and metrics.
config/topology.yaml- This defines how Shotover receives, transforms and delivers messages.
- Configure topology - Open
topology.yamlin your text editor and edit it to define the sources and transforms you need, the comments in the file will direct you to suitable documentation. Alternatively you can refer to the Deployment Scenarios section for full
- Rerun - Shotover currently doesn't support hot-reloading config, so first shut it down with ctrl-c. Then rerun
./shotover-proxyfor your new config to take effect.
- Test - Send a message to Shotover as per your configuration and observe it is delivered to it's configured destination database.
To see Shotover's command line arguments run:
topology.yaml examples configured for a specific use case: