Gitlab CI Integration

This document shows you how to upload Katalon test reports to Katalon TestOps using Gitlab CI.

Prerequisites

• Katalon API key – If you haven’t set one up yet, follow this guide to generate your API key.
• Project ID - You can find your Katalon project ID in the URL (typically after /project/, e.g., ".../project/1234567/..."), or refer to this guide for more details.

Upload test reports using Gitlab CI

1. Get the local path to your Katalon report folders, e.g. C:\Users\alex\Katalon Studio\Web Sample\Reports\Test Suite\20190523_143946 that you want to upload.

2. Create an Environment Variable in your Gitlab CI configuration for:

KATALON_TESTOPS_APIKEY=your-katalon-api-value

3. Copy the following .yml file to your repository that is already synced with Gitlab CI.

   Warning

   You must replace the placeholder values with your actual information for the following fields:

   • PROJECT_ID: Enter your Katalon Project ID.
   • TYPE: Select one of the following options:
     • katalon
     • junit
     • katalon_recorder
   • REPORT_PATH: Enter the local path to your test report.

   stages:
   - test
   - upload-report
   
   test:
   stage: test
   image: node:10.15.3
   cache:
       paths:
       - node_modules/
   script:
       - npm install
       - npm test
   artifacts:
       paths:
       - report/
   only:
       - master
   
   upload-report:
   stage: upload-report
   image: katalonstudio/report-uploader:0.0.8
   script:
       - uploader.sh
   variables:
       PROJECT_ID: your_project_id
       TYPE: your_report_type
       REPORT_PATH: path/to/test/report
       PUSH_TO_XRAY: false
   dependencies:
       - test
   only:
       - master

Result

Once executed successfully, the command will upload your report to Katalon TestOps. Navigate to Reports to view all uploaded test reports.