CI Portal - Automatics Integration

Automatics supports CI integration and validation of RDK builds. To integrate Automatics in any CI system, the CI portal has to follow REST communication with Automatics. CI portal will provide details like image name and other request params along with REST request.
Automatics has pre-configured filters for CI requests. If request params from CI portal request matches with filter,then the request is ACCEPTED. For ACCEPTED requests, Automatics will trigger test execution based on test data configured against filter.

The status of requests ACCEPTED and REJECTED are available in Automatics Orchestration.

Communication Diagram

CI Portal to Automatics

• Rest based communication
• Automatics End Point: /Automatics/handleRdkTrigger.htm
• Description: Automatics accepts request from CI portal in this end point. Upon receiving the request from CI portal, Automatics immediately returns the response code 200  with response text 'Request received and taken for processing.'  On receiving the request, Automatics will start processing it. Based on the filters configured in Automatics Orchestration, the request from CI portal will be accepted or rejected. 
• Response Code: 200
• Response Body: Request received and taken for processing.

Automatics to CI Portal

• Rest based communication
• CI Portal End Point: /json/test
• Description:  When a request from CI portal is accepted, Automatics Orchestration will send execution request to Jenkins. The test cases to be executed for CI validation will pre-configured  in Orchestration. Set of scripts to be executed for a CI request with image name and other param values is configured in Automatics.Upon completion of test execution, the results will be updated back to CI portal.
• Request Content-Type: application/json
• Request Body Format:

{
   "service":"CI_VERIFICATION",
   "status":"SUCCESS",
   "started_at":1623818325471,
   "started_by":"CI PORTAL",
   "duration":3618,
   "result":{
      "build_name":"image_name",
      "type":"test_type",
      "tests":[
         {
            "test_id":"Test case id",
            "step":"Step No",
            "description":"Test step description",
            "status":"Test step status",
            "reason":"Reason for failure",
            "jira_id":"Jira Id"
         }
      ]
   },
   "finished_at":1623818329089,
   "test_jenkins_url":"http://{jenkins}/job/JOB1/612",
   "boxes":[
      {
         "eSTB_mac":"estb_mac",
         "eCM_mac":"ecm_mac",
         "eSTB_ip":"estb_ip,
         "eCM_ip":"ecm_ip"
      }
   ]
}

• Response Code: 200