eclipse-zenoh / Zenoh
Programming Languages
Projects that are alternatives of or similar to Zenoh
Eclipse zenoh
The Eclipse zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
Eclipse zenoh /zeno/ unifies data in motion, data in-use, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks.
Check the website zenoh.io for more detailed information.
How to build it
Install Cargo and Rust. Currently, zenoh requires a nightly version of Rust, type the following to install it after you have followed the previous instructions:
$ rustup default nightly
And then build zenoh with:
$ cargo build --release --all-targets
How to test it
For convenience, the zenoh router is pre-build and made available in a Docker image: https://hub.docker.com/r/eclipse/zenoh
Thus, run it just doing:
docker pull eclipse/zenoh:latest
docker run --init -p 7447:7447/tcp -p 7447:7447/udp -p 8000:8000/tcp eclipse/zenoh:latest
The ports used by zenoh are the following:
- 7447/tcp : the zenoh protocol via TCP
- 7447/udp : the zenoh scouting protocol using UDP multicast (for clients to automatically discover the router)
- 8000/tcp : the zenoh REST API
All the examples are compiled into the target/release/examples
directory. They can all work in peer-to-peer, or interconnected via the zenoh router (target/release/zenohd
).
Then, you can test it using the zenoh API in your favorite language:
- Rust using the zenoh crate and the examples in this repo
- Python using zenoh-python
Or with the REST API:
Examples of usage with the REST API
The complete Eclipse zenoh's key/value space is accessible through the REST API, using regular HTTP GET, PUT and DELETE methods. In those examples, we use the curl command line tool.
Managing the admin space
- Get info of the local zenoh router:
curl http://localhost:8000/@/router/local
- Get the backends of the local router (only memory by default):
curl 'http://localhost:8000/@/router/local/**/backend/*'
- Get the storages of the local router (none by default):
curl 'http://localhost:8000/@/router/local/**/storage/*'
- Add a memory storage on
/demo/example/**
:curl -X PUT -H 'content-type:application/properties' -d 'path_expr=/demo/example/**' http://localhost:8000/@/router/local/plugin/storages/backend/memory/storage/my-storage
Put/Get into zenoh
Assuming the memory storage has been added, as described above, you can now:
- Put a key/value into zenoh:
curl -X PUT -d 'Hello World!' http://localhost:8000/demo/example/test
- Retrieve the key/value:
curl http://localhost:8000/demo/example/test
- Remove the key value
curl -X DELETE http://localhost:8000/demo/example/test