temporal-operator

module

v0.1.0 Latest Latest Go to latest Published: Jun 14, 2026 License: Apache-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/bmorton/temporal-operator

Links

Open Source Insights

README ¶

temporal-operator

A modern Kubernetes operator for Temporal, written in Go with the Operator SDK / Kubebuilder. It manages the full lifecycle of Temporal clusters — persistence, schema management, mTLS, rollouts, and version upgrades — through declarative custom resources.

Status: early development. APIs are v1alpha1 and subject to change.

Custom Resources

Kind	Short	Purpose
`TemporalCluster`	`tc`	A complete Temporal server deployment.
`TemporalNamespace`	`tns`	A namespace within a managed cluster.
`TemporalSearchAttribute`	`tsa`	A custom search attribute registration.
`TemporalClusterClient`	`tcc`	Generated client credentials for a cluster.

Documentation

See the documentation site (coming soon). Until then, the examples/ directory contains sample custom resources.

Contributing

See CONTRIBUTING.md. This project follows the Contributor Covenant code of conduct, requires Conventional Commits, and uses the Developer Certificate of Origin (DCO).

License

Licensed under the Apache License 2.0.

Directories ¶

Path	Synopsis
api
v1alpha1 Conversion / hub-and-spoke notes:	Conversion / hub-and-spoke notes:
cmd
internal
controller
persistence Package persistence contains helpers for resolving Temporal persistence configuration, including datastore credentials sourced from Secrets.	Package persistence contains helpers for resolving Temporal persistence configuration, including datastore credentials sourced from Secrets.
resources Package resources contains builders for the Kubernetes objects the operator manages (Jobs, Deployments, Services, ConfigMaps, etc.).	Package resources contains builders for the Kubernetes objects the operator manages (Jobs, Deployments, Services, ConfigMaps, etc.).
temporal Package temporal contains Temporal-version-aware helpers: the supported version compatibility matrix and the server config-template renderer.	Package temporal contains Temporal-version-aware helpers: the supported version compatibility matrix and the server config-template renderer.
webhook/v1alpha1
test
utils

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL