CRD resource categories
How to list and discover Flux resources using kubectl CRD categories.
Starting with Flux 2.9, all Flux Custom Resource Definitions (CRDs)
include
Kubernetes resource categories
that allow you to use kubectl get with category selectors to list Flux resources
across multiple CRD types in a single command.
Categories
Every Flux CRD is assigned exactly three categories:
| Category | Scope | Description |
|---|---|---|
all | Cluster-wide | Includes Flux resources in kubectl get all output |
fluxcd | All Flux CRDs | Lists every Flux custom resource |
| Resource-specific | Per resource | Lists resources matching a specific Flux CRD category |
The resource-specific categories are:
| Category | Controllers | CRDs |
|---|---|---|
fluxcd-sources | source-controller, source-watcher, flux-operator | GitRepository, OCIRepository, HelmRepository, HelmChart, Bucket, ExternalArtifact, ArtifactGenerator, ResourceSetInputProvider |
fluxcd-appliers | kustomize-controller, helm-controller, flux-operator | Kustomization, HelmRelease, ResourceSet, FluxInstance |
fluxcd-notifications | notification-controller | Alert, Provider, Receiver |
fluxcd-images | image-reflector-controller, image-automation-controller | ImageRepository, ImagePolicy, ImageUpdateAutomation |
Flux CLI Comparison
flux get all
NAME REVISION SUSPENDED READY MESSAGE
ocirepository/flux-operator 0.52.0@sha256:e25cf78b False True stored artifact for digest '0.52.0@sha256:e25cf78b'
ocirepository/flux-system latest@sha256:f94b6833 False True stored artifact for digest 'latest@sha256:f94b6833'
NAME REVISION SUSPENDED READY MESSAGE
gitrepository/flux-operator main@sha1:32cc2167 False True stored artifact for revision 'main@sha1:32cc2167'
NAME REVISION SUSPENDED READY MESSAGE
helmrelease/flux-operator 0.52.0+e25cf78b888f False True Helm upgrade succeeded for release flux-system/flux-operator.v75 with chart flux-operator@0.52.0+e25cf78b888f
helmrelease/flux-status-server 0.52.0+e25cf78b888f False True Helm upgrade succeeded for release flux-system/flux-status-server.v217 with chart flux-operator@0.52.0+e25cf78b888f
NAME REVISION SUSPENDED READY MESSAGE
kustomization/eks-addons latest@sha256:f94b6833 False True Applied revision: latest@sha256:f94b6833
kustomization/flux-system latest@sha256:f94b6833 True True Applied revision: latest@sha256:f94b6833
kustomization/policies latest@sha256:f94b6833 False True Applied revision: latest@sha256:f94b6833
kustomization/preview latest@sha256:f94b6833 False True Applied revision: latest@sha256:f94b6833
kustomization/tenants latest@sha256:f94b6833 False True Applied revision: latest@sha256:f94b6833
NAME SUSPENDED READY MESSAGE
receiver/flux-webhook-receiver False True Receiver initialized for path: /hook/69e8f574d0c34d33ebe39a64ef882ac270c1e122383722aac8a36ef139ed42ac
NAME READY MESSAGE
provider/grafana True Provider is Ready
NAME SUSPENDED READY MESSAGE
alert/grafana False True Alert is Ready
kubectl get fluxcd
NAME AGE READY STATUS REVISION
fluxinstance.fluxcd.controlplane.io/flux 273d True Reconciliation finished in 14s v2.8.8@sha256:0364968cd7f733e2d87d2237845812cd1f373342db3b573e19fd2cd977ee85d5
NAME AGE READY STATUS LASTUPDATED
fluxreport.fluxcd.controlplane.io/flux 338d True Reporting finished in 165ms 2026-06-27T13:16:29Z
NAME AGE READY STATUS
resourcesetinputprovider.fluxcd.controlplane.io/apps-preview-main 317d True Reconciliation finished in 516ms
resourcesetinputprovider.fluxcd.controlplane.io/apps-preview-prs 317d True Reconciliation finished in 406ms
resourcesetinputprovider.fluxcd.controlplane.io/flux-status-server 232d True Reconciliation finished in 568ms
NAME AGE READY STATUS
resourceset.fluxcd.controlplane.io/apps 338d True Reconciliation finished in 332ms
resourceset.fluxcd.controlplane.io/apps-preview-main 317d True Reconciliation finished in 188ms
resourceset.fluxcd.controlplane.io/apps-preview-prs 317d True Reconciliation finished in 20ms
resourceset.fluxcd.controlplane.io/eks-storage-classes 84d True Reconciliation finished in 53ms
resourceset.fluxcd.controlplane.io/flux-addons 337d True Reconciliation finished in 133ms
resourceset.fluxcd.controlplane.io/flux-operator 338d True Reconciliation finished in 61ms
resourceset.fluxcd.controlplane.io/flux-status-server 190d True Reconciliation finished in 54ms
resourceset.fluxcd.controlplane.io/flux-tests 9d True Reconciliation finished in 43ms
resourceset.fluxcd.controlplane.io/infra 338d True Reconciliation finished in 574ms
resourceset.fluxcd.controlplane.io/sso-rbac 156d True Reconciliation finished in 62ms
NAME AGE READY STATUS
helmrelease.helm.toolkit.fluxcd.io/flux-operator 273d True Helm upgrade succeeded for release flux-system/flux-operator.v75 with chart flux-operator@0.52.0+e25cf78b888f
helmrelease.helm.toolkit.fluxcd.io/flux-status-server 190d True Helm upgrade succeeded for release flux-system/flux-status-server.v217 with chart flux-operator@0.52.0+e25cf78b888f
NAME AGE READY STATUS
kustomization.kustomize.toolkit.fluxcd.io/eks-addons 84d True Applied revision: latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e
kustomization.kustomize.toolkit.fluxcd.io/flux-system 273d True Applied revision: latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e
kustomization.kustomize.toolkit.fluxcd.io/policies 84d True Applied revision: latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e
kustomization.kustomize.toolkit.fluxcd.io/preview 273d True Applied revision: latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e
kustomization.kustomize.toolkit.fluxcd.io/tenants 273d True Applied revision: latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e
NAME AGE READY STATUS
receiver.notification.toolkit.fluxcd.io/flux-webhook-receiver 273d True Receiver initialized for path: /hook/69e8f574d0c34d33ebe39a64ef882ac270c1e122383722aac8a36ef139ed42ac
NAME AGE
alert.notification.toolkit.fluxcd.io/grafana 273d
NAME AGE
provider.notification.toolkit.fluxcd.io/grafana 273d
NAME URL AGE READY STATUS
gitrepository.source.toolkit.fluxcd.io/flux-operator ssh://git@github.com/controlplaneio-fluxcd/flux-operator 9d True stored artifact for revision 'main@sha1:32cc21670b4089e30cac7b90d9b468354142cae4'
NAME URL READY STATUS AGE
ocirepository.source.toolkit.fluxcd.io/flux-operator oci://ghcr.io/controlplaneio-fluxcd/charts/flux-operator True stored artifact for digest '0.52.0@sha256:e25cf78b888fb82afadcb0c06bbb3dce8c5c5d0313e304ce67b6a7744977e458' 273d
ocirepository.source.toolkit.fluxcd.io/flux-system oci://123456789012.dkr.ecr.eu-west-2.amazonaws.com/d2-fleet True stored artifact for digest 'latest@sha256:f94b6833fca12be1f1ae24f7bef7445127b6ab36acaecae298bb3ac64c6e340e' 273d
Last modified 2026-06-27: Add category comparison with the Flux CLI (804fb7d1)