> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# cloudqa/suite-runner

Automate Web Testing with CloudQA codeless selenium tests on CircleCI.


## Jobs

### execute

Trigger your CloudQA test suite from CircleCI build by passing parameters "Suite Id", "Browser (optional)","Tag (optional)","Variables (optional)", "Sequential Execution (optional)" and "Environment Name (optional)". Note: CLOUDQA_API_KEY will be pulled from the CiricleCI build environment variables. Your build status depends on the test suite status.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `browser` | string | Chrome | (optional) Modify the browser to execute your suite against, defaults to `Chrome`. |
| `build-tag` | string |  | (optional) Modify the build tag to set build id of your suite, defaults to ``. |
| `environment-name` | string |  | (optional) Modify the environment name to execute your suite against, defaults to ``. |
| `image` | string | cimg/base:stable | The Docker image for this job environment. CircleCI's `cimg/base:stable` will be used by default. Find other comptable images and tags here: https://hub.docker.com/u/cimg
 |
| `is-sequential-execution` | boolean | true | (optional) Modify the is sequential execution to execution type(sequential, parallel) of your suite, defaults to `true`. |
| `suite-id` | string |  | ID of the CloudQA suite to execute. |
| `variables` | string |  | (optional) Modify the variables to set variables of your suite, defaults to ``. |

## Examples

### execute_cloudqa_tests

Execute CloudQA test suites automatically be adding the `execute` job to your workflow.


```yaml
version: '2.1'
orbs:
  suite-runner: cloudqa/suite-runner@2.0.3
workflows:
  test-my-app:
    jobs:
      - suite-runner/execute:
          browser: Chrome
          build-tag: Circle CI demo
          environment-name: QA
          image: cimg/base:stable
          is-sequential-execution: false
          suite-id: <your-cloudqa-suite-id>
          variables: cicd1=1,cicd2=2,cicd3=6
```