https://github.com/flier/curator.go
Golang porting for Curator
https://github.com/flier/curator.go
Last synced: over 1 year ago
JSON representation
Golang porting for Curator
- Host: GitHub
- URL: https://github.com/flier/curator.go
- Owner: flier
- License: mit
- Created: 2015-04-10T09:28:18.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-09-19T04:29:24.000Z (almost 11 years ago)
- Last Synced: 2025-03-18T05:07:09.365Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 404 KB
- Stars: 50
- Watchers: 5
- Forks: 19
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# What is Curator?
Curator n ˈkyoor͝ˌātər: a keeper or custodian of a museum or other collection - A ZooKeeper Keeper.
## What is curator.go?
Curator.go is a Golang porting for Curator, which base on the [go-zookeeper](https://github.com/samuel/go-zookeeper/).
# Getting Started
## Learn ZooKeeper
Curator.go users are assumed to know ZooKeeper. A good place to start is [ZooKeeper Getting Started Guide](http://zookeeper.apache.org/doc/trunk/zookeeperStarted.html)
## Install Curator.go
> $ go get github.com/flier/curator.go
## Using Curator
The Curator.go are available from [github.com](https://github.com/flier/curator.go). You can easily include Curator.go into your code.
```
import (
"github.com/flier/curator.go"
)
```
## Getting a Connection
Curator uses Fluent Style. If you haven't used this before, it might seem odd so it's suggested that you familiarize yourself with the style.
Curator connection instances (CuratorFramework) are allocated from the CuratorFrameworkBuilder. You only need one CuratorFramework object for each ZooKeeper cluster you are connecting to:
```
curator.NewClient(connString, retryPolicy)
```
This will create a connection to a ZooKeeper cluster using default values. The only thing that you need to specify is the retry policy. For most cases, you should use:
```
retryPolicy := curator.NewExponentialBackoffRetry(time.Second, 3, 15*time.Second)
client := curator.NewClient(connString, retryPolicy)
client.Start()
defer client.Close()
```
The client must be started (and closed when no longer needed).
## Calling ZooKeeper Directly
Once you have a CuratorFramework instance, you can make direct calls to ZooKeeper in a similar way to using the raw ZooKeeper object provided in the ZooKeeper distribution. E.g.:
```
client.Create().ForPathWithData(path, payload)
```
The benefit here is that Curator manages the ZooKeeper connection and will retry operations if there are connection problems.
## Recipes
### Distributed Lock
```
lock := curator.NewInterProcessMutex(client, lockPath)
if ( lock.Acquire(maxWait, waitUnit) )
{
defer lock.Release()
// do some work inside of the critical section here
}
```
### Leader Election
```
listener := curator.NewLeaderSelectorListener(func(CuratorFramework client) error {
// this callback will get called when you are the leader
// do whatever leader work you need to and only exit
// this method when you want to relinquish leadership
}))
selector := curator.NewLeaderSelector(client, path, listener)
selector.AutoRequeue() // not required, but this is behavior that you will probably expect
selector.Start()
```
# Examples
This module contains example usages of various Curator features. Each directory in the module is a separate example.
- [leader](examples/leader/) Example leader selector code
- [cache](examples/cache/) Example PathChildrenCache usage
- [locking](examples/locking/) Example of using InterProcessMutex
- [discovery](examples/discovery/) Example usage of the Curator's ServiceDiscovery
- [framework](examples/framework/) A few examples of how to use the CuratorFramework class
See the [examples](examples/) source repo for each example.
# Components
- [Recipes](doc/recipes.md) Implementations of some of the common ZooKeeper "recipes". The implementations are built on top of the Curator Framework.
- [Framework](doc/framework.md) The Curator Framework is a high-level API that greatly simplifies using ZooKeeper. It adds many features that build on ZooKeeper and handles the complexity of managing connections to the ZooKeeper cluster and retrying operations.
- [Utilities](doc/utilities.md) Various utilities that are useful when using ZooKeeper.
- [Client](doc/client.md) A replacement for the bundled ZooKeeper class that takes care of some low-level housekeeping and provides some useful utilities.
- [Errors](doc/errors.md) How Curator deals with errors, connection issues, recoverable exceptions, etc.