Skip to main content
Version: Early Access

Manage Workflows

This topic describes how to create, run, and manage workflows.

Create New Workflows at Folder-Level​

  1. Create a new folder under Folders section and select the folder.
  2. Click Workflows in the left-navigation pane. It displays the following tabs in the left-navigation pane within the folder.
  • Workflows templates
  • Workflow executions

Note: Templates and Workflows in a folder must have unique names.

  1. In the Workflows templates tab, click New workflow template. It opens the Create workflow page. Create Workflow
  2. Enter the required values in the Create workflow page.
  3. Enter a unique name for the workflow in the Template name field.
  4. Assign a category to the workflow by selecting one or more categories in the Workflow categories drop-down list.
  5. You can see that the folder where the workflow is being created is selected by default in the Default execution folder drop-down list. You can change the folder based on your requirements.
  6. Allow user to change the execution folder (enabled by default) - This allows the workflow user to change the execution folder when you run the workflow.
  7. Allow restart in execution view (enabled by default) - This controls whether running workflows can be restarted from the execution (stepped) view.
  8. Click Create to create a workflow.

As a result, in the Workflows executions tab, you can view the workflows that are being executed.

Run Workflows​

Note: If the Allow user to change the execution folder checkbox is not selected, then the workflow will start to run in the default execution folder. If the Allow user to change the execution folder checkbox is selected, then you can perform step #2.

The existing workflows bundled with Release and the newly created workflows are available in the Workflow catalog page. To run your workflows, you must navigate to the Workflow catalog page. For more information, see Access Workflow Catalog.

  1. Identify the workflow required for your use-case and click Run workflow. The Choose folder dialog opens.
  2. In the Folder name drop-down list, select the folder where you want to run your workflow and click Run workflow.
  3. The workflow is presented in the form of a stepper view in the Workflow executions tab of the selected folder. Run Workflow

Note: Detailed information about executing these workflows in a step-by-step view is discussed in Setup Argo CD Application with Initial Deployment.

  1. Enter the required details when prompted. It takes you through multiple steps of application creation process.
  2. Click Finish when the steps are completed.

Switch Workflow Views​

You can now switch between the workflow designer view and the stepper view for the workflows. Click View Execution to go to the stepper view and click Show designer to go to the Workflow designer view, which is similar to the Release-flow editor view.

You can go to and fro between the Workflow templates and Workflow Executions pages using the View workflow and View executions links in the sidebar.

picture 1

Create Release Task in Workflows​

Workflows now support the Create Release task (since Release 25.3), enabling direct visibility into release execution and coordination of workflow and release activities.

You can use the Create Release task in workflow templates to create new releases as part of your workflow execution.

Key Features​

  • Releases appear in the workflow execution view with real-time status
  • Direct link to each release for quick access
  • Option to wait for the release to finish or continue without waiting

Success Scenario​

When the Create Release task executes successfully, the workflow execution view shows:

  1. A Green status indicator in the Progress panel

  2. A Direct link to the successfully created release (For example, "Release - Waits" in the following example)

  3. Clicking View Details shows system messages/logs for additional context

    Create Release Task Success

Failed/Failing Scenario​

note

This applies when Wait for release to finish setting is enabled in the Create Release task settings. For more information, see Create Release Task.

If a release fails or is in a failing state, the workflow execution view displays detailed status information:

  1. Status Link: Shows the status of the release (For example, "Failed: Release - Waits" in the following example)

  2. View Button: Opens the release in a new tab for direct access

  3. Clicking View Details shows system messages/logs for troubleshooting

    Create Release Task in a workflow with a Failed release

For troubleshooting:

  • Inspect system logs by clicking View Details and resolve the issue.
  • Open the failing/failed release in a new tab by clicking View.
  • The workflow will continue once you resolve the issues and once the release finishes successfully.

View Deployed Applications​

The created applications are listed in the Live Deployments dashboard.

For more information, see Live Deployments in Release.