Azure Pipeline - "A supported task execution handler was not found" error

Product Forums Katalon Studio
1

I’m following the below guide to configure the Azure DevOps integration:
Azure DevOps integration | Katalon Docs

When I run the pipeline, I get the following error:
“A supported task execution handler was not found. The task does not carry an implementation that is compatible with your current operating system ‘Windows(X64)’. Contact the task author for more details.”

image
image893×429 20.9 KB

Below is the yaml file config:

trigger:
- master

pool:
  name: default

steps:
- task: katalonTask@1
  displayName: 'Execute Katalon Studio project'
  inputs:
    version: '10.1.1'
    executeArgs: '-retry=0 -statusDelay=15 -testSuitePath="Test Suites/TestSite1" -browserType="Chrome" -apiKey="***************************"'
1 Like
2

What happens if you specify some previous version? e.g, １０.０.0.

I suppose, Kaatlon has not yet updated the “Task: Execute Katalon Studio Tests” that can work with Katalon Runtime Engin v10.1.1, which is the newest one released last month.

3

try the below pls, use ur apikey and you may delete the publish artifact task

pool:
  name: Azure Pipelines
steps:
- task: katalon-llc.katalon.katalonTask.katalonTask@1
  displayName: 'Execute Katalon Studio project'
  inputs:
    version: 10.1.1
    executeArgs: 'katalonc -noSplash -runMode=console  -retry=0 -testSuitePath="Test Suites/New Test Suite" -browserType="Chrome" -executionProfile="default" -apiKey="CHANGE_ME" --config -proxy.auth.option=NO_PROXY -proxy.system.option=NO_PROXY -proxy.system.applyToDesiredCapabilities=true -webui.autoUpdateDrivers=true'

- task: PublishPipelineArtifact@1
  displayName: 'Publish Pipeline Artifact'
  inputs:
    targetPath: Reports
    artifact: 'TEST REPORTS'
1 Like
4

Same error, even with older versions.

5

I’m still getting the same error.

6

To resolve the “A supported task execution handler was not found” error in Azure Pipelines when using Katalon Studio, follow these steps:

1. Use the Correct Task Name and Version

Your YAML incorrectly uses katalonTask@1, which is outdated. Update the task name to the modern KatalonStudioEngine:

steps:
- task: KatalonStudioEngine@1  # Correct task name
  displayName: 'Execute Katalon Tests'
  inputs:
    version: '10.1.1'
    executeArgs: '-retry=0 -statusDelay=15 -testSuitePath="Test Suites/TestSite1" -browserType="Chrome" -apiKey="$(KATALON_API_KEY)"'

2. Specify a Windows Agent Pool

Ensure the pipeline uses a Windows-based agent. Update the pool section:

pool:
  vmImage: 'windows-latest'  # Explicitly use Windows agent

3. Secure Your API Key with a Pipeline Variable

Avoid hardcoding the API key. Store it in Azure DevOps variables:

  1. Go to your pipeline Variables.
  2. Add a variable named KATALON_API_KEY with your API key (mark it as secret).
  3. Reference it in YAML with $(KATALON_API_KEY).

4. Fix Argument Syntax

Use single quotes for paths with spaces and escape nested quotes:

executeArgs: '-retry=0 -statusDelay=15 -testSuitePath="Test Suites/TestSite1" -browserType="Chrome" -apiKey="$(KATALON_API_KEY)"'

Alternatively, use the arguments list format for clarity:

executeArgs: |
  -retry=0
  -statusDelay=15
  -testSuitePath="Test Suites/TestSite1"
  -browserType="Chrome"
  -apiKey="$(KATALON_API_KEY)"

5. Verify Katalon Engine Compatibility

Ensure your Katalon Studio version (10.1.1) is compatible with the KatalonStudioEngine task. Check the official documentation for version-specific guidance.

Sample Fixed YAML

trigger:
- master

pool:
  vmImage: 'windows-latest'  # Use Windows agent

steps:
- task: KatalonStudioEngine@1
  displayName: 'Execute Katalon Tests'
  inputs:
    version: '10.1.1'
    executeArgs: |
      -retry=0
      -statusDelay=15
      -testSuitePath="Test Suites/TestSite1"
      -browserType="Chrome"
      -apiKey="$(KATALON_API_KEY)"

Why This Error Occurs

  • Outdated Task Name: katalonTask@1 is deprecated and incompatible with newer Katalon Studio versions.
  • Incorrect Agent OS: The task might not support the default agent’s operating system.
  • Syntax Issues: Incorrect quotes or argument formatting in executeArgs.

By updating the task name, agent pool, and syntax, the pipeline should execute successfully

7

Ok, I’ve gotten it to work using a command-line invocation instead, e.g.

- task: CmdLine@2
  inputs:
    script: |
      katalon -noSplash -runMode=console -projectPath="C:\agent\_work\1\s\YourProject.prj" -retry=0 -testSuitePath="Test Suites/YourTestSuite" -executionProfile="default" -browserType="Chrome"