Skip to main content

Key terms

Workflow​

A workflow is a YAML file that defines an automation pipeline. It contains jobs, their dependencies, triggers, and configuration. Workflows are identified by a unique id within a workspace.

Job​

A job is an independent unit of work within a workflow. Jobs contain steps that execute sequentially. Multiple jobs can run in parallel unless dependencies are specified with depends_on.

Step​

A step is a single action within a job. Each step performs exactly one action: running shell commands (run), uploading files (upload), or downloading files (download).

Runner​

A runner specifies the compute environment for job execution. Runners are configurable Sandbox Engine templates that define resources like CPU, memory, and GPU availability.

Workspace​

A workspace is an organizational container for workflows and related resources. All workflows execute within a specific workspace and inherit its Role-Based Access Control (RBAC) permissions.

Input​

An input is a typed parameter that you provide when triggering a workflow. Inputs support three types: string, bool, and int. Reference inputs in expressions using ${{ .inputs.<name> }}.

Secret​

A secret is sensitive data stored in H2O Secure Store. Secrets are defined at the workflow level and referenced using ${{ .secrets.<name> }}. Values are masked in logs and the UI.

Expression​

An expression is a dynamic value placeholder using the ${{ }} syntax. Expressions can reference inputs, secrets, environment variables, and matrix variables.

Matrix​

A matrix defines multiple values for job variables, creating parallel job instances for each combination. Access matrix values using ${{ .matrix.<variable> }}.

Trigger​

A trigger defines when a workflow executes. Schedule triggers use cron expressions for recurring execution. The callable trigger allows other workflows to call this workflow.

Concurrency group​

A concurrency group prevents multiple workflow instances with the same group identifier from running simultaneously. Use cancel_in_progress to control queuing behavior.

H2O Drive​

H2O Drive is the cloud storage service used for uploading and downloading files during workflow execution. Drive URLs use the format drive://bucket-name/path/to/object.

Feedback