To help teams meet their testing goals, mabl includes a range of options for running plans. This article explains the different ways you can trigger plan runs in mabl, including how to…
- Run a plan ad hoc
- Run a plan on a schedule
- Run a plan in a deployment event
- Run individual stages in plans
- Rerun a failed plan run
Note
Plans always run in the cloud. It is not possible to run a plan locally.
In the mabl CLI, you can trigger a local run of all tests in a plan with the --from-plan-id
option: mabl tests run –from-plan-id
. Tests execute sequentially in alphabetical order by test name. This is not considered a plan run, since the settings configured at the plan level, such as concurrency, stages, DataTable scenarios, and shared variables, are not used.
How to run a plan ad hoc
Triggering an ad hoc plan run can be helpful when you want to make sure everything is working as expected. To trigger an ad hoc plan run, take the following steps:
- Click on Plans in the left-hand navigation menu.
- Locate the plan that you want to trigger.
- Click the play button in the far right column.
Alternatively, open the plan details page for that plan and click on the Run button.
Running a plan from the plan details page
To trigger an ad hoc plan run on a branch:
- Click on the down arrow next to the Run button.
- Select "Configure plan run".
- Select the branch from the dropdown.
- Click on the Run now button.
For more details on branch runs, see the article on running tests on branches.
Running a plan on a branch
Ad hoc test runs
For more information on running a single test ad hoc, see the article on ad hoc test runs.
How to run a plan on a schedule
To run a plan in set intervals or at specific times on specific days, edit the plan and add a new plan trigger. See the article on scheduling tests for more information.
Adding plan triggers
Note
The timer and schedule triggers are not supported for branched plan runs. If you want to set up a recurring trigger for a branched version of your plan, use deployment events and check out the scheduling capabilities for your team’s CI/CD tool.
How to run a plan in a deployment event
Use deployment events to trigger a group of plans in your workspace that match a set of specific conditions, such as application, environment, or plan label. See the article on deployment events for more information.
How to run individual stages in plans
If you want to run a single plan stage for troubleshooting purposes, take the following steps:
- Click Plans in the left-hand navigation.
- Click on a plan to open the plan details page.
- Click on the play button next to the title of the stage you want to run.
Running individual plan stages
How to rerun a failed plan run
Automatic retries
If the plan run was triggered by a schedule or a deployment event, you may configure the plan to automatically re-run on failure in the Advanced section of the edit plan page.
Manual retries
If a plan run was manually triggered and contains at least one failed or skipped test, you can rerun part or all of that plan run on the plan details page. Click on the rerun button next to that particular plan run, and select from one of the following options:
- Rerun all tests in this plan
- Rerun only failed tests in this plan
- Rerun failed and skipped tests in this plan
Rerunning a plan run with failed and skipped tests