coreos/zetcd

Name: zetcd

Owner: CoreOS

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

Created: 2016-10-24 16:49:01.0

Updated: 2018-05-24 17:45:52.0

Pushed: 2018-05-22 21:03:19.0

Homepage:

Size: 2528

Language: Go

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

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:

et github.com/coreos/zetcd/cmd/zetcd
d --zkaddr 0.0.0.0:2181 --endpoints localhost:2379

Simple testing with zkctl:

et github.com/coreos/zetcd/cmd/zkctl
l watch / &
l create /abc "foo"
Running zetcd on Docker

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

er run --net host -t quay.io/coreos/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:

d --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.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.