The Chef plugin provides process steps that enable you to integrate existing automation for Chef into your HCL Launch processes. The plugin comes with an embedded version of Chef Solo version 11.16.4-1, which can be installed and used to run a node. You can specify and use a different Chef version. If you use a different Chef version, the plugin step must run on a system where Chef is accessible locally.
Chef is a tool for automating deployment tasks. The Chef plugin includes two steps:
In the context of Chef automation, a node represents a computer system. A Chef node file includes a list of Chef recipes and roles. These recipes and roles point to automated tasks to run on the node.
To use this plugin, first run the Install Chef step. Then, run the Install Chef Node step to configure the target system according to a Chef node file. You can run this step multiple times on the same target system to apply multiple Chef node files.
HCL Launch 6.0.1 and later is required to run this plugin.
This plugin runs on all operating systems that are supported by both HCL Launch agent and Chef with the exception of z/OS.
This runs on Chef v11.6.0-1 or higher.
The following table describes the changes made in each plugin version.
| Version | Description |
|---|---|
| 3.1 | Support property file encryption |
You can use Chef in component processes to configure an environment, such as installing prerequisites or installing applications.
The Install Chef step searches for the Chef code in the same folder as the working directory for the step. Therefore, in most cases, you download the Chef code to the process working directory and then run the Install Chef Node step in the same working directory. For example, if you specify the install_java value for the Node name parameter, the step looks for a role file named nodes/install_java_node.json which is relative to the working directory for the step.
To access this plugin in the palette, click Automation > Chef.
The following process steps are available in the File Utils plugin.
Use this step to installs Chef Solo. Version 11.6.0-1 is installed.This step has no input properties.
Use this step to run a Chef node.
| Name | Type | Description | Required |
|---|---|---|---|
| Chef Installation Directory | String | The path to the Chef installation or if no value is provided the chef-solo executable file on the System Path is use. the chef-solo. For Windows, the usual location is C:\opscode\chef and for linux, the usual location is /opt/chef. You can provide a path to any location where you have installed Chef. On Windows you can provide a path in Unix format and we will append the System drive letter to the path automatically, this is useful in cases where you might not know what the drive letter should be. For example: /opscode/chef is translated into C:\opscode\chef. If the Install Chef step is used to install Chef in an earlier step in the process, you can reference the output property chefInstallDir from that step in this field. For example: ${p:%Install Chef%/chefInstallDir} where %Install Chef% is the name you set for the Install Chef step. | No |
| Node Name | String | The name of the node to run. | Yes |
The process shown in the following graphic downloads the application code and the Chef code. Then, it installs Chef. Finally, it installs two Chef nodes:
A simple process that downloads code, installs Chef, and installs two Chef nodes
Summary
Usage
Steps
Examples
