Before: ``` $ flux -n default trace pod default-podinfo-585856f49c-4jl4m panic: runtime error: invalid memory address or nil pointer dereference [signal SIGSEGV: segmentation violation code=0x2 addr=0x40 pc=0x10618da70] goroutine 1 [running]: main.traceHelm({0x106dd7b28, 0x14000201490}, {0x12f34c0d8, 0x14000783100}, {{0x1400071e130?, 0x1061e7795?}, {0x1400071e109?, 0x1000d9c84?}}, 0x140006a6030) /home/runner/work/flux2/flux2/cmd/flux/trace.go:404 +0x2f0 main.traceObject({0x106dd7b28, 0x14000201490}, {0x12f34c0d8, 0x14000783100}, 0x140006a6030) /home/runner/work/flux2/flux2/cmd/flux/trace.go:134 +0x11c main.traceObjects({0x106dd7b28, 0x14000201490}, {0x12f34c0d8, 0x14000783100}, {0x140006a6040, 0x1, 0x0?}) /home/runner/work/flux2/flux2/cmd/flux/trace.go:112 +0x74 main.traceCmdRun(0x14000592800?, {0x140003aea80, 0x2, 0x4}) /home/runner/work/flux2/flux2/cmd/flux/trace.go:107 +0x180 github.com/spf13/cobra.(*Command).execute(0x108341980, {0x140003aea40, 0x4, 0x4}) /home/runner/go/pkg/mod/github.com/spf13/cobra@v1.8.1/command.go:985 +0x834 github.com/spf13/cobra.(*Command).ExecuteC(0x108329280) /home/runner/go/pkg/mod/github.com/spf13/cobra@v1.8.1/command.go:1117 +0x344 github.com/spf13/cobra.(*Command).Execute(...) /home/runner/go/pkg/mod/github.com/spf13/cobra@v1.8.1/command.go:1041 main.main() /home/runner/work/flux2/flux2/cmd/flux/main.go:189 +0x78 ``` After: ``` $ ~/dev/flux/flux2/bin/flux -n default trace pod default-podinfo-585856f49c-4jl4m Object: Pod/default-podinfo-585856f49c-4jl4m Namespace: default Status: Managed by Flux --- HelmRelease: podinfo Namespace: flux-system Target: default Revision: 6.8.0+2360bdf32ddc Status: Last reconciled at 2025-05-14 16:10:37 +0200 CEST Message: Helm install succeeded for release default/default-podinfo.v1 with chart podinfo@6.8.0+2360bdf32ddc --- OCIRepository: podinfo Namespace: flux-system URL: oci://ghcr.io/stefanprodan/charts/podinfo Tag: 6.8.0 Revision: 6.8.0@sha256:2360bdf32ddc50c05f8e128118173343b0a012a338daf145b16e0da9c80081a4 Status: Last reconciled at 2025-05-14 16:09:17 +0200 CEST Message: stored artifact for digest '6.8.0@sha256:2360bdf32ddc50c05f8e128118173343b0a012a338daf145b16e0da9c80081a4' ``` Signed-off-by: Max Jonas Werner <max@coppersoft.com> |
3 months ago | |
---|---|---|
.github | 3 months ago | |
action | 2 years ago | |
cmd/flux | 3 months ago | |
docs | 9 months ago | |
install | 3 years ago | |
internal | 3 months ago | |
manifests | 3 months ago | |
pkg | 3 months ago | |
rfcs | 3 months ago | |
tests | 3 months ago | |
.gitignore | 4 years ago | |
.goreleaser.yml | 4 months ago | |
.scorecard.yml | 4 months ago | |
CODE_OF_CONDUCT.md | 5 years ago | |
CONTRIBUTING.md | 3 months ago | |
DCO | 5 years ago | |
Dockerfile | 3 months ago | |
LICENSE | 5 years ago | |
MAINTAINERS | 3 years ago | |
Makefile | 3 months ago | |
README.md | 1 year ago | |
go.mod | 3 months ago | |
go.sum | 3 months ago | |
netlify.toml | 4 years ago |
README.md
Flux version 2
Flux is a tool for keeping Kubernetes clusters in sync with sources of configuration (like Git repositories and OCI artifacts), and automating updates to configuration when there is new code to deploy.
Flux version 2 ("v2") is built from the ground up to use Kubernetes' API extension system, and to integrate with Prometheus and other core components of the Kubernetes ecosystem. In version 2, Flux supports multi-tenancy and support for syncing an arbitrary number of Git repositories, among other long-requested features.
Flux v2 is constructed with the GitOps Toolkit, a set of composable APIs and specialized tools for building Continuous Delivery on top of Kubernetes.
Flux is a Cloud Native Computing Foundation (CNCF) graduated project, used in production by various organisations and cloud providers.
Quickstart and documentation
To get started check out this guide on how to bootstrap Flux on Kubernetes and deploy a sample application in a GitOps manner.
For more comprehensive documentation, see the following guides:
- Ways of structuring your repositories
- Manage Helm Releases
- Automate image updates to Git
- Manage Kubernetes secrets with Flux and SOPS
If you need help, please refer to our Support page.
GitOps Toolkit
The GitOps Toolkit is the set of APIs and controllers that make up the runtime for Flux v2. The APIs comprise Kubernetes custom resources, which can be created and updated by a cluster user, or by other automation tooling.
You can use the toolkit to extend Flux, or to build your own systems for continuous delivery -- see the developer guides.
Components
- Source Controller
- Kustomize Controller
- Helm Controller
- Notification Controller
- Image Automation Controllers
Community
Need help or want to contribute? Please see the links below. The Flux project is always looking for new contributors and there are a multitude of ways to get involved.
- Getting Started?
- Look at our Get Started guide and give us feedback
- Need help?
- First: Ask questions on our GH Discussions page.
- Second: Talk to us in the #flux channel on CNCF Slack.
- Please follow our Support Guidelines (in short: be nice, be respectful of volunteers' time, understand that maintainers and contributors cannot respond to all DMs, and keep discussions in the public #flux channel as much as possible).
- Have feature proposals or want to contribute?
- Propose features on our GitHub Discussions page.
- Join our upcoming dev meetings (meeting access and agenda).
- Join the flux-dev mailing list.
- Check out how to contribute to the project.
- Check out the project roadmap.
Events
Check out our events calendar, both with upcoming talks, events and meetings you can attend. Or view the resources section with past events videos you can watch.
We look forward to seeing you with us!