Workflows as code

With Workflows as code, you can treat your Workflows like other production assets; this feature allows you to manage Workflows through GitOps. Each Workflow has its own YAML file.

When GitOps is enabled, changes made to Workflows will appear in GitOps logs.

Managing Workflows in both GitOps and the Cortex UI

When you disable the Workflow UI editor, it only affects Workflows that are created via GitOps. You will still be able to edit Workflows via the Cortex UI if they were not created or edited through GitOps.

View GitOps-managed Workflows in Cortex

In the Cortex UI, you will see a Git badge appear next to any Workflows that are GitOps-managed:

You can view the Workflow in the Cortex UI, but you cannot edit in the UI. The Cortex UI will display a link to Workflow's YAML file in your repository:

Edit GitOps-managed Workflows in Cortex

You cannot edit a GitOps-managed Workflow in the Cortex UI, but you can duplicate the Workflow and make edits to the duplicate copy.

To duplicate a Workflow:

1. In the Workflows list, click the 3 dots icon in the row containing the Workflow.

2. Click Duplicate workflow.

   

Create a Workflow via GitOps

Step 1: Configure GitOps editing for Workflows

1. Navigate to Settings > GitOps then click the Workflows tab.

   
2. Toggle off the setting Enable Workflow UI editor.

3. Optionally, under "Workflow GitOps repository allowlist," you can specify which repositories to import Workflows from.

Step 2: Create a YAML file for the Workflow

Workflow YAML files must be in their own repository, separate from catalog entities, at the repository's root directly within .cortex/workflows.

The Workflow YAML uses the same data structure as Cortex's Workflow API.

You can create a Workflow configuration from scratch, or you can start in the Cortex UI and export the Workflow to a YAML file:

1. Create a Workflow in Cortex.
2. At the top of the Workflow, click the 3 dots menu, then click Export Workflow YAML.

   
3. Add the YAML file to your Git repository within .cortex/workflows.

See an example YAML file below.

Example Workflow YAML

name: New Workflow
tag: new-workflow
description: null
isDraft: true
filter:
  type: GLOBAL
runResponseTemplate: null
actions:
- name: List branches
  slug: list-branches
  schema:
    inputs:
      repo: myorg/backend-app
      per_page: 30
      protected: false
    integrationAlias: cortex
    actionIdentifier: github.listBranches
    type: ADVANCED_HTTP_REQUEST
  outgoingActions:
  - javascript
  isRootAction: true
- name: JavaScript
  slug: javascript
  schema:
    script: |-
      return fetch('https://api.ipify.org?format=json')
        .then(response => {
          return response.json();
        })
        .then(data => {
          return(data);
        });
    type: JAVASCRIPT
  outgoingActions:
  - http-request
  isRootAction: false
- name: HTTP request
  slug: http-request
  schema:
    headers:
      Content-Type: application/json
    httpMethod: POST
    payload: "{\"content\": {{{actions.javascript.outputs.return}}}}"
    url: https://echo.free.beeceptor.com
    type: HTTP_REQUEST
  outgoingActions: []
  isRootAction: false
runRestrictionPolicies: []
iconTag: null