Orkes Conductor VS Code Extension
This extension is used to interact with Orkes Conductor from VS Code.
Features
The main navigation is through the Tree View on the left.
In the Tree View, you can see the Clusters, the Workflow Definitions, the Tasks Definitions, the Executions, the Schedules.
These are the main items in the Tree View:
Clusters Menu:
- Add / Remove / Edit Clusters
Workflows
- Push a workflow definition to cluster.
- Download all Workflow Definitions.
- List the Workflow Definitions in the cluster.
Executions
- Run a workflow
- Terminate / Pause / Restart with current / Restart with latest
Tasks
- Download task definitions.
- Push a task definition to a cluster.
Schemas
- Download schema definitions.
- Push a schema definition to a cluster.
User Forms
- Download user form definitions.
- Push a user form definition to a cluster.
Schedules
Workflow Visualizer
- Renders the workflow's JSON.
- Highlights the clicked task in the code editor.
- Code Snippets for all SDKs.
- JSON Validation for Workflow Schemas.
- Compatible with both OSS and Orkes clusters.
Usage
Specifying a folder or repo
Opening a folder or repo is required to push workflows and tasks to the cluster,
and to download the workflow definitions from the cluster.
The workflow definitions are saved in the folder you open, under the folder:
clusters/<cluster-name>/workflows
The task definitions are saved in the folder you open, under the folder:
clusters/<cluster-name>/tasks
Adding a new Cluster
You'll need to get a KeyId and KeySecret from your Conductor cluster.
- Go to your Conductor UI.
- Click on the "Applications" sidebar item.
- Create a new Application.
- Copy the KeyId and KeySecret.
- Paste them into the "KeyId" and "KeySecret" fields in the Cluster settings.
Uploading a Workflow to your cluster
Filename conventions
The files are stored in a folder based on your cluster name under the /clusters
dir of your workspace.
For example:
/clusters/myCluster/workflows
The filename follows this convention:
sendEmails.v1.workflow.json
Why .workflow.json
?
This provides features as Schema validation for your workflow files.
Why .v1, .v2, etc.
?
Conductor provides support for running multiple workflow versions, in parallel, which can be entirely different from each other.
You can keep different versions of your workflows, even schedule different versions as cron jobs.
How to upload a Workflow to your Cluster
- Right-click on a workflow in your filesystem.
- Click on the "Push to Cluster" option.
The workflow will be saved to your cluster.
Uploading a Task to your cluster
- Right-click on a task in the tree view.
- Click on the "Push to Cluster" option.
The task will be saved to your cluster.
Choosing a folder for the Workflow files.
- Open the command palette (Ctrl+Shift+P).
- Type "Orkes" to see the available settings.
- Select a workflowFolder where the workflow files will be saved.
The folder is relative to the workspace root.
You can also use an absolute path.