Skip to content

Flux ​

v8s has built-in views for Flux, so you do not have to read raw .status.conditions to know whether GitOps is healthy. The Flux section appears in the sidebar when a selected cluster has Flux installed (v8s detects the *.toolkit.fluxcd.io APIs on connect, and re-checks every five minutes or when a CRD changes).

Supported kinds ​

API groupKinds
source.toolkit.fluxcd.ioGitRepository, OCIRepository, HelmRepository, HelmChart, Bucket, ExternalArtifact
kustomize.toolkit.fluxcd.ioKustomization
helm.toolkit.fluxcd.ioHelmRelease
notification.toolkit.fluxcd.ioProvider, Alert, Receiver
image.toolkit.fluxcd.ioImageRepository, ImagePolicy, ImageUpdateAutomation

v8s reads whichever API version your cluster serves, so it works across Flux upgrades. Flux Operator kinds (FluxInstance, ResourceSet) show up as generic custom resources.

Overview ​

The Flux overview spans every selected cluster:

  • Readiness by kind: total, ready, not ready, reconciling or unknown, and suspended, with the failing objects listed first.
  • The health of Flux's own controllers (the Deployments in flux-system).
  • Objects that have not reconciled in three times their interval.

Flux objects are few and small, so v8s keeps them live as part of the Problems baseline. The overview is instant.

Tables ​

Each Flux kind has its own columns:

ColumnMeaning
ReadyThe Ready condition with its reason, for example False · ArtifactFailed
SuspendedWhether spec.suspend is set
RevisionShort commit SHA or chart version
SourceThe sourceRef
Intervalspec.interval
Last reconcileHow long ago it last reconciled
MessageTruncated here; the full message is in the tooltip

Actions ​

Select one or more objects, in one cluster or several, and use the action bar.

ActionWhat it does
Suspend / ResumeSets spec.suspend
ReconcileRequests a reconcile by setting reconcile.fluxcd.io/requestedAt
Reconcile with sourceReconciles the referenced source first, waits for it to finish, then reconciles the object
Force reconcile (HelmRelease)Forces a fresh install or upgrade run
Reset failures (HelmRelease)Clears the failure counters so remediation starts over

Reconcile feedback ​

After you request a reconcile, the row shows Reconciling… until Flux reports it handled your request, then it resolves to the new Ready state. You get honest feedback without v8s polling the cluster.

Kustomization detail ​

  • Inventory (a tab on the Kustomization). The objects it manages, each joined to the live object and its health. "This Kustomization is Ready but two of its Deployments are crash looping" is visible at a glance.
  • Dependency graph (Flux, Dependency graph in the sidebar). The dependsOn graph across sources, Kustomizations, and HelmReleases. If a chain is blocked, the root cause is the one marked.
  • Events for the object.

Inventories can hold thousands of entries. v8s keeps them compact and joins them to live objects only when you open the detail.

HelmRelease detail ​

A HelmRelease and the Helm release underneath it are the same thing seen from two sides, so the detail shows both: Flux status, remediation counters (installFailures, upgradeFailures), and the Helm release history, values, and manifest diff between revisions. See Helm.

Sources ​

A source's detail shows its status, artifact revision, and conditions on the Overview tab. The sourceRef of each Kustomization and HelmRelease is a column in their tables, so you can sort and filter to find what uses a source.

Editing Flux-managed objects ​

If you edit an object that Flux manages, the review step shows a banner naming the Kustomization or HelmRelease, and the object's Overview tab offers Open source. Flux will revert a direct change at the next reconcile, so the change usually belongs in Git, or you can suspend the owner first. See Viewing and changing resources.

Problems from Flux ​

ClassMeaning
flux.not-readyReady=False
flux.stalledStalled=True
flux.staleNo successful reconcile in three intervals
flux.source-failedA source could not fetch
flux.controller-downA Flux controller is not running
flux.dependency-blockedBlocked by a dependency, collapsed to the root cause
flux.suspendedSuspended (info, off by default)

See Problems for the full list.

Released under the MIT License.