provider-runtime

module
v1.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 28, 2026 License: Apache-2.0

README

provider-runtime

The Go library every Krateo provider controller is built on: a managed-resource reconciliation runtime over controller-runtime.

Test and coverage

What is this

provider-runtime supplies the generic reconcile loop for managed resources — Observe → Create/Update/Delete against an external system — plus the shared condition model (Ready/Synced), the krateo.io/* annotation vocabulary (external-name, pause, management/deletion policy), OTel-model logging, OTLP metrics, and rate-limiting/workqueue utilities. Providers implement an ExternalClient; the library drives everything else. Consumed as a plain Go module — no image, no chart, no CRDs shipped. Full picture: docs/index.md.

Install

go get github.com/krateo-platformops/provider-runtime@v1.3.0

Configure

See docs/configuration.md. Most used:

Setting Default Effect
reconciler.WithPollInterval 1m Speculative re-observe interval per managed resource
controller.Options.MaxConcurrentReconciles 1 Per-controller worker count
telemetry.Config.Enabled false OTLP metrics pipeline (provider_runtime.* instruments)

Examples

Docs

Develop & release

make test (unit tests, no cluster needed) · make generate (deepcopy) · make lint — release runbook: docs/release.md.

Directories

Path Synopsis
apis
common/v1
Package v1 contains core API types.
Package v1 contains core API types.
examples
greeting-controller command
Command greeting-controller is a minimal, compilable managed-resource controller built on provider-runtime.
Command greeting-controller is a minimal, compilable managed-resource controller built on provider-runtime.
pkg
errors
Package errors is a github.com/pkg/errors compatible API for native errors.
Package errors is a github.com/pkg/errors compatible API for native errors.
logging
OpenTelemetry-aligned logging for provider-runtime consumers.
OpenTelemetry-aligned logging for provider-runtime consumers.
meta
Package meta contains functions for dealing with Kubernetes object metadata.
Package meta contains functions for dealing with Kubernetes object metadata.
ratelimiter
Package ratelimiter contains suggested default ratelimiters for providers.
Package ratelimiter contains suggested default ratelimiters for providers.
resource/fake
Package fake provides fake Crossplane resources for use in tests.
Package fake provides fake Crossplane resources for use in tests.

Jump to

Keyboard shortcuts

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