Executions
Note
- Executions are owned by users and belong to a digital twin
- Executions consist of components that are run in sequence
- The output of one component will serve as input to the next component
graph LR
component-example_0.1.0 --> travel_dashboard_0.2.1;
On this page you can manage your executions, specify and save them, so that they can be later selected for running them.
List executions
The Execution page assumes that you have selected both a user and a digital twin to work on. You can go to the "EXECUTION TABLE" Tab and list all executions that belong to the digital twin
Select execution
Existing executions can be selected in order to run them: when you select an execution you see a button: "PREPARE AND RUN EXECUTION": click on it and you will get to a run page where you can run the execution: see run executions
In the Dashboard you are guided through the process of creating an execution step by step:
Add an execution
An execution consists of components and can have extra port mappings and parameters.
digital-twin-id
(Optional): Obtained before. Alternatively, you can use the name of the digital twin.digital-twin-name
(Optional): Name of the digital twin. Alternatively, you can use thedigital-twin-id
.name
: A name for the executioncomponent-tags
: All components tags (componentA:v0.1.0
) involved in the workflow aligned sequentially and separated by commas.parameter-files
: Parameters files separated by commas.- This file should contain all parameters used like in a dotenv file format.
ports
: Ports matching used by the containers.- Components ports should be separated by
,
. i.e.8763:3000,8501:8501
- Place as many
,
as connections between components (steps). If ports are not being used in the first, and second component: i.e.,,8501:8501
- If multiple ports are being use in the same step please use
+
: i.e.,,8501:8501+3000:3000
- Components ports should be separated by
In the GUI a form is offered to guide you through the process of specifying all these elements. In the CLI you have to add all elements yourself:
In order to better understand these workflows it is best to set up workflow repos as we did in some of our use cases:
These repos help you to setup executions in both CLI and the GUI
In the Dashboard you are guided through the process of creating an execution step by step:
First you need to name your execution:
Select component versions as workflow steps. The components and versions that you can use here must have been added at the components page, see components and versions.
Next you may add parameters from file. In a later step you can also overwrite those initial settings from file.
So here you can overwrite parameters, delete rows or add additional parameters:
Next you need to add port mappings: this is only necessary for persistent components and for the mapping you need to know the component port, that was registered with the component, see components and versions.
Check your execution and save it if everything is correct. If not, you can walk back through the steps and correct your settings without loosing any information that you already correctly.
Once the execution is save you can run it. See above on Selecting an execution.
A set of parameters is a file containing all the variables needed to run that component.
The components tags are formed by component name and version tag from github:
Prepare and run an execution
Please refer to section Run Executions ⧉
Delete an execution
Excutions and all associated data, such as MongoDB entries, S3 Files, and project path folders can be easily deleted. In v0.4.0
this feature is only available in the CLI