Workflow Create

Create workflow from a path, hub, or URL

Usage

Terminal
dxflow workflow create <SOURCE> [OPTIONS]

Options

FlagShorthandDescriptionTypeDefault
--identity-iWorkflow identitystring``
--start-sStart workflow once it is createdboolfalse
--link-lAssign a link to every step declaring one, alongside a startboolfalse

SOURCE is the workflow to create, resolved to its YAML before it is sent to the engine:

  • a local path — ./workflow.yml or /abs/workflow.yml (a bare path is read as a file:// file);
  • file://<path> — an explicit local file;
  • hub://<name> — a workflow from the dxflow hub, by name;
  • http://… / https://… — fetched over HTTP.

--start runs the workflow as soon as it is created, in the same call, using the workflow's existing workflow.ini. To set per-run values, create the workflow and pass --override to workflow start.

--link goes with --start and assigns a link to every step declaring one under link in the definition, while the license carries any. The success line carries what the start assigned, one [link → step] detail per link.

This command runs against a running engine — start one with boot up.

Example

Terminal
dxflow workflow create ./workflow.yml

dxflow workflow create hub://fastqc --identity my-fastqc

dxflow workflow create ./workflow.yml --start

dxflow workflow create ./workflow.yml --start --link