cookbook 'partial_search', '~> 1.0.9'
The partial_search cookbook has been deprecated
Author provided reason for deprecation:
The partial_search cookbook has been deprecated and is no longer being maintained by its authors. Use of the partial_search cookbook is no longer recommended.
partial_search (6) Versions 1.0.9 Follow15
Provides experimental interface to partial search API in Chef Software Hosted Chef for Chef-Client pre-12.0
cookbook 'partial_search', '~> 1.0.9', :supermarket
knife supermarket install partial_search
knife supermarket download partial_search
Partial Search Cookbook
Partial Search
is a search API available on Chef Server. (see Notes below for version compatibility)
It can be used to reduce the network bandwidth and the memory used by
chef-client to process search results.
This cookbook provides an experimental interface to the partial search
API by providing a partial_search
method that can be used instead of
the search
method in your recipes.
The partial_search
method allows you to retrieve just the attributes
of interest. For example, you can execute a search to return just the
name and IP addresses of the nodes in your infrastructure rather than
receiving an array of complete node objects and post-processing them.
NOTE: Since Chef Client 12.0 the partial_search capability has been built-in
so it does not require this cookbook.
Install
Upload this cookbook and include it in the dependencies of any
cookbook where you would like to use partial_search
.
Usage
When you call partial_search
, you need to specify the key paths of the
attributes you want returned. Key paths are specified as an array
of strings. Each key path is mapped to a short name of your
choosing. Consider the following example:
partial_search(:node, 'role:web', :keys => { 'name' => [ 'name' ], 'ip' => [ 'ipaddress' ], 'kernel_version' => [ 'kernel', 'version' ] } ).each do |result| puts result['name'] puts result['ip'] puts result['kernel_version'] end
In the example above, two attributes will be extracted (on the
server) from the nodes that match the search query. The result will
be a simple hash with keys 'name' and 'ip'.
Notes
We would like your feedback on this feature and the interface
provided by this cookbook. Please send comments to the chef-dev
mailing list.The partial search API is available in the Open Source Chef Server since 11.0.4
The partial search API is available in Enterprise Chef Server since 1.2.2
License & Authors
- Author:: Adam Jacob (adam@chef.io)
- Author:: John Keiser (jkeiser@chef.io)
Copyright:: 2012-2015, Chef Software, Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
partial_search Cookbook CHANGELOG
This file is used to list changes made in each version of the partial_search cookbook.
v1.0.9 (2015-10-21)
- Updated description to clarify that this cookbook is no longer needed for chef-client 12.0
- Updated .gitignore file
- Added .foodcritic file to exclude rules that don't apply
- Added Test Kitchen config
- Added Chef standard Rubocop config
- Added Travis CI testing to use Chef DK
- Added Berksfile
- Added Gemfile with the latest development dependencies
- Updated contributing and testing docs
- Added maintainers.md and maintainers.toml files
- Added Travis and cookbook version badges to the readme
- Updated Opscode -> Chef Software
- Added a Rakefile for simplified testing
- Added a Chefignore file
- Resolved Rubocop warnings
- Added source_url and issues_url to the metadata
- Added basic convergence Chefspec test
v1.0.8 (2014-02-25)
- [COOK-4260] Update compatibility in README.md
v1.0.6
- Hotfix - Revert client-side caching bug
v1.0.4
New Feature
- COOK-2584 - Add client-side result cache
v1.0.2
Bug
- [COOK-3164]:
partial_search
should useChef::Config[:chef_server_url]
instead ofsearch_url
v1.0.0
- Initial release
Collaborator Number Metric
1.0.9 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
1.0.9 failed this metric
Contributing File Metric
1.0.9 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
1.0.9 failed this metric
Foodcritic Metric
1.0.9 passed this metric
1.0.9 passed this metric
No Binaries Metric
1.0.9 passed this metric
1.0.9 passed this metric
Testing File Metric
1.0.9 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
1.0.9 failed this metric
Version Tag Metric
1.0.9 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
1.0.9 failed this metric