chef-ingredient Cookbook

This cookbook provides primitives - helpers and resources - to manage Chef Software, Inc.'s products and add-ons including, but not limited to:

Chef Server 12
Chef Analytics
Chef Automate
Chef Automate v2
Chef Push
Supermarket

This cookbook also provides primitives for building and managing your Chef infrastructure.

It will perform component installation and configuration. It provides no recipes. Instead, wrapper cookbooks should be created using the resources that this cookbook provides.

Requirements

Platforms

Ubuntu 16.04+
Debian 8+
CentOS/RHEL 6, 7, 8
openSUSE
Amazon Linux

Chef

Chef 13+

Cookbooks

none

Chef Product Resources

chef_ingredient

A "chef ingredient" is the core package itself, or products or add-on components published by Chef Software, Inc. This resource manages the installation, configuration, and running the ctl reconfigure of individual packages.

By default, chef_ingredient will install using the packages.chef.io stable repository depending on the platform. However, it can be configured to use a custom repository by setting the node['chef-ingredient']['custom-repo-recipe'] attribute (nil by default).

Actions

install - (default) Configures the package repository and installs the specified package.
upgrade - Upgrades the specified package.
uninstall - Uninstalls the specified package.
remove - Alias for uninstall
reconfigure - Performs the ctl reconfigure command for the package.

Properties

product_name - The product name. See the PRODUCT_MATRIX.md. For example, chef-server, analytics, delivery, manage, etc.
config - content that will be added to the configuration file of the given product.
ctl_command - The "ctl" command, e.g., chef-server-ctl. This should be automatically detected by the library helper method chef_ctl_command, but may need to be specified if something changes, like a new add-on is made available.
options - Options passed to the package resource used for installation.
version - Package version to install. Can be specified in various semver-alike ways: 12.0.4, 12.0.3-rc.3, and also :latest/'latest'. Do not use this property when specifying package_source.
channel - Channel to install the products from. It can be :stable, :current or :unstable.
package_source - Full path to a location where the package is located. If present, this file is used for installing the package.
timeout - The amount of time (in seconds) to wait to fetch the installer before timing out. Default timeout of the Chef package resource is 900 seconds.
accept_license - A boolean value that specifies if license should be accepted if it is asked for during reconfigureaction. This option is applicable to only these products: manage, analytics, reporting and compliance.
platform - Override the auto-detected platform for which package to install.
platform_version - Override the auto-detected platform version for which package to install.
architecture - Override the auto-detected architecture for which package to install.
platform_version_compatibility_mode - Find closest matching package when platform auto-detection does not find an exact package match in the repository.

omnibus_service

Manages a sub-service within the context of a Chef product package. For example the rabbitmq service that is run for the Chef Server.

Actions

This delegates to the ctl command the service management command specified in the action. Not all the service management commands are supported, however, as not all of them would make sense when used in a recipe. This resource is primarily used for sending or receiving notifications. See the example section.

Properties

service_name - The name of the service to manage. Specify this like product_name/service, for example, chef-server/rabbitmq.
ctl_command - The "ctl" command, e.g. chef-server-ctl. This should be automatically detected by the library helper method chef_ctl_command, but may need to be specified if something changes, like a new add-on is made available.

ingredient_config

Makes it easy to create update configuration files of each Chef product. It uses the default locations for each product.

Actions

render - (default) Creates the configuration file using the options passed in via add action or config attribute of chef_ingredient resource.
add - Adds the config attribute contents to the data collection. Must run :render action to generate the file.

Properties

product_name - The product name. See the PRODUCT_MATRIX.md. For example, chef-server, analytics, delivery, manage, etc.
config - Content that will be added to the configuration file of the given product.
sensitive - Set to mask the config contents in logs. Use when you config contains information like passwords or secrets.

Examples

We may need to restart the RabbitMQ service on the Chef Server, for example when adding configuration for Chef Analytics.

template '/etc/opscode/chef-server.rb' do
  notifies :restart, 'omnibus_service[chef-server-core/rabbitmq]'
end

omnibus_service 'chef-server-core/rabbitmq' do
  action :nothing
end

To install Chef Server using some custom configuration options:

chef_ingredient "chef-server" do
  config <<-EOS
api_fqdn "#{node["fqdn"]}"
ip_version "ipv6"
notification_email "#{node["chef_admin"]}"
nginx["ssl_protocols"] = "TLSv1 TLSv1.1 TLSv1.2"
EOS
  action :install
end

ingredient_config "chef-server" do
  notifies :reconfigure, "chef_ingredient[chef-server]"
end

To install or upgrade latest version of Chef Client on your nodes:

chef_ingredient "chef" do
  action :upgrade
  version :latest
end

To install an add-on of Chef Server from :current channel:

chef_ingredient 'chef-server' do
  channel :stable
  action :install
end

chef_ingredient 'analytics' do
  channel :current
  action :install
end

Chef Infrastructure Resources

General Properties

These properties exist for all infrastructure resources

name - A name for the resource.
channel - The channel from our package repository to install. Most of the time you want stable.
version - The version of Automate you want to install.
config - The configuration that will be written to the appropriate configuration file for the product.
accept_license - Do you accept Chef's license agreements.
platform - Use only if you need to over-ride the default platform.
platform_version - Use only if you need to over-ride the default platform.

