Integration von Katalon Studio mit GitLab CI/CD

Für CICD-Zwecke wird normalerweise ein Docker-Image von Katalon benötigt, das dann mit Katalon Studio integriert werden kann. Verwenden Sie das offizielle Katalon Docker-Image, um Ihre Tests in GitLab CI/CD auszuführen. Dieses Image ist bereits mit allen notwendigen Abhängigkeiten für den Betrieb von Katalon Studio vorkonfiguriert.

Die Referenz der Docker-Images kann in verschiedenen CICD-Produkten implementiert werden. Wir werden sie zusammenfassen:

  • GitLab CI/CD Konfiguration:
    • Erstellen Sie eine .gitlab-ci.yml-Datei im Stammverzeichnis Ihres Projekts.

katalon-test:
 image: katalonstudio/katalon
 script:
 - katalonc -noSplash -runMode=console -projectPath="path/to/your/project" -retry=0 -testSuitePath="Test Suites/YourTestSuite" -executionProfile="default" -browserType="Chrome (headless)"
  • Ausführung: Übertragen Sie diese Konfiguration in Ihr GitLab-Repository. GitLab CI/CD verwendet automatisch diese Konfiguration, um Ihre Katalon-Tests im definierten Docker-Container auszuführen.

Integration von Katalon Studio mit GitHub Actions

  • GitHub Actions Workflow:
    • Erstellen Sie eine Workflow-Datei (z.B., .github/workflows/katalon.yml) in Ihrem GitHub-Repository.
    • Verwenden Sie das Katalon Docker-Image innerhalb des Workflows, um Ihre Tests auszuführen.
name: Katalon Studio Test Execution
on: [push]
jobs:
 build:
 runs-on: ubuntu-latest
 container: katalonstudio/katalon
 steps:
 - uses: actions/checkout@v2
 - name: Run Katalon Studio Tests
 run: katalonc -noSplash -runMode=console -projectPath="$GITHUB_WORKSPACE" -retry=0 -testSuitePath="Test Suites/YourTestSuite" -executionProfile="default" -browserType="Chrome (headless)"

– Ausführung: Jedes Mal, wenn Sie Änderungen in Ihr Repository übertragen, führt GitHub Actions automatisch den Workflow aus und führt dabei Ihre Katalon-Tests durch.

Integration von Katalon Studio mit Jenkins

  • Docker Plugin: Stellen Sie sicher, dass Ihre Jenkins-Installation das Docker-Plugin installiert hat, um Docker-Container auszuführen.
  • Jenkins Pipeline:
    • Erstellen Sie einen neuen Jenkins Pipeline-Job.
    • Verwenden Sie das Pipeline-Skript, um Schritte zu definieren, die das Katalon Docker-Image abrufen und Ihre Tests ausführen.

