Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

consul_kv (2) Versions 1.1.0

LWRP for interacting with Consul Key/Value store

Berkshelf/Librarian
Policyfile
Knife
cookbook 'consul_kv', '~> 1.1.0'
cookbook 'consul_kv', '~> 1.1.0', :supermarket
knife cookbook site install consul_kv
knife cookbook site download consul_kv
README
Dependencies
Changelog
Quality

Consul Kv

Build Status

This cookbook exposes the consul_kv LWRP which can be used to create/update/delete Key/Value entries in an idempotent manner.

Requirements

The cookbook has no direct dependencies, but it is assumed you are already have a working Consul installation.

Usage

Ensure you add depends 'consul_kv' to your cookbook's metadata.rb. With that dependency in place you can then leverage the LWRP in your own cookbooks.

This cookbook does no't provide any recipes, it exists solely to deliver the Key/Value LWRP.

Here are a few examples:

This example will create a new key at my/key with a value of hello world, using the Consul HTTP available on the local machine running on the default port of 8500

consul_kv 'test' do
  path 'my/key'
  value 'hello world'
  consul_addr '127.0.0.1:8500'
end

Actions

The following actions are supported by the consul_kv LWRP:

  • :create - Creates the key if it does not already exist. If the key already exists and is a different value, the existing value will be replaced by the requested value. This is the default action
  • :delete - Deletes an existing key

Attributes

The following attributes are supported by the LWRP:

  • path The key path/name at which the value will be created/deleted
    • type - String
    • required - true
  • value The value to be set in Key/Value store
    • type - String
    • required - Only for the :create action. This can be omitted for the :delete action
  • consul_addr - The address to the Consul HTTP API.
    • type - String
    • required - false
    • default - 127.0.0.1:8500
  • token - The ACL token to access to Consul HTTP API.
    • type - String
    • required - false

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Testing

This cookbook currently uses test-kitchen along with ChefSpec.

Test Kitchen: kitchen test

ChefSpec: bundle exec rspec

Releasing

This cookbook uses an 'even number' release strategy. The version number in master will always be an odd number indicating development, and an even number will be used when an official build is released.

Come release time here is the checklist:

  • Ensure the metadata.rb reflects the proper even numbered release
  • Ensure there is a dated change log entry in CHANGELOG.md
  • Commit all the changes
  • Use stove to release (bundle exec stove)
  • Bump the version in metadata.rb to the next patch level odd number

Authors

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

consul_alerts Applicable Versions

Consul Kv Cookbook Changes

v1.10.0 (Jul 19, 2016)

  • #2 - Add support for ACL tokens

v1.0.0 (Nov 8, 2014)

Initial Release

Collaborator Number Metric
            

1.1.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.1.0 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
            

1.1.0 passed this metric

License Metric
            

1.1.0 failed this metric

consul_kv does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

1.1.0 passed this metric

Publish Metric
            

1.1.0 failed this metric

consul_kv is up for adoption

Supported Platforms Metric
            

1.1.0 failed this metric

consul_kv should declare what platform(s) it supports.

Testing File Metric
            

1.1.0 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
            

1.1.0 passed this metric