Install mcrouter and its dependencies, and provide mechanisms to configure and start mcrouter.
This cookbook can, optionally, install a copy of memcached to use locally. This can be disabled by setting node['mcrouter']['local_memcached']
to false.
apt
cookbookyum
cookbookyum-epel
cookbookmemcached
cookbookmagic
cookbookmagic_shell
cookbooksystemd
cookbook
The following platforms are supported and tested with Test Kitchen:
- Ubuntu 16.04
- CentOS 7.2
- CentOS 7.3
- Chef 12.7+
- Include
mcrouter::default
in your node’s run list.
If you wish to customize any of the configuration for mcrouter, you will want to edit the two attributes used to populate the config file and the CLI arguments passed to mcrouter
on service start:
node['mcrouter']['cli_opts']
- Do not overwrite this completely; the values specified already are required, instead, either:
- supply updated values for these in addition to your new options
- specify your particular CLI option:
set['mcrouter']['cli_opts']['async-dir']
- Do not overwrite this completely; the values specified already are required, instead, either:
node['mcrouter']['config']
- See configuration options at mcrouter wiki.node['mcrouter']['install_type']
- Set to'package'
to install from pre-compiled binaries
-
node['mcrouter']['install_dir'] - Installation path of mcrouter
-
node['mcrouter']['user'] - User that mcrouter will run as
-
node['mcrouter']['version-branch'] - The latest release branch from Mcrouter repo.
-
node['mcrouter']['double_conversion_commit_hash'] - Double conversion commit hash to be checked out from double-conversion library. This is also hard coded in mcrouter build scripts.
-
node['mcrouter']['folly_commit_hash'] - Folly commit hash to be checkout out. This comes from mcrouter release branch
-
node['mcrouter']['wangle_commit_hash'] - Wangle commit hash to be checkout out. This comes from mcrouter release branch
-
node['mcrouter']['local_memcached'] - Enable a local installation of memcache.
true
by default. -
node['memcached']['port'] - Configure memcached port. This are overrides of memcached cookbook
-
node['memcached']['udp_port'] - Configure memcached udp port. This are overrides of memcached cookbook
-
node['mcrouter']['cli_opts'] - Collection of of hashes that will be passed to
mcrouter
on start. You can see the whole list here -
node['mcrouter']['config'] - This will become mcrouter configuration file. You can read more at Config Files on mcrouter wiki
Author:: EverTrue, Inc. ([email protected])