Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Katalon Continuous Integration With GitLab

DZone's Guide to

Katalon Continuous Integration With GitLab

This tutorial walks through the steps needed to automatically run your Katalon test suites when you push any change on your GitLab repository.

· Integration Zone ·
Free Resource

SnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.

Introduction

When you make changes to your project source code, you definitely need to run Katalon tests again to make sure that changes are correct. But you may find it boring to run them every now and then, with a possibility to forget to do so. Here, Continuous Integration becomes very important, as it allows you to automate the Change-Then-Test process.

This tutorial walks through the steps needed to automatically run your Katalon test suites when you push any change on your GitLab repository.

Requirements

  • You have a GitLab account and you already put your web app in a Git repository. You can download this sample PHP application to be able to go through.
  • You have a web server hosting your application (e.g. XAMPP Apache Server).
  • You have Katalon Studio installed and you have created a test suite with one or more test cases.
  • This tutorial is limited to Windows, but you may perform similar steps on other platforms.

1. Register and Install GitLab Runner

Download GitLab runner for x86 or amd64, then follow the steps in the following video

Note: In the video, we added the tag “shell” in order to run test cases on the local machine. However, you can add other tags like docker and ssh.

2. Add a Configuration File to Your Repository

In the root directory of your repository, add a file named .gitlab-ci.yml. Open the file and type the following:

run_katalon_test_suite:
      tags:
        - shell
      script:
        - katalon -noSplash  -runMode=console -consoleLog -projectPath=
          "<Your_Project_Directory>" -retry=0
          -testSuitePath="Test Suites/<Test_Suite_Name>" -executionProfile=
          "default" -browserType="Chrome (headless)"

Note: typically, your default project directory is “C:\Users\<USERNAME>\Katalon Studio\<PROJECT_NAME>\<PROJECT_NAME>.prj”

If you want to start your web server automatically before running test cases, add a command at the beginning of the configuration file. For example, to open XAMPP apache server, add this command at the beginning of the file:

before_script:
      - start /B cmd /K "<Path_To_HTTPD_Executable>"

Note: typically, the default httpd.exe file location in XAMPP is “C:\xampp\apache\bin\httpd.exe”

If you want to stop your web server after executing test cases, add a command at the end of your script. For XAMPP Apache Server, the command is taskkill /F /IM httpd.exe . So, the final file should look like this:

before_script:
      - start /B cmd /K "<Path_To_HTTPD_Executable>"

    run_katalon_test_suite:
      tags:
        - shell
      script:
        - katalon -noSplash  -runMode=console -consoleLog -projectPath=
          "<Your_Project_Directory>" -retry=0
          -testSuitePath="Test Suites/<Test_Suite_Name>" -executionProfile=
          "default" -browserType="Chrome (headless)"
        - taskkill /F /IM httpd.exe

3. Add Katalon Path to Environment Variables

  • Go to Control Panel > System and Security > System
  • Click on “Advanced system settings” on the left pane

Image title

  • Choose the “Advanced” tab and click “Environment Variables…”

Image title

  • In “System variables” section, choose the variable “Path” and click “Edit…”

Image title

  • In the “variable value” field, add ";" and then the directory of Katalon Studio

Image title

Note: the first 3 steps are needed only once.

4. Make Changes and Test

After saving some changes, push them to your git repository. After that, open the repository > CI/CD > Pipelines

Image title

  • You can see one of the following marks in your pipeline:

Image title

Now, click on the job link.

Image title

  • See testing results (you may need to wait some time to see results)

Image title

Note: you may see an error like this:

Image title

If you see it, run the command below from your local git repository and try again:

git config --system http.sslverify false

Conclusion

Once you have Katalon test cases prepared, you only need to focus on updating your project. You will no longer need to repeatedly go and run test cases manually after each update because this process is already automated. You are just informed whether your commits are successful or not. However, you can still find detailed testing reports in the Reports folder that is located in your Katalon Studio project root directory. The development and testing processes can be summarized in the following diagram:

Image title

With SnapLogic’s integration platform you can save millions of dollars, increase integrator productivity by 5X, and reduce integration time to value by 90%. Sign up for our risk-free 30-day trial!

Topics:
quality assuarance ,automated testing ,gitlab runner ,katalon studio ,continuous integration ,integration ,tutorial

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}