Kestra extension for VSCode

Features

• Flow autocompletion & validation on .yaml / .yml files by downloading the JSON schema.
• Dynamic documentation depending on tasks your flow includes.

Requirements

• Redhat's YAML extension

Usage

Kestra Schema - Enabling autocompletion

After installing the extension, you will get a new command called "Download Kestra schema". You can use this command to download the schema that will enable autocompletion in YAML files.

To avoid having the schema apply on every YAML file, you can set up the mapping in your settings file.

Using the extension on the Kestra VSCode Kestra will automatically download the Schema.

Kestra Documentation - enabling live documentation

Kestra VSCode extension embeds the documentation. When on a YAML file, a new action called Open Kestra Documentation will appear and will open a new Webview. This webview contains the default properties of a flow and its tasks, but clicking on a specific task in your code will show its documentation.

Configure

When using the extension on your local instance of VSCode, you will be prompted to enter a URL. The default URL is the Kestra API that includes all plugins, but if you want to only display available plugins in your instance, use your Kestra Instance URL

If you have a JWT-based authentication (EE), please copy your token from the "Copy JWT token" button available in the same menu as the Logout button on the UI.

Development

You can use the following alias to quickly install your extension to local Kestra instance for web extension testing:

alias extension="OLD_PWD=$(pwd) && \
    npm run package-web && \
    cp dist/web/extension.js {pathToKestraRoot}/ui/public/vscode/extensions/kestra/extension/dist/web/ && \
    cp package.json {pathToKestraRoot}/ui/public/vscode/extensions/kestra/extension/ && \
    cd {pathToKestraRoot} && \
    rm -rf webserver/src/main/resources/ui && \
    ./gradlew assembleFrontend && \
    cd $OLD_PWD"

Package for local VSIX installation

npm run vsix will create a VSIX of your extension which you can use for local extension installation.

Publish

Simply tag your commit with v{major}.{minor}.{patch} and it will trigger a GHA to do it.

Configuration

The library allows two possible configurations:

• kestra.api.url: The URL of your Kestra instance
• kestra.schema.match-path: The path to files for which the Kestra API schema should be applied; this allows the extension to validate only YAML files from a specific folder desginated for kestra. For example, adding the following configuration to your settings.json will ensure that only files from the _flows directory will be validated as kestra flows:

"kestra.schema.match-path": "_flow"