Skip to main content
Version: 0.3

Konstruct 0.3.4

Released: February 26, 2026

Highlights​

  • Operator Stability — Rate limiting eliminated, Prometheus metrics added, reconciliation hardened
  • Cluster Management — Workload cluster directory cleanup, provisioning scoped to IaC and bootstrap apps
  • Platform UX — License key activation, self-hosted mode, app repository view/edit, UI polish
  • Deployment Reliability — ArgoCD sync fixes, RBAC improvements, production promotion hardening
  • GitHub App Foundation — Groundwork for GitHub App auth across operators (delivered fully in 0.3.6)

GitHub App Authentication (Foundation)​

This release includes foundation work for GitHub App authentication across Konstruct operators. Full GitHub App support — including the UI onboarding flow and migration tooling — ships in 0.3.6.

  • GitAccount operator supports storing GitHub App credentials (App ID, installation ID, private key) in Vault
  • All operators can read auth credentials from a platform git config instead of per-user PATs
  • Konstruct API adds initial GitHub App auth endpoints
note

Existing PAT-based configurations continue to work. A guided migration path from PATs to GitHub App auth is available in 0.3.6.

Operator Stability and Observability​

Rate Limiting Eliminated​

All operators now use CloneOrOpen helpers and condition guards to avoid redundant GitHub API calls. This eliminates rate limiting issues in environments with many repositories.

Prometheus Metrics​

GitHub operations across all operators now expose Prometheus metrics:

  • github_api_requests_total — Total API calls by operator and method
  • github_api_errors_total — Failed API calls
  • github_clone_duration_seconds — Repository clone/open latency

Reconciliation Fixes​

  • Environment reconciliation uses single-pass, generation-aware logic to prevent duplicate processing
  • CatalogDeployment supports public repositories and fixes status race conditions
  • CRD field sync ensures repoClonedPath propagates correctly across Helm chart values

Cluster Management​

Workload Cluster Directory Cleanup​

The workloadcluster-operator now cleans up GitOps repository directories when a workload cluster is deleted. Previously, stale cluster directories remained in the GitOps repo after cluster deletion.

Provisioning Scoped to IaC and Bootstrap Apps​

Cluster provisioning status now considers only infrastructure-as-code (Terraform) and bootstrap application readiness. Platform apps managed by ArgoCD are excluded from provisioning detail, providing a more accurate view of cluster readiness.

Workload Cluster Infrastructure​

  • Distroless debug image for secure kubectl exec operations
  • Platform GitOps repository references used during workload cluster provisioning

Platform UX Improvements​

License Key Activation​

Konstruct now supports license key activation with an activation flow, error handling, and license status visible in the UI.

Self-Hosted Configuration​

A new selfHosted configuration flag controls sidebar and layout behavior for self-hosted deployments.

App Repositories​

View and edit app repository details directly in the UI without leaving the Konstruct dashboard.

UI Polish​

  • Environment table loading states
  • Standardized date formatting across all views
  • GitOps catalog icon refresh
  • Shared DeleteDialog and BulkDeleteDialog components

Deployment Reliability​

ArgoCD Sync Fixes​

Removed ServerSideApply from ArgoCD configuration to fix PipelineTemplate sync loops.

RBAC Improvements​

Namespace-scoped ClusterRole and ClusterRoleBinding resources now use consistent naming conventions to prevent conflicts across environments.

Documentation and Brand Alignment​

  • Domain migrated from civonetes.com to konstruct.civo.com
  • Clean URL serving with Nginx and trailing slash redirects
  • SEO hardening with canonical tags and version indexing
  • Typesense search integration
  • Civo brand alignment (colors, typography, logos)

Upgrade​

Update targetRevision to 0.3.4 in your Konstruct ArgoCD Application manifest:

spec:
  source:
    chart: konstruct
    repoURL: oci://europe-west2-docker.pkg.dev/civo-com/charts
    targetRevision: 0.3.4

Commit and push — ArgoCD syncs the new version automatically.

This release includes 46 merge requests across 8 repositories including konstruct-api, konstruct-ui, application-operator, gitaccount-operator, team-management-operator, workloadcluster-operator, charts, and konstruct-docs.