Skip to content

Commit

Permalink
Updated metas & a Test Machine doc (#323)
Browse files Browse the repository at this point in the history
  • Loading branch information
bharathk08 authored Nov 14, 2023
1 parent 95812cc commit cec3922
Show file tree
Hide file tree
Showing 6 changed files with 105 additions and 41 deletions.
12 changes: 8 additions & 4 deletions src/pages/docs/continuous-integration/aws-devops.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: " Integrate Testsigma with AWS DevOps"
metadecs: "How to integrate Testsigma with AWS DevOps"
metadecs: "This article discusses step-by-step instructions for integrating Testsigma application with AWS DevOps | Learn how to integrate AWS DevOps with Testsigma Application"
order: 12.15
page_id: "Integrate Testsigma with AWS DevOps"
warning: false
Expand All @@ -16,13 +16,16 @@ contextual_links:

AWS services that are used as a part of CI/CD pipeline are:

**CodeCommit:** AWS CodeCommit is a version control service that enables you to privately store and manage Git repositories in the AWS cloud.
**CodeBuild:** CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy.
**CodeCommit:** AWS CodeCommit is a version control service that enables you to privately store and manage Git repositories in the AWS cloud.<br>

**CodeBuild:** CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy.<br>

**CodeDeploy:** AWS CodeDeploy is a deployment service that enables developers to automate the deployment of applications to instances and to update the applications as required.


---
##**AWS DevOps integration methods:**

## **AWS DevOps integration methods:**

Below are the 2 methods to integrate and trigger Testsigma tests via AWS DevOps:

Expand Down Expand Up @@ -114,3 +117,4 @@ That's all we need to automate Test Execution when a successful build is trigger



---
4 changes: 3 additions & 1 deletion src/pages/docs/continuous-integration/github-cicd.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Integrate Testsigma with Github"
metadecs: "This document describes detailed step-by-step instructions for integrating Testsigma with Github | Learn how to integrate Github with Testsigma"
metadecs: "This article discusses step-by-step instructions for integrating Testsigma application with Github | Learn how to integrate Github with Testsigma Application"
order: 12.21
page_id: "github-cicd"
warning: false
Expand All @@ -19,13 +19,15 @@ contextual_links:
When you want to automate, customize, and, execute your software development workflows right in your github repository, you need to use github actions. In this document, we will discuss how to integrate Github with Testsigma for CI/CD purposes.

---

## **Pre-requisites:**
You should already know:
1. The basics of github actions. If not, please refer here: [Quickstart with github actions](https://docs.github.com/en/actions/quickstart)
2. [How to generate an API key from Settings.](https://testsigma.com/docs/configuration/api-keys/)
2. [How to get Test Plan ID from an existing Test Plan.](https://testsigma.com/docs/continuous-integration/get-test-plan-details/)

---

## **For Github CICD Integration:**

To start with Github Actions, create a .github/workflows directory in your repository on GitHub if this directory does not already exist.
Expand Down
11 changes: 9 additions & 2 deletions src/pages/docs/integrations/collaboration/microsoft-teams.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Integrating MS Team with Testsigma for test run notifications"
metsdesc: "Learn how to configure a Microsoft Teams channel to receive notifications about Test Results in real-time from Testsigma Application."
metsdesc: "Configure Microsoft Teams channel to receive notifications about Test Results in real-time from Testsigma Application | Testsigms Integration with MS Team"
order: 16.22
page_id: "Integrating MS Team with Testsigma for test run notifications"
warning: false
Expand All @@ -23,12 +23,14 @@ contextual_links:
Integrating Testsigma with Microsoft Teams is similar to integrating with other collaboration tools like Google Chat and Slack.

---

## **Prerequisites**

We need a Microsoft Teams Connector to integrate with Testsigma. To know how to generate an Incoming Webhook in MS Teams, refer [Create an incoming Webhooks | MS Teams](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook)<br>
Microsoft Teams Connector is an Incoming Webhook mapped to a specific Channel in your organization and we will be using the connector to post the Test Results on that Teams channel.

---

## **Integrating Microsoft Teams with Testsigma**

Once the Connector URL is obtained, navigate to the Plugins page through **Dashboard > Settings > Plugins** and select **MS Teams** under the **Collaborations** Tab.
Expand All @@ -38,6 +40,7 @@ Once the Connector URL is obtained, navigate to the Plugins page through **Dashb
After entering the details, click on the Create button to add the Integration.

---

## **Enabling MS Teams notifications in Test Plan**

Once the MS Teams integration is added, you can enable the MS Teams notifications for your Test Plans while editing any of your existing Test Plans or while creating a new Test Plan.
Expand All @@ -52,6 +55,10 @@ From the **Send Notification When** section on the Test Plan Settings page,
The first and second line shows the integration added to the channel.<br>
The third line shows the **Test Plan Completed** notification when the Test Plan completes.


Click on the **View in Testsigma** link to check the details inside the Testsigma App.

![MS Teams Integration for Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/msint.gif)

![MS Teams Integration for Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/msint.gif)

---
4 changes: 2 additions & 2 deletions src/pages/docs/integrations/product-management/clickup.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Integrate Testsigma with Clickup"
metadecs: "How to integrate Testsigma with Clickup for real-time bug reporting during Test Runs | Push bugs directly from Testsigma to your Clickup project"
metadecs: "Learn how to integrate Testsigma with Clickup for real-time bug reporting during Test Runs | Push bugs directly from Testsigma to your Clickup project"
order: 16.55
page_id: "Clickup"
warning: false
Expand Down Expand Up @@ -28,7 +28,7 @@ To integrate Clickup with Testsigma, you need the following:
- **API Key:** API Token from Clickup.

[[info | **NOTE**:]]
|*For more information on how to create API token in Clickup, refer to Clickup [personal API key](https://help.clickup.com/hc/en-us/articles/6303426241687-Getting-Started-with-the-ClickUp-API).*
| *For more information on how to create API token in Clickup, refer to Clickup [personal API key](https://help.clickup.com/hc/en-us/articles/6303426241687-Getting-Started-with-the-ClickUp-API).*

---

Expand Down
3 changes: 1 addition & 2 deletions src/pages/docs/integrations/product-management/linear.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
title: "Integrate Testsigma with Linear"
metadecs: "How to integrate Testsigma application with Linear for real-time bug reporting during Test Runs | Push bugs directly from Testsigma to your Linear project"
metadecs: "Learn how to integrate Testsigma application with Linear for real-time bug reporting during Test Runs | Push bugs directly from Testsigma to your Linear project"
order: 16.52
page_id: "Linear"
warning: false

contextual_links:
- type: section
name: "Contents"
Expand Down
112 changes: 82 additions & 30 deletions src/pages/docs/test-management/test-plans/manage-test-machines.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Manage test machines in test plans"
title: "Manage Test Machines in Test Plans"
metadesc: "Easily manage test machines in Test Plans, which helps allocate tests to specific machines. Learn how to allot test machines for test plans in Testsigma."
noindex: false
order: 8.22
Expand All @@ -9,61 +9,113 @@ contextual_links:
- type: section
name: "Contents"
- type: link
name: "Add a test machine to an existing test plan"
url: "#add-a-test-machine-to-an-existing-test-plan"
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Adding a Test Machine to an Existing Test Plan"
url: "#adding-a-test-machine-to-an-existing-test-plan"
- type: link
name: "Adding a Test Machine From Edit Test Plan Page"
url: "#adding-a-test-machine-from-edit-test-plan-page"
- type: link
name: "Delete test machine"
url: "#delete-test-machine"
---


---

As discussed under the [create test plan section](https://testsigma.com/docs/test-management/test-plans/overview/#steps-to-create-a-test-plan), you must add at least one test machine to a test plan to create a test plan successfully. Test machines can be added for *cross-browser testing* and *distributed testing*.
While creating a test plan, you must add at least one test machine to a test suite to develop it successfully. This article discusses how to manage test machines in test plans.

For *cross-browser testing*, test machines and test suites are selected separately. On execution, all the selected test suites are run on all selected test machines (in parallel or sequentially, depending on your selection).

For *distributed testing*, you can split test suite execution across multiple machines. To do this, Testsigma lets you select different test suites for each selected test machine. This helps reduce execution time too.
---

## **Prerequisites**

- You should know how to [create a test suite](https://testsigma.com/docs/test-management/test-suites/overview/#creating-a-test-suite).

- You should know how to [create a test plan](https://testsigma.com/docs/test-management/test-plans/overview/#steps-to-create-a-test-plan).

The following article discusses adding, editing, or deleting test machines from an existing test plan. *For more information on how to add a test machine while creating a test plan, refer to [test plan](https://testsigma.com/docs/test-management/test-plans/overview/)*.

---

## **Add a test machine to an existing test plan**
## **Adding a Test Machine to an Existing Test Plan**

1. Navigate to **Test Plans** and click on an existing test plan.

![Test Plans](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpnav.png)

1. Navigate to **Select project**> **Test development**>**Test plan**.
2. Click on an existing test plan.![clicking Test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ts_openingexistingtestplan.png)

3. In the **Test devices and suites** tab. Click **Add new** to add the test machine for test execution.![test device and suites](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ts_testsuitesmachinesaddnew.png)
2. On the **Test Plan Details** page, click on **Add Machine**.

4. Add or edit the necessary details on the **Select test machines/ suites** overlay.![select test device overlay](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ts_selectedtestmachinesandsuites.png)
5. Click **Update**.
![Add Machine](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpatm.png)

3. On **Add test machine/device profile** overlay, add **Name** and click on **Add/Remove Test Suites**.

![Add Profile](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitptmprofile.png)

Alternatively, you can add a new test machine by **editing the test plan**. *For more information on editing the test plan, refer to [updating test plan](https://testsigma.com/docs/test-management/test-plans/overview/#edit-test-plan)*.
4. Select test suites and click on **Add to Plan**.

![Edit test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ts_editanddetails.png).
![Add to Plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpaddtoplan.png)

1. Navigate to the **Edit test plan** page.
2. Under the **Test machines & suites selection** tab,select the test suite for which you want to add the test machine for test execution.
![test machine and test suites selection](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-management/test-plans/overview/edit_machine_edit_test_plan.png)
3. Once you have selected the test suites that you want to add the test machine for, click on the **Add machine** button.
5. Click on **Create Machine**.

4. Select either of the two options **Create new machine** or **Add to existing machine** from the drop-down list.
![add machine](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-management/test-plans/overview/add_machine_edit_machine_details.png)
![Create Machine](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpcrmac.png)

1. If you want to add the selected test suite to an existing machine then click on the option **Add to existing machine**. A layover **Add Test suites to machineor device** appears with a list of the existing machines as shown in the screenshot below:
![add test suites to machine](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-management/test-plans/overview/add_test_suites_machine_or_device.png)
Select the machine that you want to execute the test suite on. To finalize the change, click on **Next** and **Update**.
2. If you want to create a new machine then click on the option **Create new machine**. A layover **Add machine** appears, as shown in the screenshot below:![Add machines](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-management/test-plans/overview/add_machine.png).Provide the necessary details and click **Create**.
5. To finalize the change, click on **Next**>**Update**.
6. A New machine will be added to the test plan.

![Machine Added](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpmiattp.png)

Alternatively, you can also add new machines from the edit test plan page.

Here’s the GIF demonstrating how to add test machines to an existing test plan.

![Add Test Machine to Test Plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/TestMachine.gif)

---

## **Delete test machine**
## **Adding a Test Machine From Edit Test Plan Page**

1. Navigate to **Test Plan** and click on an existing test plan.

![Test Plans](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpnav.png)

2. On the test plan details page, click on **Edit**.

![Edit](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpedit.png)

3. Go to **Add Test Suites & Link Machine Profiles** and click on **Test Machine**.

![Add Test Suites & Link Machines](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpstwo.png)

4. From **Select test machine profiles** overlay, select test machines and click on **Save selections**.

![Select Test Machines](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpsss.png)

5. Go to **Test Plan Settings** and click on **Update**.

![Settings](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpsupdate.png)

6. Selected machines will be added to the test plan.

---

## **Delete Test Machine**

1. Navigate to **Test Plan** and click on an existing test plan.

![Test Plans](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpnavtpe.png)

2. On the test plan details page, click on **Kebab Menu** and click on **Delete**.

![Kebab Menu](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpkm.png)

3. On the **Delete Test Machine?** prompt, enter **DELETE** and click on **I understand, delete this Test Machine**.

![Delete](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/tmitpprompt.png)

In case you need to delete an already added test machine in a test plan, follow below steps:
Here’s the GIF demonstrating how to delete test machines in test plan.

You can delete the test machine through the **Edit test plan** > **Test machine & suites selection** tab.
![Delete Test Machine in Test Plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/DeleteTestMadhine.gif)

1. On the **Test machine & suites selection** tab, hover over the test machine you want to delete and click **Delete** on the test machine.![delete test machine](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ts_testsuitesdeleteeditpage.png)
---

0 comments on commit cec3922

Please sign in to comment.