HyperFleet Adapter v0.2.0

HyperFleet Adapter Release v0.2.0 includes significant enhancements to configuration management, observability, precondition capabilities, and codebase quality improvements.

Container Image

quay.io/openshift-hyperfleet/hyperfleet-adapter:v0.2.0

Deployment

Deploy via the hyperfleet-infra umbrella Helm chart.

Major Features

• Time-Based Preconditions (#77): Added `now()` custom CEL function for time-based stability preconditions
• Prometheus Integration (#75): Added ServiceMonitor and Service resources for Prometheus discovery and metrics collection
• Configuration Standard (#67): Implemented architecture-aligned configuration system with Viper support

Fixes

• Consolidate duplicate resource operation logs (#84)
• Fix time value inconsistency in documentation (#81)
• Enable revive linter and resolve lint violations (#80)
• Align golangci.yml with architecture standard v2 and resolve all lint violations (#83)
• Set failure status on nested discovery key collision
• Preserve failed executionStatus on precondition error

Helm Chart Improvements

• Standardize appVersion and image.tag handling (#86)
• Align chart with Helm conventions standard (#85)
• Use 0.0.0-dev version for dev image builds (#74)
• Skip version validation for 0.0.0-dev dev builds (#73)

Documentation

• Create reliability documentation with runbook and metrics (#68)
• Align adapter docs with operational docs standard (#76)
• Document required hyperfleet.io/generation annotation (#79)
• Add time-based stability preconditions usage examples

Chores

• Remove unused GIT_TAG variable and Tag field (#82)

v0.1.1

HyperFleet Adapter v0.1.1

Patch release of the HyperFleet Adapter Framework — the event-driven service framework that consumes reconciliation events, evaluates preconditions, manages Kubernetes resources, and reports status back to the HyperFleet API.

Container Image

quay.io/openshift-hyperfleet/hyperfleet-adapter:v0.1.1

Deployment

Deploy via the hyperfleet-chart umbrella Helm chart.

---

Highlights

Bug Fixes

• Generation variable rename — Fixed incorrect generation variable naming in task execution context (HYPERFLEET-653)
• Owner references field name — Corrected owned_reference to owner_references for proper Kubernetes resource ownership tracking (HYPERFLEET-663)
• Maestro SQL error leak — Prevented internal SQL error details from leaking through the Maestro transport layer (HYPERFLEET-661)
• RabbitMQ exchange type — Fixed incorrect exchange type configuration for RabbitMQ broker integration (HYPERFLEET-672)
• Helm volume projection warning — Resolved duplicated volume projection entries in Helm chart templates (HYPERFLEET-662)

Observability & Reliability

• Event processing metrics — Added Prometheus metrics for adapter event processing, enabling monitoring of event consumption rates, processing duration, and error counts (HYPERFLEET-450)
• Broker metrics integration — Updated hyperfleet-broker to v1.1.0 with integrated metrics recording (HYPERFLEET-676)
• PodDisruptionBudget — Enabled PDB by default in Helm chart to protect adapter availability during voluntary disruptions (HYPERFLEET-584)
• Enhanced task execution logging — Added detailed logging for adapter framework task execution to improve debugging

Documentation & Examples

• Discovery byName example — Fixed incorrect example for resource discovery using the byName strategy (HYPERFLEET-660)
• Namespace in discovery examples — Corrected namespace usage in resource discovery documentation (HYPERFLEET-679)
• Unknown condition value — Documented the Unknown condition status value for adapter status reporting (HYPERFLEET-596)

Testing

• Maestro TLS integration test — Added integration test validating TLS-authenticated Maestro client setup

Build & Infrastructure

• Standardized Dockerfile and Makefile — Unified image build process across HyperFleet repositories (HYPERFLEET-509)
• VERSION collision fix — Standardized version handling to avoid collisions with go-toolset base image (HYPERFLEET-723)
• CA certificates fix — Copied CA certificates from builder stage to ubi9-micro runtime, resolving TLS verification failures in minimal container images (HYPERFLEET-730)

---

Full Changelog: v0.1.0...v0.1.1

v0.1.0

HyperFleet Adapter v0.1.0

First release of the HyperFleet adapter framework.

Components

• Adapter runtime for processing cluster lifecycle events
• Plugin system for landing-zone and validation adapters
• Message broker subscriber (RabbitMQ, Google Pub/Sub)

Container Image

quay.io/openshift-hyperfleet/hyperfleet-adapter:v0.1.0

Deployment

Deploy via the hyperfleet-chart umbrella Helm chart.