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 four custom resources:

CRD Purpose

LogicPlatform

Manages Data Index (GraphQL query service) and Vector (log collection) for workflow data integration.

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.

  • Workflow data integration — Vector collects structured logs; Data Index provides GraphQL API to query workflow instance history.

  • 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.