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.
- 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
Note: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
- Choose the “Advanced” tab and click “Environment Variables…”
- In “System variables” section, choose the variable “Path” and click “Edit…”
- In the “variable value” field, add ";" and then the directory of Katalon Studio
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
- You can see one of the following marks in your pipeline:
Now, click on the job link.
- See testing results (you may need to wait some time to see results)
Note:you may see an error like this:
If you see it, run the command below from your local git repository and try again:
git config --system http.sslverify false
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: