cookbook 'mcrouter', '~> 3.0.1'
mcrouter (7) Versions 3.0.1 Follow1
Installs/Configures mcrouter
cookbook 'mcrouter', '~> 3.0.1', :supermarket
knife supermarket install mcrouter
knife supermarket download mcrouter
mcrouter
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.
Requirements
Cookbooks
-
memcached
cookbook -
magic
cookbook
Platforms
The following platforms are supported and tested with Test Kitchen:
- Ubuntu 16.04
- Ubuntu 18.04
Chef
- Chef 12.11+
Usage
- 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:
default['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.
Attributes
node['mcrouter']['user']
- User that mcrouter will run asnode['mcrouter']['local_memcached']
- Enable a local installation of memcache.true
by default.node['memcached']['port']
- Configure memcached port. This are overrides of memcached cookbooknode['memcached']['udp_port']
- Configure memcached udp port. This are overrides of memcached cookbooknode['mcrouter']['cli_opts']
- Collection of hashes that will be passed tomcrouter
on start. You can see the whole list herenode['mcrouter']['config']
- This will become mcrouter configuration file. You can read more at Config Files on mcrouter wiki
Authors
Author:: EverTrue, Inc. devops@evertrue.com
Author:: Jeff Byrnes thejeffbyrnes@gmail.com
Dependent cookbooks
build-essential >= 0.0.0 |
magic ~> 1.5 |
memcached ~> 5.1 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
CHANGELOG for mcrouter
[v3.0.1] (2019-03-26)
- Fix CHANGELOG to accurately reflect v3.0.0
[v3.0.0] (2019-03-26)
Breaking changes:
- Drop source-based installation in favor of APT package installation
- Drop support for Ubuntu 14.04
- Switch to SystemD for the mcrouter service
Changes:
- Add support for Ubuntu 16.04 & Ubuntu 18.04
[v2.0.2] (2015-12-15)
Fixes:
- Delete only build subdirectory (so that ark does not run twice)
[v2.0.1] (2015-12-07)
Fixes:
- Updated test kitchen file format
- Re-order build/install ops so that build dirs are always deleted
[v2.0.0] (2015-08-17)
Breaking changes:
- Folly version updated to v0.53.0
- This is now adjustable via an attribute,
node['folly']['version']
- This is now adjustable via an attribute,
- Mcrouter version set to v0.5.0
- This is now adjustable via an attribute,
node['mcrouter']['version']
- This is now adjustable via an attribute,
Fixes
- Packages needed for Folly/Mcrouter updated as per most recent Folly/Mcrouter docs
[v1.0.1] (2015-07-15)
Fixes:
- Add dependency package: libssl-dev
[v1.0.0] (2015-07-09)
Breaking changes:
-
['mcrouter']['src_dir']
no longer determines build location (that is now:file_cache_path
), and as a result... - Builds are now done in
:file_cache_path
instead of/opt
-
mcrouter::folly
is now included bymcrouter::install
Changes:
- Vastly clean up the install process (e.g. now using
ark
for source install)- Stopped installing gtest
- Pruned Apt package install list
- Use
./configure
defaults rather than specifying a zillion environment variables - Just do
make install
for mcrouter and use the default install location (rather than linking/usr/local/bin/mcrouter -> node['mcrouter']['install_dir']/bin/mcrouter
) - Just install
build-essentials
with the cookbook rather than devoting half the cookbook to setting up the build system - Break package installs out into
_deps
recipe
- Folly and McRouter now delete their build directories once they're finished installing
- Update the README
- Clean up the Upstart script a bit
Fixes:
- Run
ldconfig
aftermake install
on folly (addresses "library not found" issue with mcrouter)
[v0.2.2] (2015-02-28)
Fixes:
- Subscribed
service[mcrouter]
to its own service script to restart on any changes to its CLI options
[v0.2.1] (2015-02-25)
Fixes:
- Updated, clarified README
[v0.2.0] (2015-02-25)
Fixes:
- Replace missed hard-coded ownership settings with
node['mcrouter']['user']
Changes:
- Switch from hard-coded CLI flags to an hash attribute-driven system, utilizing the
magic
cookbook
[v0.1.0] (2015-02-24)
Fixes:
- Fix paths for dependent libraries for
mcrouter
build - Ensure dirs needed for
mcrouter
exist - Fix test assertion for
mcrouter
config
Changes:
- Parameterize paths for folly & mcrouter
- Makes for simpler configuration of builds
- Fix path to optionally-installed double-conversion lib
- Install & configure
memcached
to start on port 11811-
mcrouter
needs an instance ofmemcached
somewhere to talk to; simplest thing is to just install it locally
-
- Set up an Upstart service to manage
mcrouter
[v0.0.1] (2015-02-19)
Changes:
- Initial release:
- Builds & installs mcrouter
Collaborator Number Metric
3.0.1 passed this metric
Contributing File Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
3.0.1 failed this metric
FC121: Cookbook depends on cookbook made obsolete by Chef 14: mcrouter/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
3.0.1 passed this metric
Testing File Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
3.0.1 passed this metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
3.0.1 failed this metric
FC121: Cookbook depends on cookbook made obsolete by Chef 14: mcrouter/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
3.0.1 passed this metric
Testing File Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
3.0.1 failed this metric
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
3.0.1 passed this metric
Testing File Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
3.0.1 failed this metric
3.0.1 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number