Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Zoodiscovery
Contents
What is ZooDiscovery?
ZooDiscovery is a discovery mechanism that runs as an OSGi service. It leverage Apache ZooKeeper robustness and implements Eclipse ECF Discovery API.(Hence the name!). ZooDiscovery is flexible and easy to configure.
Download
The concept in some words
ZooDiscovery implements both ECF discovery interfaces: IDiscoveryAdvertiser and IDiscoveryLocator. That is, ZooDiscovery can publish our services and gets us noticed about discovered services. Perfect! But how?
A ZooDiscovery instance running at your machine does its job by exchanging data with other ZooDiscovery instance(s) running elsewhere. So each running ZooDiscovety service must know where that other "elsewhere" exactly is. This is why we should first make our ZooDiscovery happy, giving it an IP address to play with.
To keep it smooth, let's take it step by step following these cases:
Learn by asking
How to get ZooDiscovery service?
IContainer container = null; try { //"ecf.discovery.zookeeper" is the name of container we want to initiate container = ContainerFactory.getDefault().createContainer("ecf.discovery.zookeeper"); } catch(ContainerCreateException e1){ // TODO } //Build a target to connect to. Please replace with usable IP address(es). A comma separated list of ip's is also valid. //Something like: "discovery.flavor.standalone=192.1.32.10,192.1.32.11" means our ZooDiscovery instance will connect to both address 172.17.2.17 and 172.17.2.19 //where other ZooDiscovery services are running. ID serverId = container.getConnectNamespace().createInstance( new String[] { "discovery.flavor.standalone=192.1.32.10" }); try { //we then connect to other instance of container.connect(serverId, null); } catch (ContainerConnectException e1) { // TODO }
How to publish/advertise my services
I want ZooDiscovery publishing my OSGi services without me interfering
IContainer container = null; try { container = ContainerFactory.getDefault().createContainer("ecf.discovery.zookeeper"); } catch(ContainerCreateException e1){ // TODO } ID serverId = container.getConnectNamespace().createInstance( new String[] { "discovery.flavor.standalone=172.17.2.219","discovery.publish.auto=true" }); try { container.connect(serverId, null); } catch (ContainerConnectException e1) { // TODO }
Automatically publishing your sevices is as easy as adding this property: "discovery.publish.auto=true".