Integration with GitLab Runner

To manage / onboard GitLab Runner as the RBA tool, users need to perform the following steps:

  1. On the left menu bar, Go to Runbooks 🡪 Manage Runbook Tool. The Manage Runbook Tool appears.
  2. Click Create & Map Runbook Tool to add a new tool or click to edit an existing runbook automation tool.
  3. Select the data source for which you need to create a runbook tool in thedata source field.
  4. Type the runbook tool name in the Runbook Tool Name* field.
  5. Select GitLab Runner from the Runbook Tool Type* drop-down.
  6. Select REST API as the integration method for BigFix for the Integration Method* field.
  7. Select Project Access Token as the Authentication Type*.
    Figure 1. Create & Map Runbook Tool
    A screenshot of a computer AI-generated content may be incorrect.
    • Selection of from Project Access Token requires users to enter Project Token*
  8. Integration Section:
    1. Type the URL in the API URL*. field.

      Sample URL - https://<ip>:<port>

    2. Select the Integration Method Type* as POST.
    3. Type the return code key in the Return Code Key* field to identify the success or failure of runbook execution. E.g. status
    4. Type the return message key in the Return Message Key* field to display the success or failure of runbook execution. E.g. result.
      Note:
      API URL is dependent on the selected integration method
  9. Authentication Section:
    1. Enter Project Token*.
  10. Base Section:
    1. Specify the path to get the consolidated scripts for the execution of runbooks in the Master Runbook Path field. This will be provided by respective Runbook Tool teams if they have a master runbook.
      Note:
      This is not a mandatory field. Users can change and run these scripts any time.
    2. Select Proxy Required, if the environment needs access to content from servers outside a firewall.
    3. Type the Toil Value (For Manual Execution) * which implies the manual execution time of runbook under this tool (in minutes).
    4. Type the Toil Value (For Auto Execution) * which implies the auto execution time of runbook under this tool (in minutes), if available else it’s a non-mandatory field.
    5. Type the Connection Retry Count* which shows the retry count in case the connection with the RBA tool fails.
      Figure 2. Create & Map Runbook Tool (Cont.)
      A screenshot of a computer AI-generated content may be incorrect.
  11. Click Submit / Update for adding a new tool or making changes to an existing tool. An appropriate success message will be displayed.