Logic Operator v2.0

Logic Operator is a Kubernetes operator for Quarkus Flow. It lets you manage workflow runtimes, definitions, and traffic routing as native Kubernetes resources using the Open Workflow Specification 1.0.0.

What it does

Logic Operator introduces three custom resources:

CRD Purpose

LogicFlowRuntime

Manages a Quarkus Flow Runner deployment — pods, service, ConfigMap, leases, HPA, and RBAC.

LogicFlowDefinition

Immutable workflow version snapshot. Mounted automatically into the runner’s ConfigMap.

LogicFlowService

Groups workflow versions under a single HTTP endpoint. Manages Ingress routing.

Highlights

  • Hot-reload — workflow definition updates propagate automatically via ConfigMap directory mounts; no pod restarts needed.

  • Durable workflows — Kubernetes Leases provide stable pod identity across restarts and scaling events.

  • Autoscaling — HPA support out of the box.

  • Observability — Micrometer metrics exposed at /q/metrics; sample Prometheus + Grafana dashboards included.

  • Security — NONE, API_KEY, and OIDC authentication modes.

Get started

Getting Started walks you through deploying the operator on a local KIND cluster and running your first workflow in under 10 minutes.