zetcd

Serve the Apache Zookeeper API but back it with an etcd cluster

  • Owner: etcd-io/zetcd
  • Platform:
  • License:: Apache License 2.0
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

zetcd

Build Status

A ZooKeeper "personality" for etcd. Point a ZooKeeper client at zetcd to dispatch the operations on an etcd cluster.

Protocol encoding and decoding heavily based on go-zookeeper.

Getting started

Running zetcd

Forward ZooKeeper requests on :2181 to an etcd server listening on localhost:2379:

go get github.com/etcd-io/zetcd/cmd/zetcd
zetcd --zkaddr 0.0.0.0:2181 --endpoints localhost:2379

Simple testing with zkctl:

go get github.com/etcd-io/zetcd/cmd/zkctl
zkctl watch / &
zkctl create /abc "foo"

Running zetcd on Docker

Official docker images of tagged zetcd releases for containerized environments are hosted at quay.io/etcd-io/zetcd. Use docker run to launch the zetcd container with the same configuration as the go get example:

docker run --net host -t quay.io/etcd-io/zetcd -endpoints localhost:2379

Cross-checking

In cross-checking mode, zetcd dynamically tests a fresh isolated "candidate" zetcd cluster against a fresh isolated ZooKeeper "oracle" cluster for divergences. This mode dispatches requests to both zetcd and ZooKeeper, then compares the responses to check for equivalence. If the responses disagree, it is flagged in the logs. Use the flags -zkbridge to configure a ZooKeeper endpoint and -oracle zk to enable checking.

Cross-check zetcd's ZooKeeper emulation with a native ZooKeeper server endpoint at localhost:2182 like so:

zetcd --zkaddr 0.0.0.0:2181 --endpoints localhost:2379 --debug-zkbridge localhost:2182  --debug-oracle zk --logtostderr -v 9

Contact

Contributing

See CONTRIBUTING for details on submitting patches and the contribution workflow.

License

zetcd is under the Apache 2.0 license. See the LICENSE file for details.

Overview

Name With Owneretcd-io/zetcd
Primary LanguageGo
Program languageGo (Language Count: 5)
Platform
License:Apache License 2.0
Release Count5
Last Release Namev0.0.5 (Posted on 2018-05-22 12:55:50)
First Release Namev0.0.1 (Posted on )
Created At2016-10-24 16:49:01
Pushed At2023-09-25 12:46:07
Last Commit At2023-09-25 08:46:07
Stargazers Count1.1k
Watchers Count49
Fork Count90
Commits Count139
Has Issues Enabled
Issues Count65
Issue Open Count30
Pull Requests Count47
Pull Requests Open Count4
Pull Requests Close Count8
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top