Skip to content

Getting started

Build a two-step workflow, export it as Argo Workflows YAML and run it. You don’t need a cluster to get the YAML.

The Dagweave app is in early access, by invitation. Join the waitlist at dagweave.com/early-access. Once you’re in, Dagweave emails you a sign-in link. After that, sign in at app.dagweave.com.

To run Argo YAML on your laptop, you don’t need an account. Use the free Dagweave Local.

A short tour opens the first time you sign in. Close it to get an empty canvas.

An empty Dagweave canvas with Add a trigger and Add a step buttons in the middle and the workflow settings panel on the right.An empty Dagweave canvas with Add a trigger and Add a step buttons in the middle and the workflow settings panel on the right.
  1. Click Add a step, type script and pick Script.
  2. In Configure Script, leave Language as bash, enter echo "hello" as the Script, and click Add step.
  3. Click the + on that step, pick Script again, enter date and click Add step. This step runs after the first one finishes.
  4. Open the gear menu, choose Workflow settings and set Output kind to Workflow. A new canvas starts as a WorkflowTemplate, which argo submit and Dagweave Local can’t run.

To change a step, select it and edit it in the panel on the right. To pass a value or file between steps, drag from one step’s output to another’s input. See Wiring data and nesting.

Click the caret beside Run and choose Get YAML. Click Copy, or Download to save a file named after your workflow.

The Get YAML drawer open beside a six-step workflow, showing the compiled WorkflowTemplate YAML with Copy and Download buttons.The Get YAML drawer open beside a six-step workflow, showing the compiled WorkflowTemplate YAML with Copy and Download buttons.

It’s standard Argo YAML you can commit and review like any manifest. Tasks are named after their steps, so yours are script and script-2. Rename a step in the right-hand panel to change that. The only thing Dagweave adds is a dagweave/step-types annotation, which Argo ignores.

These commands use hello.yaml. Swap in the name of your file.

On a cluster with Argo Workflows:

Terminal window
argo submit hello.yaml

A WorkflowTemplate or CronWorkflow isn’t a run. Apply it with kubectl apply -f.

On your laptop, with Dagweave Local:

Terminal window
dagweave run hello.yaml

This one needs Docker running. Run a workflow says which steps do.

In the app, Run sends the workflow to a connected cluster, or to your laptop while it runs dagweave listen. Running on a cluster needs the Production or Business plan. Running on your laptop from the app needs Developer or above. See Plans and billing.

Add a step has two groups:

  • Core: Script, Container, HTTP, Suspend, Git checkout, Git commit & push, Resource, ContainerSet and Plugin.
  • Catalog: ready-made steps for common jobs.

Every plan gets every step in Core. The Free plan gets six of the catalog steps. The step reference covers each type.