8.1. Chef JSON Key Value Description

The following provides the key value pairs that must be contained in the JSON file supporting Chef action.

8.1.1. Table A1. Chef JSON File key value description

Field Name Description Type Comment
Environment A JSON dictionary representing a Chef Environment object. If the VNF action requires loading or modifying Chef environment attributes associated with the VNF, all the relevant information must be provided in this JSON dictionary in a structure that conforms to a Chef Environment Object. Optional Depends on VNF action.
Node

A JSON dictionary representing a Chef Node Object.

The Node JSON dictionary must include the run list to be triggered for the desired VNF action by the push job. It should also include any attributes that need to be configured on the Node Object as part of the VNF action.

Mandatory  
NodeList Array of FQDNs that correspond to the endpoints (VMs) of a VNF registered with the Chef Server that need to trigger a chef-client run as part of the desired VNF action. Mandatory  
PushJobFlag This field indicates whether the VNF action requires a push Job. Push job object will be created by ONAP if required. Mandatory If set to “True”, ONAP will request a push job. Ignored otherwise.
CallbackCapable This field indicates if the chef-client run invoked by push job corresponding to the VNF action is capable of posting results on a callback URL. Optional If Chef cookbook is callback capable, VNF owner is required to set it to “True”. Ignored otherwise.
GetOutputFlag Flag which indicates whether ONAP should retrieve output generated in a chef-client run from Node object attribute node[‘PushJobOutput’] for this VNF action (e.g., in Audit). Mandatory ONAP will retrieve output from NodeObject attributes [‘PushJobOutput’] for all nodes in NodeList if set to “True”. Ignored otherwise.

Chef Template example:

"Environment":{
     "name": "HAR",
     "description": "VNF Chef environment for HAR",
     "json\_class": "Chef::Environment",
     "chef\_type": "environment",
     "default\_attributes": { },
     "override\_attributes": {
           "Retry\_Time":"50",
           "MemCache": "1024",
           "Database\_IP":"10.10.1.5"
     },
}
}
"Node": {
     "name" : "signal.network.com "
     "chef\_type": "node",
     "json\_class": "Chef::Node",
     "attributes": {
           "IPAddress1": "192.168.1.2",
           "IPAddress2":"135.16.162.5",
           "MyRole":"BE"
     },
     "override": {},
     "default": {},
     "normal":{},
     "automatic":{},
     "chef\_environment" : "\_default"
     "run\_list": [ "configure\_signal" ]
     },
     "NodeList":["node1.vnf\_a.onap.com", "node2.vnf\_a.onap.com"],
     "PushJobFlag": "True"
     "CallbackCapable":True
     "GetOutputFlag" : "False"
}

The example JSON file provided by the VNF provider for each VNF action will be turned into a template by ONAP, that can be updated with instance specific values at run-time.

Some points worth noting regarding the JSON fields:

  1. The JSON file must be created for each action for each VNF.
  2. If a VNF action involves multiple endpoints (VMs) of a VNF, ONAP will replicate the “Node” JSON dictionary in the template and post it to each FQDN (i.e., endpoint) in the NodeList after setting the “name” field in the Node object to be the respective FQDN [1]. Hence, it is required that all end points (VMs) of a VNF involved in a VNF action support the same set of Node Object attributes.

The following table describes the JSON dictionary to post in Callback.

8.1.2. Table A2. JSON Dictionary to Post in Callback

Key Description Type Comment
RequestId A unique string associated with the original request by ONAP. This key-value pair will be provided by ONAP in the environment of the push job request and must be returned as part of the POST message. Mandatory  
StatusCode An integer that must be set to 200 if chef-client run on the node finished successfully 500 otherwise. Mandatory  
StatusMessage

A string which must be set to ‘SUCCESS’ if StatusCode was 200

Appropriate error message otherwise.

Mandatory  
Name A string which corresponds to the name of the node where push job is run. It is required that the value be retrieved from the node object attributes (where it is always defined). Mandatory  
PushJobOutput Any output from the chef-client run that needs to be returned to ONAP. Optional Depends on VNF action. If empty, it must not be included.
[1]The “name” field is a mandatory field in a valid Chef Node Object JSON dictionary.