Concourse

SimplifyQA supports integration with Concourse, a popular CI/CD tool, allowing seamless execution of test pipelines directly from your automation flow.

Prerequisites

Before you begin, ensure the following are ready:

• A working code editor (e.g., Visual Studio Code)

• FLY CLI installed on your system

• Pre-defined integration files provided by the SimplifyQA team

Create a Pipeline in SimplifyQA

1. Log in to your SimplifyQA account

2. Navigate to the Pipelines section from the left-hand panel.

1. Click on +Pipeline to create a new one.

1. Enter a meaningful name for your pipeline.

1. Enter the required details and click on save to create the pipeline

Configure the pipeline details:

• Pipeline Type: Choose whether you want to run on Test Case or Suite

• Execution Type: Choose whether you want to run on Local or Cloud

  • Local Execution

    If you choose to run tests locally:

    • Select Local under Execution Type.

    • You must specify the Local Machine Name where the SimplifyQA Agent is installed and running.

  • Cloud Execution

    If you opt for Cloud Execution, you need to register your execution environment on the cloud first. This allows to spin up virtual machines or containers for remote execution. Refer to VM Based to configure your cloud.
• Test Case/Suite ID: Enter the corresponding ID

• Version & Execution Type: Select the desired versions

• Machine Name: Specify the machine for test execution

• Environment: Choose the target environment

• Release and Sprint: Define these for tracking purposes

Download the Concourse Integration Files

1. Get the integration package from the SimplifyQA team.

2. Open the folder in Visual Studio Code (or your preferred code editor).

3. Locate and open the file named test.ps1 – this file is used to trigger executions in Concourse.

Log In to Concourse

1. From test.ps1, copy the Concourse URL mentioned.

2. Paste it into your browser and log in to your Concourse account.

3. Once logged in, you will be able to see your existing pipelines and manage them.

Configure & Run a New Pipeline

1. In the test.ps1 file, fill in the required configuration fields:

   • Pipeline ID: The ID from the pipeline created in SimplifyQA

   • Pipeline Name: The Name of the pipeline

   • API URL: Your SimplifyQA base URL

   • Threshold: Sets the minimum pass percentage for the test suite. If the actual result falls below this value, the CI/CD pipeline will fail.

   • Verbose Flag: Enables detailed execution logs when set to true. Useful for debugging or analyzing step-by-step test results.

   • API Key: Your SimplifyQA Machine registration token. Go to Profile > Manage Account > Security

Note - If your machine is not registered kindly refer to Register your Machine

1. To trigger multiple pipelines, add additional pipeline IDs accordingly.

2. Save the file.

3. Run the following command in your terminal:

   ./test.ps1

4. Accept the command in the response body of the terminal.

5. This will create and execute the new pipeline in Concourse.

Once configured, you’ll have a fully functional CI/CD integration where SimplifyQA pipelines can be managed and triggered from Concourse, enhancing your test automation workflows.