overlord

module
v1.5.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 2, 2019 License: MIT

README

Overlord

Build Status GoDoc codecov Go Report Card

Overlord is a proxy based high performance Memcached and Redis solution written in Go.
It is fast and lightweight and used primarily to horizontally scale your distributed caching architecture.
It is inspired by Twemproxy,Codis.

Quick Start

Download
cd $GOPATH/src
git clone https://github.com/felixhao/overlord.git
Build
cd $GOPATH/src/overlord/cmd/proxy
go build
Run
./proxy -cluster=proxy-cluster-example.toml
Please first run a memcache or redis server, which bind 11211 or 6379 port.
Test
# test memcache
echo -e "set a_11 0 0 5\r\nhello\r\n" | nc 127.0.0.1 21211
# STORED
echo -e "get a_11\r\n" | nc 127.0.0.1 21211
# VALUE a_11 0 5
# hello
# END

# test redis
python ./scripts/validate_redis_features.py # require fakeredis==0.11.0 redis==2.10.6 gevent==1.3.5

Congratulations! You've just run the overlord proxy.

Features

  • support memcache protocol
  • support redis&cluster protocol
  • connection pool for reduce number to backend caching servers
  • keepalive & failover
  • hash tag: specify the part of the key used for hashing
  • promethues stat metrics support
  • cache backup
  • hot reload: add/remove cache node
  • QoS: limit/breaker
  • L1&L2 cache
  • hot|cold cache
  • broadcast
  • cache node scheduler

Architecture

architecture

Contributing

Overlord is probably not perfect, but you are welcome to use it in your dev/test/product and so please let me know if anything feels wrong or incomplete.
I'm trying very hard to keep it simple and fast. And I always happy to receive pull requests. It follow the gitflow, please send you pull request to develop branch.

Directories

Path Synopsis
cmd
lib
log
net

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL