Skip to content

RapiseLauncher Extension for Azure DevOps

This section explains how to execute Rapise Spira Test Sets in Azure DevOps pipelines using the RapiseLauncher.

Azure DevOps

We assume that Rapise tests are stored in a SpiraTeams. Here we plan to configure a build pipeline for executing a SpiraTeam Test Set on a Microsoft-hosted agent.

The benefit of the Microsoft-hosted agent is its configuration - it has latest version of web browsers, with relevant version of webdriver connectors. Everything is configured for the test run (updates and popups disabled, etc). RapiseLauncher may be used to execute Desktop UI tests, API tests, mobile tests and web tests. For web tests it is possible to use Rapise own Chrome extension, IE 11 or any selenium webdriver-based target.

The same extension may be used for launching tests in self-hosted Windows agents.

Although in minimal configuration just RapiseLauncher step is enough, the pipeline definition may also include build, deploy or download of the AUT before the test execution. The results of test execution are then stored into the SpiraTeam.

Once configured and executed the extension does the following:

  1. Automatically download and install the RapiseLauncher.
  2. Downloads test files from the SpiraTeam.
  3. Execute the test set.
  4. Publish execution results, videos and logs back to SpiraTeam, so they are attached to the test run.

The whole configuration process contains the following steps:

  1. Add Rapise extension to the organization using Visual Studio Marketplace.
  2. Configure SpiraTeam connection Point for the project.
  3. Define a pipeline.
  4. Add RapiseLauncher task to the pipeline.
  5. Configure a pipeline definition for executing tests via RapiseLauncher.

Step 1: Install Marketplace Extension for the Organization

In Azure DevOps go to Organization settings:

vstest_rl_orgsettings.png

Choose Extensions and then Browse Marketplace:

vstest_rl_orgextensions.png

Type `Rapise', choose 'RapiseLauncher' extension:

vstest_rl_orgextensions_rapise.png

Get it:

vstest_rl_orgextensions_rapise_get.png

And install it:

vstest_rl_orgextensions_rapise_install.png

Finally it shows up in the list of installed extensions:

vstest_rl_orgextensions_rapise_installed.png

Step 2: Connect Project to SpiraTeam

Now define a service connection. It is a connection details for SpiraTeam used later to gather test set information. So we need ot open Project settings:

vstest_rl_projsettings.png

Go to Service Connections:

vstest_rl_serviceconnections.png

And Create service connection:

vstest_rl_serviceconnections_create.png

Choose Spira service connection connection type (this type is added by the installed marketplace extension) and press Next:

vstest_rl_serviceconnections_spira.png

Now define connection details: SpiraTeam Server Url, Username and API Key: vstest_rl_serviceconnections_verify.png

Then Verify it and give a Service connection name:

vstest_rl_serviceconnections_verifyandsave.png

Finally, the connection shows up in the list:

vstest_rl_serviceconnections_ready.png

Step 3: Define a Pipeline

Defining a pipeline means telling the DevOps where to store the pipeline definition, where get the tests, what VM to use for execution and what parameters to pass.

Define a Repository

In the case that you don't have a repository, just define one for the given project:

vstest_rl_pipeline_create_0_preparerepo.png

If you have a repo, then you may skip this step and use your repository connection on the next step.

Create a Pipeline Definition

Go to your project, expand Pipelines and choose Create Pipeline:

vstest_rl_pipeline_create.png

Select GIT repository type

vstest_rl_pipeline_create_1_repo.png

And repository itself:

vstest_rl_pipeline_create_2_selectrepo.png

Here we are creating new pipeline. But you may use existing one and just add test execution task to it.

vstest_rl_pipeline_create_3_selectpipeline.png

RapiseLauncher requires Windows host. You may use Microsoft Hosted agent, or set an agent on your own VM or physical Windows machine.

vstest_rl_pipeline_create_4_vmimage.png

Step 4: Add RapiseLauncher Task

Then you may use Assistant to configure the task.

vstest_rl_pipeline_create_5_showassistant.png

vstest_rl_pipeline_create_6_showassistant.png

And filter by word 'Rapise'. We need a task Run Rapise Test Set:

vstest_rl_pipeline_create_7_showassistant_rapise.png

Now we need to fill task execution parameters as follows:

  • SpiraTeam contains information for finding a test set
  • Spira service/server end point - choose spira connection defined earlier from the dropdown. vstest_rl_pipeline_create_9_ext_spira_proj.png
  • Spira Product

  • Spira Test Set

  • Automation Host

  • Execution Options

  • Rapise Needs to Be Installed - if your VM is spawned for each test execution (i.e. you use Microsoft-hosted Agent), then the task may install it. You don't need to install Rapise if you use own agent and install in advance. Also you may have more than one Run Rapise Test Set tasks in your pipeline. In this case only the first one may need to install Rapise.

    • Rapise Version - we recommend to specify the same version that you used to create tests. I.e. Rapise Version
  • Advanced Execution Options

  • Set Screen Resolution specify one of standard screen resolutions for test execution. It should be one of standard values (i.e. 1024x768, 1920x1080, etc., supported by the current execution host). Bigger resolution - more details on screenshots and video and more space is consumed by the recordings.

    • Width
    • Height
  • Record Video of Execution a ScreenCapture.wmv will be generated and saved as a Test Run attachment.

    • Video Recording Options set of options for Microsoft.TestPlatform video recorder.
  • Publish RapiseLauncher Log when enabled, RapiseLauncher log is attached to pipeline build log.

    Log

  • GITROOT is only needed when your tests are stored in GIT and you check them out earlier in the pipeline or even before launching the pipeline.

vstest_rl_pipeline_create_10_ext_adv_obj.png

Finally press Add. The task should show up in the steps: section of the yaml description:

vstest_rl_pipeline_create_11_ext_yaml.png

You may then tweak its configuration directly using the text editor.

trigger:
- main

pool:
  vmImage: windows-latest

steps:
- task: RapiseLauncherTask@1
  inputs:
    spiraConnection: 'SpiraConnection'
    spiraProjectId: '93'
    spiraTestSetId: '145'
    spiraAutomationHost: 'AZURE'
    installRapise: true
    rapiseVersion: '6.7.22.25'
    setScreenSize: true
    screenWidth: 1920
    screenHeight: 1080
    recordVideo: true
And then execute. vstest_rl_pipeline_create_13_ext_run.png vstest_rl_pipeline_create_14_ext_saverun.png vstest_rl_pipeline_create_15_queue.png

Step 5: Pipeline Execution Results

You may see history of pipeline job runs and test execution logs.

From the pipeline runs history you may pick up any run:

vstest_rl_pipeline_runhistory_10

And select the Job:

vstest_rl_pipeline_runhistory_11

The job run contains information of each pipeline step. RapiseLauncher is a step doing Rapise installation and test set launch.

vstest_rl_pipeline_runhistory_12

Also you may find testing reports and videos in the SpiraTeam:

vstest_rl_pipeline_runhistory_13

Log files and videos are in the Test Run Attachments tab:

vstest_rl_pipeline_runhistory_14

See Also