Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/facebook/mcrouter
Mcrouter is a memcached protocol router for scaling memcached deployments.
https://github.com/facebook/mcrouter
Last synced: 2 days ago
JSON representation
Mcrouter is a memcached protocol router for scaling memcached deployments.
- Host: GitHub
- URL: https://github.com/facebook/mcrouter
- Owner: facebook
- License: mit
- Created: 2014-01-24T17:42:42.000Z (almost 11 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T15:03:32.000Z (about 1 month ago)
- Last Synced: 2024-10-29T15:17:10.827Z (about 1 month ago)
- Language: C++
- Homepage:
- Size: 31.7 MB
- Stars: 3,261
- Watchers: 252
- Forks: 535
- Open Issues: 112
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-repositories - facebook/mcrouter - Mcrouter is a memcached protocol router for scaling memcached deployments. (C++)
- awesome-starred - facebook/mcrouter - Mcrouter is a memcached protocol router for scaling memcached deployments. (others)
README
# Mcrouter [](https://github.com/facebook/mcrouter/actions?workflow=build)
[](https://opensource.fb.com/support-ukraine) [](https://github.com/facebook/mcrouter/blob/master/LICENSE)
Mcrouter (pronounced mc router) is a memcached protocol router for scaling [memcached](https://memcached.org/)
deployments. It's a core component of cache
infrastructure at Facebook and Instagram where mcrouter handles almost
5 billion requests per second at peak.
Mcrouter is developed and maintained by Facebook.
See https://github.com/facebook/mcrouter/wiki to get started.
## Quick start guide
### New! Ubuntu package available
Currently, we support Ubuntu Bionic (18.04) amd64.
Here is how to install it:
Add the repo key:
$ wget -O - https://facebook.github.io/mcrouter/debrepo/bionic/PUBLIC.KEY | sudo apt-key add
Add the following line to apt sources file /etc/apt/sources.list
deb https://facebook.github.io/mcrouter/debrepo/bionic bionic contrib
Update the local repo cache:
$ sudo apt-get update
Install mcrouter:
$ sudo apt-get install mcrouter
### Installing From Source
See https://github.com/facebook/mcrouter/wiki/mcrouter-installation for more
detailed installation instructions.
Mcrouter depends on [folly](https://github.com/facebook/folly), [wangle](https://github.com/facebook/wangle), [fizz](https://github.com/facebookincubator/fizz), and [fbthrift](https://github.com/facebook/fbthrift).
The installation is a standard autotools flow:
$ autoreconf --install
$ ./configure
$ make
$ sudo make install
$ mcrouter --help
Assuming you have a memcached instance on the local host running on port 5001,
the simplest mcrouter setup is:
$ mcrouter \
--config-str='{"pools":{"A":{"servers":["127.0.0.1:5001"]}},
"route":"PoolRoute|A"}' \
-p 5000
$ echo -ne "get key\r\n" | nc 0 5000
(nc is the GNU Netcat, http://netcat.sourceforge.net/)
## Features
+ Memcached ASCII protocol
+ Connection pooling
+ Multiple hashing schemes
+ Prefix routing
+ Replicated pools
+ Production traffic shadowing
+ Online reconfiguration
+ Flexible routing
+ Destination health monitoring/automatic failover
+ Cold cache warm up
+ Broadcast operations
+ Reliable delete stream
+ Multi-cluster support
+ Rich stats and debug commands
+ Quality of service
+ Large values
+ Multi-level caches
+ IPv6 support
+ SSL support
## Links
Documentation: https://github.com/facebook/mcrouter/wiki
Engineering discussions and support: https://www.facebook.com/groups/mcrouter
## License
Copyright (c) Facebook, Inc. and its affiliates.
Licensed under the MIT license:
https://github.com/facebook/mcrouter/blob/master/LICENSE