Manage Data Bags

[edit on GitHub]

Data bags store global variables as JSON data. Data bags are indexed for searching and can be loaded by a cookbook or accessed during a search.

Manage

Data bags can be managed from the Chef management console web user interface.

Add Data Bag

To add a data bag:

1. Open the Chef management console.

2. Click Policy.

3. Click Data Bags.

4. Click Create.

5. In the Create a Data Bag dialog box, enter the name of the data bag.

   

6. Click Create Data Bag.

Delete Data Bag

To delete a data bag:

1. Open the Chef management console.

2. Click Policy.

3. Click Data Bags.

4. Select a data bag.

5. Click Delete.

   

Manage Items

A data bag is a container of related data bag items, where each individual data bag item is a JSON file. knife can load a data bag item by specifying the name of the data bag to which the item belongs and then the filename of the data bag item. The only structural requirement of a data bag item is that it must have an id:

{
  /* This is a supported comment style */
  // This style is also supported
  "id": "ITEM_NAME",
  "key": "value"
}

where

• key and value are the key:value pair for each additional attribute within the data bag item
• /* ... */ and // ... show two ways to add comments to the data bag item

Add Item

To add a data bag item:

1. Open the Chef management console.

2. Click Policy.

3. Click Data Bags.

4. Select a data bag.

5. Click Create Item.

6. In the Create a Data Bag Item dialog box, enter the data bag identifier, and then JSON data that defines the data bag item.

   

7. Click Create Data Bag Item.

Delete Item

To delete a data bag item:

1. Open the Chef management console.

2. Click Policy.

3. Click Data Bags.

4. Select a data bag.

5. Select the Items tab.

6. Select an item.

7. Click Delete.

   

Edit Item

To edit a data bag item:

1. Open the Chef management console.

2. Click Policy.

3. Click Data Bags.

4. Select a data bag.

5. Select the Items tab.

6. Select an item.

7. Click Edit.

   

8. Make your changes.

9. Click Save Item.

View Item

To view data bag items for a data bag:

1. Open the Chef management console.
2. Click Policy.
3. Click Data Bags.
4. Select a data bag.
5. Select the Items tab.

Manage Permissions

Permissions are used in the Chef Infra Server to define how users and groups can interact with objects on the server. Permissions are configured per-organization.

The Chef Infra Server includes the following object permissions:

Set

To set permissions list for a data bag object:

1. Open the Chef management console.
2. Click Policy.
3. Click Data Bags.
4. Select a data bag.
5. Click the Permissions tab.
6. For each group listed under Name, select or de-select the Read, Update, Delete, and Grant permissions.

Update

To update the permissions list for a data bag object:

1. Open the Chef management console.
2. Click Policy.
3. Click Data Bags.
4. Select a data bag.
5. Click the Permissions tab.
6. Click the + Add button and enter the name of the user or group to be added.
7. Select or de-select Read, Update, Delete, and Grant to update the permissions list for the user or group.

View

To view permissions for a data bag object:

1. Open the Chef management console.
2. Click Policy.
3. Click Data Bags.
4. Select a data bag.
5. Click the Permissions tab.
6. Set the appropriate permissions: Read, Update, Delete, and Grant.