This Knife Plugin is an easy way to switch between various supermarkets, the biggest of them being the Chef Community Site, located at https://supermarket.chef.io. The knife supermarket commands mimic the knife cookbook site commands and work the same way.

If you are running Chef-DK you can install it by running:

$ chef gem install knife-supermarket

Otherwise, this plugin is distributed as a Ruby Gem. To install it, run:

$ gem install knife-supermarket

Depending on your system's configuration, you may need to run this command with root privileges.

Out of the box, knife-supermarket is configured to point at https://supermarket.chef.io, but it can be configured to point at the unofficial supermarket. This can be done two ways:

When using the knife supermarket commands you can specify a --supermarket-site or -m flag and specify the uri of the new supermarket. So, for example, if your supermarket was hosted at https://franchise.somecompany.com you could run knife supermarket install --supermarket-site https://franchise.somecompany.com mysql.

It may be preferable to have this setting default to another host. For that, we can set the knife[:supermarket_site] setting in our knife.rb. So if we wanted to default to a supermarket hosted at https://franchise.somecompany.com it would be:

knife[:supermarket_site] = 'https://franchise.somecompany.com'

Now when you run knife supermarket install mysql it will install the mysql cookbook from https://franchise.somecompany.com.

The subcommands work the same way they for knife cookbook site. Please see https://docs.chef.io/chef/knife.html#cookbook-site for more information on the subcommands.