HyperFleet API v0.2.0

HyperFleet API v0.2.0 Release includes significant enhancements to database connectivity, configuration management, and query capabilities.

Container Image

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

Deployment

Deploy via the hyperfleet-infra umbrella Helm chart.

Major Features

• Status Aggregation Logic (#91): Enhanced aggregation logic for cluster and node pool status conditions
• Version Subcommand (#84): Added CLI version subcommand for build information
• Connection Pooling with pgbouncer (#68, #69):
  • pgbouncer sidecar support in Helm chart
  • Connection retry logic for sidecar startup races
  • Request-level context timeout in transaction middleware
  • Health check ping timeout configuration
  • Connection pool timeout configuration
• Viper Configuration System (#75): Complete refactor to Viper-based configuration with streamlined config system
• Condition Subfield Queries (#72): Support for selective Sentinel polling via condition subfield filtering
• PostgreSQL Advisory Locks (#77): Migration coordination using advisory locks to prevent race conditions
• Enhanced SliceFilter (#78, #79): Slice field validation and star propagation support

Fixes

• Validate adapter status conditions in handler layer (#88)
• Address revive linter violations (#85)
• Reject not operator for condition queries (#80)
• Align health ping timeout with K8s probe timeout (#68)
• Truncate migrations table in CleanDB for test reliability (#77)
• pgbouncer secret handling and connection leak fixes (#69)

Helm Chart Improvements

• Standardize appVersion and image.tag handling (#90)
• Restructure Helm Chart to follow standard conventions (#75)
• Align chart with Helm conventions standard (#87)
• Remove org prefix from image.repository default (#86)
• Use CHANGE_ME placeholder for image registry (#83)
• Use 0.0.0-dev version for dev image builds (#77)

Documentation

• API operator guide (#76)
• Search and filtering documentation (#63)
• Connection pool and pgbouncer documentation (#69)
• Complete configuration example (#75)
• Agent-native repo optimization with nested CLAUDE.md files (#89)

Testing

• Expanded test coverage for errors package (#93)
• DatabaseConfig test coverage and advisory lock tests (#77)
• Integration tests for advisory locks

Breaking Changes

• Configuration system migrated to Viper (requires config file updates)
• Removed legacy _FILE suffix environment variable support

v0.1.1

HyperFleet API v0.1.1

Patch release of the HyperFleet API — the REST API providing CRUD operations for cluster lifecycle management resources and adapter status reporting.

Container Image

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

Deployment

Deploy via the hyperfleet-chart umbrella Helm chart.

---

Highlights

API Validation & Correctness

• Reject missing spec field — Cluster creation requests without a spec field are now properly rejected with a clear error response (HYPERFLEET-649)
• Enforce mandatory adapter conditions — Adapter status reports are now validated to ensure all required conditions are present before persisting (HYPERFLEET-657)

Observability

• Standardized API metrics — Renamed Prometheus metrics to use the hyperfleet_api_ prefix for consistent naming across HyperFleet components (HYPERFLEET-457)
• Database metrics — Added Prometheus metrics with hyperfleet_db_ prefix to the database layer for connection pool and query observability (HYPERFLEET-470)

Helm & Deployment

• Helm chart testing — Added Helm chart linting, template validation, and fixed default image registry configuration (HYPERFLEET-658)

Testing

• Presenter test suite — Added comprehensive test coverage for the presenter package (HYPERFLEET-301)

Build & Infrastructure

• Standardized Dockerfile and Makefile — Unified image build process across HyperFleet repositories (HYPERFLEET-509)
• Config file resolution fix — Fixed config file path resolution broken by the -trimpath build flag (HYPERFLEET-710)
• VERSION collision fix — Resolved environment variable collision 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 API v0.1.0

First release of the HyperFleet cluster lifecycle management REST API.

Components

• REST API for cluster and nodepool lifecycle management
• PostgreSQL database for state persistence
• Adapter registration and event routing

Container Image

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

Deployment

Deploy via the hyperfleet-chart umbrella Helm chart.