pipeline {
 agent {
 docker { image 'katalonstudio/katalon' }
 }
 stages {
 stage('Test') {
 steps {
 sh 'katalonc -noSplash -runMode=console -projectPath="/path/to/your/project" -retry=0 -testSuitePath="Test Suites/YourTestSuite" -executionProfile="default" -browserType="Chrome (headless)"'
  • Ausführung: Führen Sie die Pipeline aus, um Ihre Katalon-Tests innerhalb eines von Jenkins verwalteten Docker-Containers auszuführen.

Integration von Katalon Studio mit Azure

Voraussetzungen

  • Ein Azure DevOps-Konto und ein eingerichtetes Projekt.
  • Ihr Katalon Studio-Projekt ist in einem Repository in Azure DevOps eingecheckt.
  • Vertrautheit mit der Erstellung von Pipelines in Azure DevOps.

Schritte zur Integration von Katalon Studio mit Azure DevOps

-. Vorbereitung Ihres Katalon Studio-Projekts

  • Stellen Sie sicher, dass Ihr Katalon Studio-Projekt in einem Git-Repository in Azure DevOps gespeichert ist.
  • Fügen Sie eine Dockerfile zu Ihrem Projekt hinzu, wenn Sie ein benutzerdefiniertes Docker-Image verwenden möchten, oder stellen Sie sicher, dass Ihre Pipeline so konfiguriert ist, dass sie das offizielle Katalon Docker-Image direkt verwendet.
  1. Erstellen Sie eine neue Pipeline
  • Gehen Sie in Ihrem Azure DevOps-Projekt zu Pipelines > Neue Pipeline.
  • Wählen Sie aus, wo Ihr Code gespeichert ist (in diesem Fall Azure Repos Git), und wählen Sie Ihr Repository aus.
  1. Konfigurieren Sie Ihre Pipeline

Sie haben die Möglichkeit, den klassischen Editor oder YAML zu verwenden, um Ihre Pipeline zu definieren. Hier konzentrieren wir uns auf die YAML-Konfiguration für die Verwendung von Docker.

  • Wählen Sie die YAML-Option und beginnen Sie mit der Konfiguration Ihrer Pipeline. Sie könnten mit einer Vorlage beginnen oder eine neue YAML-Datei erstellen.
  • Fügen Sie die folgenden Schritte zu Ihrer YAML-Datei hinzu. Dieses Beispiel verwendet das offizielle Katalon Docker-Image, um Ihre Tests auszuführen. Passen Sie die Befehlszeilenoptionen (katalonc-Befehl) entsprechend den Anforderungen Ihres Projekts an.

trigger:
- main

pool:
 vmImage: 'ubuntu-latest'

container:
 image: katalonstudio/katalon

steps:
- script: |
 katalonc -noSplash -runMode=console -projectPath="$(System.DefaultWorkingDirectory)/your-katalon-project-folder" -retry=0 -testSuitePath="Test Suites/YourTestSuite" -executionProfile="default" -browserType="Chrome (headless)" -apiKey="<Your_Katalon_API_Key>"
 displayName: 'Execute Katalon Studio Tests'

Für alle Ersetzen Sie your-katalon-project-folder durch den Pfad zu Ihrem Projekt innerhalb des Repositorys, YourTestSuite durch den Namen Ihrer Testsuite und <Your_Katalon_licence/api_Key>

  • Führen Sie Ihre Pipeline aus

  • Speichern und führen Sie Ihre Pipeline aus. Azure DevOps führt die Pipeline bei dem angegebenen Auslöser aus, verwendet den Docker-Container, um Ihre Katalon Studio-Tests auszuführen, und meldet die Ergebnisse zurück in die Zusammenfassung des Pipeline-Laufs. *. Testergebnisse anzeigen

  • Um Testergebnisse innerhalb von Azure DevOps besser anzeigen und analysieren zu können, sollten Sie in Erwägung ziehen, Testergebnisse aus Katalon Studio in einem Format zu exportieren, das Azure DevOps interpretieren kann (z.B. JUnit XML), und die Testergebnisse als Teil Ihrer Pipeline-Schritte zu veröffentlichen. Azure DevOps ermöglicht es Ihnen auch, sich mit verschiedenen Erweiterungen und Plugins zu integrieren, um die Fähigkeiten Ihrer CI/CD-Pipeline zu erweitern, einschließlich der Berichterstattung über Testergebnisse, des Managements von Artefakten und mehr. Diese Integration stellt sicher, dass Ihre Katalon Studio-Tests ein integraler Bestandteil Ihrer Entwicklungs-Pipeline sind und erleichtert das kontinuierliche Testen und Bereitstellen mit Azure DevOps.

Best Practices

  • Halten Sie Ihre Testskripte unter Versionskontrolle: Stellen Sie sicher, dass Ihr Katalon Studio-Projekt unter Versionskontrolle mit GitLab oder GitHub steht, um eine nahtlose Integration mit deren jeweiligen CI/CD-Pipelines zu ermöglichen.
  • Verwalten Sie Testdaten und Berichte: Konfigurieren Sie Ihre CI/CD-Pipeline so, dass sie Testdaten handhabt und Berichte speichert. Beispielsweise können Sie Testberichte als Artefakte in GitLab CI/CD oder GitHub Actions archivieren.
  • Optimieren Sie die Testausführung: Verwenden Sie Testsuite-Sammlungen in Katalon Studio, um die Organisation und Verwaltung der Ausführung mehrerer Testsuites zu organisieren und zu verwalten, möglicherweise parallel, um die Gesamttestausführungszeit zu reduzieren.