chef_automate

Installs Chef Automate.

Properties

enterprise - The Enterprise to create in Automate
license - we recommend using the chef_file resource
chef_user - The user you will connect to the Chef server as
chef_user_pem - The private key of the above Chef user
validation_pem - The validator key of the Chef org we're connecting to
builder_pem - The private key of the build nodes

chef_automatev2

Installs Chef Automate version 2

Requirements

Requires chef-client 14+ due to use of sysctl resource
General Properties used

chef_backend

Properties

bootstrap_node - The node we'll bootstrap secrets with.
publish_address - node['ipaddress'] | The address you want Chef-Backend to listen on.
chef_backend_secrets - A location where your secrets are | we recommend using the chef_file resource.
chef_backend_secrets_user - The user that owns the file created by the chef_backend_secrets attribute
chef_backend_secrets_group - The group that owns the file created by the chef_backend_secrets attribute

chef_org

Properties

org - The short name of the org.
org_full_name - The full name of the org you want to create.
admins - An array of admins for the org.
users - An array of users for the org.
remove_users - An array of users to remove from the org.
key_path - Where to store the validator key that is created with the org.

chef_user

username - The username of the user.
first_name - The first name of the user.
last_name - The last name of the user.
email - The users e-mail.
password - The users password.
key_path - Where to store the users private key that is created with the user.
serveradmin - Is the user a serveradmin?

chef_client

node_name - The name of the node.
version - The version of chef-client to install.
chefdk - Do you want to install chefdk?
chef_server_url - What is the Chef server URL to connect to.
ssl_verify - Validate ssl certificates?
log_location - Where to log.
log_level - Log level.
config - Any configuration for client.rb.
run_list - The clients runlist.
environment - Which Chef Environment the client belongs to.
validation_pem - The validation pem to validate with.
validation_client_name - The validation client name.
tags - Any tags for the node.
interval - The interval to run chef-client on.
splay - The randomization to add to the interval.
data_collector_token - The data collector token to talk to Visibility.
data_collector_url - The Visibility URL to send data.

chef_file

filename - The name of the resource.
source - The source of the file.
user - The owner of the file.
group - The group owner of the file.
mode - The mode for the file.

chef_server

addons - A set of add-ons to install with the Chef Server.
data_collector_token - The data collector token to authenticate with Chef Visiblity.
data_collector_url - The URL to connect to Visibility.

chef_supermarket

chef_server_url - The Chef server's URL.
chef_oauth2_app_id - The oauth2 app id from the Chef server.
chef_oauth2_secret - The oauth2 secret from the Chef server.
chef_oauth2_verify_ssl - Whether to validate SSL certificates.

workflow_builder

pj_version - The version of Push-Jobs to install.
chef_user - The Chef user to authenticate with the Chef Server.
chef_user_pem - The private key of the Chef user to authenticate with the Chef Server.
builder_pem - The builder users private key to communicate with Chef Automate.
chef_fqdn - The FQDN of the Chef server.
automate_fqdn - The FQDN of the automate server.
supermarket_fqdn - The FQDN of the Supermarket server.
job_dispatch_version - Which job dispatch version to use. V1 is push-jobs, V2 is SSH runners.
automate_user - What is the Automate user we're connecting to Automate as.
automate_password - The password for the user above.
automate_enterprise - The Enterprise to connect to.
chef_config_path - The config path for chef-client.

License & Authors

Author: Joshua Timberman [email protected]
Author: Serdar Sutay [email protected]
Author: Patrick Wright [email protected]
Author: Nathan Cerny [email protected]
Author: Andy Dufour [email protected]
Author: Brandon Raabe [email protected]
Author: Jeremy J. Miller [email protected]
Author: Josh Hudson [email protected]
Author: Stephen Lauck [email protected]

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.

Name		Name	Last commit message	Last commit date
Latest commit History 502 Commits
.delivery		.delivery
.github		.github
attributes		attributes
libraries		libraries
recipes		recipes
resources		resources
spec		spec
templates		templates
test		test
.gitignore		.gitignore
.travis.yml		.travis.yml
Berksfile		Berksfile
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Guardfile		Guardfile
LICENSE		LICENSE
README.md		README.md
TESTING.md		TESTING.md
appveyor.yml		appveyor.yml
chefignore		chefignore
kitchen.appveyor.yml		kitchen.appveyor.yml
kitchen.dokken.yml		kitchen.dokken.yml
kitchen.yml		kitchen.yml
metadata.rb		metadata.rb

License

bkonick/chef-ingredient

Folders and files

Latest commit

History

Repository files navigation

chef-ingredient Cookbook

Requirements

Platforms

Chef

Cookbooks

Chef Product Resources

chef_ingredient

Actions

Properties

omnibus_service

Actions

Properties

ingredient_config

Actions

Properties

Examples

Chef Infrastructure Resources

General Properties

chef_automate

Properties

chef_automatev2

Requirements

chef_backend

Properties

chef_org

Properties

chef_user

chef_client

chef_file

chef_server

chef_supermarket

workflow_builder

License & Authors

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages