A Run in Domino is the execution of code or hosting of a workspace session on an executor machine. Each Run keeps a snapshot of all your files, including any results the code creates, including charts, tables, data files, and serialized model data. All assets are versioned and can be compared across different Runs.
You can start multiple concurrent Runs. Each gets its own machine, so you can try multiple parameters and techniques in parallel. You can schedule recurring runs and set up notifications, including customized reports.
Starting a Run in Domino
Domino offers several ways to launch runs:
- From the project Runs dashboard
- From the project Files page
- From the CLI
- Via schedulers
- Via launchers
- Via API
- From the Quick Action menu
When you start a run, Domino launches a new environment for your code. When you have a Run selected in the list, the right panel will show the output of stdout from the container hosting the Run, along with tabs to view resource usage and results. You can browse the history of the project's Runs in the center panel, and click the Run button at the top to start a new Run.
After clicking the Run button, you will see a Start Run window with options to configure the Run. You need to enter the filename of the script you want Domino to execute, followed by any arguments the script takes.
You can start a Run directly from the project Files page. Find the file you want to run and click the gear icon to the right of its entry in the files list, then click Run.
You will then see a Start Run window you can use to configure the Run. This window has additional options to set up recurring scheduled Runs and select different hardware tiers.
In this field, enter a name for the Run. This name will be the label for the Run in the Runs dashboard.
If there are any arguments or parameters you’d like to pass to your script, enter them here.
- Hardware tier
This dropdown list lets you set the hardware tier used by the run.
- Schedule to repeat
In this section, specify if you want the run to execute only once, or to repeat on a schedule.
- Publish after complete
Check this if you want Domino to republish a Model API once the run completes successfully.
From your workstation, you can start runs through the Domino CLI . Follow these instructions to install the CLI on your system.
Once you have logged in and opened a project, you can start runs with:
domino run <filename>
domino run calculateStats.r
domino run runModel.m model1 .05
domino run --wait runModel.m model1 .05
domino run --direct "pip freeze | grep pandas"
Domino allows you to schedule runs in advance, and set them to execute on a regular schedule. These can be useful when you have a data source that is updated regularly.
To schedule a run, or manage existing scheduled runs, click Scheduled Runs from the project menu. You will see a detailed dialog you can use to configure a scheduled run.
- Command to run
Enter the name of the file you’d like to execute. Include any optional arguments you wish to pass to your file.
- Publish after complete
Check this if you want Domino to republish a Model API after the Run completes.
- Schedule options
Here you can set the frequency at which you want the run to repeat.
- Pause schedule
Checking this box prevents the runs from executing on the specified schedule.
- Run Sequentially or Run Concurrently
Some runs cannot begin unless they have access to output from prior runs. By selecting Run Sequentially, you will ensure that each run will begin only when the preceding run is complete. By contrast, Run Concurrently allows Runs to launch independently of each other, and should be used when your Run doesn’t require output from previous Runs.
- Emails to notify
In this field, add the email addresses of everyone who should be notified when the run completes.
- Hardware tier
This drop-down list enables you to set the hardware tier used by the run.
In this field, enter a name for the run.
For more information, see Scheduling Runs.
A Launcher is a web form that rests on top of a script that Domino can execute in a Run. You can use a Launcher to pass arguments to your script from UI fields in a customized web form.
For more information, see Launchers.
You can use the Domino API to start a run with a POST request to:
For more information on how to send valid configuration data, read the API docs.
On Domino 3.2+ you can launch a Run from the Quick Action menu.