Use > Get started with Chef Cookbooks in SA > Chef management > Manage Chef Cookbooks in SA

Manage Chef Cookbooks

Access Chef Cookbooks from the SA Client

New SA object type: chef cookbooks

To locate Chef Cookbooks in SA Client by folder:

  1. From the navigation pane, select Library > By Type > Chef Cookbooks.
  2. Navigate down the hierarchy by selecting a platform and then a platform version.
  3. From the content pane, select a cookbook and then select Locate in Folders from the Actions menu. The folder hierarchy for the policy appears in the content pane.

To locate Chef Cookbooks in SA Client by type:

  1. From the navigation pane, select Library > By Type > Chef Cookbooks.
  2. Navigate down the hierarchy by selecting a platform and then a platform version.
  3. Select a cookbook associated with this specific platform version.

Viewing cookbook details in SA Client

SA provides complete visibility into the properties, metadata, and recipes of the imported cookbooks.

To view cookbook details from the preview pane:

You can access the cookbook details directly from the preview pane when selecting the cookbook:

Preview details of a cookbook from the chef cookbooks list view

To view cookbook details from within the cookbook:

  1. From the navigation pane, select Library > By Type > Chef Cookbooks.
  2. Navigate down the hierarchy by selecting a platform and then a platform version.
  3. Select a cookbook associated with this specific platform version.
  4. From the Actions menu, select Open to view Cookbook details. There are three views in the Cookbook explorer.
    1. Properties (cookbook file information)
    2. Metadata (attributes and components of the cookbook)
    3. Recipes (the contents of each of the recipes in the cookbook).

Editing Chef Cookbook properties

The Cookbook: Properties window in the SA Client allows you to view and edit the properties of a cookbook. You can edit a cookbook’s Name, Description, OS, and Location.

Note
Editing cookbook properties can be done only by users that have write permissions for the folder where the cookbook resides.

To edit the Chef Cookbook properties:

  1. From the navigation pane, select Library > By Type > Chef Cookbooks.
  2. Navigate down the hierarchy by selecting a platform and then a platform version.
  3. Select a cookbook associated with this specific platform version.
  4. From the Actions menu, select Open to view Cookbook details.
  5. In the navigation pane, select Properties to view cookbook file information.
  6. Update the editable fields:
    • Name: The default name is based on the name of the import file. This is an editable text field.

      Only the internal SA name of the cookbook is editable; not the native one, so cookbook-dependency resolution is not affected by a rename.
    • Description: Enter a meaningful description for the cookbook in the text field
    • OS: Click the arrow to select or deselect supported operating systems for this cookbook.
    • Location: Click Select to navigate to and select the folder path in the SA Library. Navigate to the desired folder location and click Select again to make the selection.
  7. Select File > Save to save your changes.