Skip to main content
Kinetic Community

Chef Adapter

Overview

The Chef Adapter is an adapter that is installed into Kinetic Bridgehub that allows data from Chef to be pulled back using bridging. The Chef software is used to streamline the task of configuring & maintaining a company's servers, and can integrate with cloud-based platforms to automatically provision and configure new machines.

Installation

Note: Check to ensure that this adapter isn't already installed into your bridgehub as part of the base installation before undertaking the installation tasks.

  • Download the kinetic-bridges-adapter-chef.jar file and it's dependencies here
  • Put all of the downloaded files into the WEB-INF/lib folder for you kinetic-bridgehub installation
  • Restart the tomcat that your kinetic-bridgehub installation is located in
  • Included with default kinetic-bridgehub installation starting with v1.2.0

Setup

Configuration Values

Name Description
Username Username of an account with access to the Chef Server
Pem Input Type Choices for how to load the user's PEM file: On File System, File Content
Pem Location A file system path pointing to a copy of the configured username's .pem file
Pem Content The full contents of the configured username's .pem file
API Endpoint Can be found in the URL (the whole URL up until the organization name) when viewing Chef in the browser

Example Configuration

Name Value
Username test.user
Pem Input Type File Content
Pem Location  
Pem Content -----BEGIN RSA PRIVATE KEY-----
MIIEogIBAAKCAQEAu6qum6wkA+o3xFzCprHL66XHwGPzng
OyMN+Fgd4hu21iwEr51lNGHXHIan/1d6Z6rmQ4E3mtfGX+Jg
...
-----END RSA PRIVATE KEY-----
API Endpoint https://api.opscode.com/organizations/acme

Configuration Details

For more information on how to get a user's private key (.pem file) from Chef

https://docs.chef.io/chef_private_keys.html

Structures, Fields, and Queries

Structures

  • Cookbooks
  • Nodes
  • Recipes

Fields

  • All the structures can be searched with an empty field set to return all possible fields
  • Cookbooks
    • name, version, recipes, definitions, libraries, attributes, files, templates, resources, providers, root_files, chef_type, cookbook_name, frozen?, json_class, metadata
  • Nodes
    • name, url, chef_environment, json_class, automatic, normal, chef_type, default, override, run_list
  • Recipes
    • name, versionRange

Queries

  • All the structures support searching (client-side) on the text of the field values with the '%' character as a wildcard
  • Cookbooks
    • nodeName=name to search for a list of cookbooks on a specific node
    • version=_latest to return only the latest versions of the cookbooks on the server
  • Nodes
    • No (server-side) querying available for this structure
  • Recipes
    • cookbookName=name&cookbookVersion=version are required to be in the query to search the recipes included in a cookbook

Pagination and Ordering

Pagination

Not supported at this time.

Ordering

This adapter supports client-side ordering of records.

Changelog

v1.0.0 (2017-11-09)

  • Initial version