# 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.

<figure><img src="/files/CVfvkb3CVHzgso8QN6n9" alt=""><figcaption></figcaption></figure>

3. Click on **+Pipeline** to create a new one.

<figure><img src="/files/hXcQj4QqOopymXGRX0iR" alt=""><figcaption></figcaption></figure>

4. Enter a meaningful name for your pipeline.

<figure><img src="/files/5dROO9qvUCudexOSNjbW" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/d3YPSj2LMUHlS8NPI6Yt" alt=""><figcaption></figcaption></figure>

#### 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](/marketplace/integrating-with-cloud-platforms/vm-based.md) 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.&#x20;
     * **Go to Profile > Manage Account > Security >  Create & Manage API Token**.
     * Click **Generate Token**, name your token, and click **Save**.
     * Copy the generated API key and paste it into the configuration.

<figure><img src="/files/XXQkaNrqStMAoiTulIAW" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Note -** If your machine is not registered kindly refer to [Register your Machine](/simplifyqa-installation-and-setup/register-your-machine.md)
{% endhint %}

2. To trigger **multiple pipelines**, add additional pipeline IDs accordingly.

3. Save the file.

4. Run the following command in your terminal:

   ```
   ./test.ps1
   ```

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

6. 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.simplifyqa.ai/marketplace/integrating-with-ci-cd-tools/concourse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.