Configuring Workflow Services

This document describes how to configure a workflow service with the Kogito Serverless Workflow Operator.

This feature is supported only for development profile. Configuring workflows not in development is mapped and tracked by KOGITO-8522. See Kogito Serverless Workflow Operator Known Issues, Limitations and Roadmap

Editing the Workflow Configuration

When the operator deploys the workflow service, it also creates a ConfigMap named after the KogitoServerlessWorkflow object with the suffix -props. For example, if your workflow name is greeting, then the ConfigMap name is greeting-props.

You can use the Kubernetes object editor of your preference to add or edit the properties in the workflow configuration. Using kubectl you can do:

Editing the Workflow Properties

kubectl edit cm <workflow-name>-props

Note that it’s important to respect the properties format, otherwise the operator will replace your configuration with the default one.

Here’s an example of a workflow properties:

Example of a Workflow ConfigMap Properties

apiVersion: v1
kind: ConfigMap
metadata:
  labels:
    app: greeting
  name: greeting-props
  namespace: default
data:
  application.properties: |
    my.properties.key = any-value

The underlying runtime engine that executes the workflow service is based on Quarkus. So that, you can configure the workflow as you normally would any Quarkus application.

Any Kogito Serverless Workflow configuration that the documentation describes or general Quarkus application property can be configured using this method.

Immutable properties

A few properties can not be changed in this configuration. Usually, they are already defined in the properties file. The table below lists them.

Table 1. List of immutable properties
Property Key	Immutable Value	Profile
quarkus.http.port	8080	all
quarkus.http.host	0.0.0.0	all
org.kie.kogito.addons.knative.health-enabled	false	dev

If you try to change any of them, the operator will override them with the default, but preserving your changes in other property keys.

Additional resources

Found an issue?

If you find an issue or any misleading information, please feel free to report it here. We really appreciate it!