/chef-workstation

Chef Workstation gives you everything you need to get started with Chef, so you can automate how you audit, configure, and manage applications end environments.

Primary LanguageGoApache License 2.0Apache-2.0

Chef Workstation

Umbrella Project: Chef Workstation

Chef Workstation installs everything you need to get started using Chef products on Windows, Mac and Linux. It includes:

  • Chef Workstation App
  • Chef Infra Client
  • Chef InSpec
  • Chef Habitat
  • Chef Command Line Tool
  • Test Kitchen
  • Cookstyle
  • Various Test Kitchen and Knife plugins for clouds

Getting Started

  1. Download Chef Workstation

  2. Double-click the .dmg or .msi file to start the install process, or use the package manager for your Linux distribution.

  3. Open a terminal, and try out an ad-hoc task. Here's the general usage:

    chef-run [flags] <Target host|IP|SSH|WinRM> <Resource> <Resource Name> [properties]

  • Install the 'ntp' package on 'hostname' over ssh, using password from the environment:

    chef-run username:$PASSWORD@hostname package ntp

  • Create user 'timmy' on 'hostname' over winrm:

    chef-run winrm://username@hostname user timmy

  • Run the recipe 'nginx::passenger' on 'hostname' over ssh on port 2222 using a keyfile:

    chef-run ssh://hostname:2222 -i ~/.ssh/id_rsa nginx::passenger

  1. Use chef-run -h for additional information about usage and available flags.

Building Chef-Workstation Packages

We use Omnibus to describe our packaging. Please review chef-workstation/omnibus/README.MD for further details.

Copyright and License

Code released under the Apache license. Images and any trademarked content are Copyright 2018 by Chef Software, Inc..