Chef Supermarket¶

[edit on GitHub]

Chef Supermarket is the site for community cookbooks. Information technology provides an hands searchable cookbook repository and a friendly spider web UI. Cookbooks that are part of the Chef Supermarket are accessible past whatever Chef user.

There are two means to use Chef Supermarket:

  • The public Chef Supermarket is hosted by Chef and is located at Chef Supermarket.
  • A individual Chef Supermarket may be installed on-premise behind the firewall on the internal network. Cookbook retrieval from a individual Chef Supermarket is ofttimes faster than from the public Chef Supermarket because of closer proximity and fewer cookbooks to resolve. A private Chef Supermarket tin can as well help formalize internal cookbook release direction processes (east.one thousand. "a cookbook is not released until information technology's published on the private Chef Supermarket").

Public Supermarket¶

The public Chef Supermarket hosted past Chef is located at Chef Supermarket.

To collaborate with the public Chef Supermarket, use knife supermarket commands.

_images/public_supermarket.svg

Individual Supermarket¶

The private Chef Supermarket is installed behind the firewall on the internal network. Outside of changing the location from which community cookbooks are maintained, it otherwise behaves the same as the public Chef Supermarket.

Installing Private Supermarket¶

To install a Private Supermarket, come across the instructions hither.

Set up Workstation¶

Configure config.rb¶

The config.rb file on the workstation should be configured for use with the private Chef Supermarket.

To configure config.rb for the private Chef Supermarket, exercise the following:

  1. Open the config.rb file in an editor.

  2. Add together the following setting:

                                                knife                      [                      :supermarket_site                      ]                      =                      'https://your-private-supermarket'

  3. Salve and close the file.

Create a Cookbook¶

The following examples show how to create a simple cookbook past using the chef command that is built into the the Chef Development Kit.

Generate a chef-repo

To generate a chef-repo, run a command similar to:

                $ chef generate repo my_chef_repo

Access the chef-repo using the cd control:

Generate a cookbook

Annotation

Duplicate cookbook names on Chef Supermarket are non allowed. And so first verify that a cookbook name is available.

To create the my_apache2_cookbook cookbook, run the post-obit command:

                $ chef generate cookbook cookbooks/my_apache2_cookbook

Generate a template

To generate a template, run a command similar to:

                $ chef generate template cookbooks/my_apache2_cookbook index.html

This will create a file named index.html.etb in the /cookbooks/my_apache2_cookbook directory. Open the file using a text editor to add content. For instance, some HTML:

                                <                html                >                <                body                >                <                h1                >Chef Beloved!</                h1                >                </                body                >                </                html                >

Relieve and close the file.

Create a recipe

The default.rb recipe is created when a cookbook is generated. A recipe is updated using a text editor. For example:

                                package                'apache2'                # Installs the apache2 packet                service                'apache2'                do                activity                [                :first                ,                :enable                ]                # Starts and enables the apache2 service on boot                cease                template                '/var/www/html/index.html'                practise                source                'index.html.erb'                # Template for /var/www/html/index.html                end

Upload a Cookbook¶

To upload a cookbook to Chef Supermarket, do the following:

  1. Add together a setting for Chef Supermarket to the config.rb file:

                                            knife                    [                    :supermarket_site                    ]                    =                    'https://your-private-supermarket'

  2. Resolve SSL errors by fetching, and then verifying the SSL document for Chef Supermarket:

                        $ knife ssl fetch https://your-private-supermarket

    and and then:

                        $ knife ssl check https://your-private-supermarket

  3. Upload the cookbook to Chef Supermarket:

                        $ pocketknife supermarket share mycookbook                    "Other"

supermarket-ctl (executable)¶

The Chef Supermarket installations that are done using the Chef installer include a command-line utility named supermarket-ctl. This control-line tool is used to first and stop individual services, reconfigure the Chef Supermarket server, run smoke tests, and tail the Chef Supermarket log files.

For more data about the supermarket-ctl control line tool, come across supermarket-ctl.

supermarket.rb¶

The supermarket.rb file contains all of the non-default configuration settings used by the Chef Supermarket. The default settings are built-in to the Chef Supermarket configuration, and should only be added to the supermarket.rb file to apply non-default values. These configuration settings are candy when the supermarket-ctl reconfigure control is run. The supermarket.rb file is a Ruby file, which ways that provisional statements can exist used in the configuration file.

For more information nigh the supermarket.rb file, see supermarket.rb.

Supermarket API¶

The Supermarket API is used to provide access to cookbooks, tools, and users on the Chef Supermarket. All of the cookbooks, tools, and users on the Supermarket are accessible through a RESTful API by accessing supermarket.chef.io/api/v1/ via the supported endpoints. In most cases, knife is the best way to interact with the Supermarket; however in some cases, direct use of the Supermarket API is necessary.

For more than information about the Supermarket API, encounter Supermarket API.

fieri¶

Fieri is an optional service what will check cookbook versions for sure metrics to determine the quality of the cookbook.

If you are using a private Chef Supermarket, y'all tin activate the Fieri service similar this:

  1. Add Fieri to your features attribute.

                                            [                    'supermarket_omnibus'                    ][                    'config'                    ][                    'features'                    ]                    =                    "tools,github,proclamation,fieri"

  2. Add the post-obit Fieri attributes:

                                            [                    'supermarket_omnibus'                    ][                    'config'                    ][                    'fieri_key'                    ]                    =                    "                    #{                    random                    string                    you lot                    generate                    }                    "                    [                    'supermarket_omnibus'                    ][                    'config'                    ][                    'fieri_supermarket_endpoint'                    ]                    =                    "                    #{                    your_supermarket_url                    }                    "

  3. Reconfigure your Supermarket.

                                            (your-supermarket-node)                    $ sudo supermarket-ctl reconfigure                    (your-supermarket-node)                    $ sudo supermarket-ctl restart

Subsequently doing these steps, you should see a "Quality" tab when viewing a cookbook through the Supermarket UI. Click on this tab and you volition see the results of the metrics run past Fieri.