flux-local command line tool

[allenporter]

The flux-local command line till will run the various tests in the library with the goal of meeting these use cases:

• Run kustomize build on the cluster resources as a test to run before committing code, either as a pre-commit or a manually run tests ( example ), or run in CI ( example This will support overlays and multi-cluster repos like the existing tests for my k8s-gitops repo.
• Run the above, but also expanding HelmRelease for a specific chart version. The primary use case is to assist with HelmRelease version upgrades ( example ). This includes pulling in necessary HelmRepository objects from the cluster.
• Run the above, but also run kyverno cli policies to verify that cluster resources confirm to spec ( example )
• Support a diff command on HelmRelease objects to support upgrades (example cubic3d's diff-hr-on-pr )

You can do all of this today with the above references, so we're just pulling this together these various resources, but is complex to get to support all working together and supporting overlays, multi-cluster, or policies.

[allenporter]

Work Items:

• Initial tool with build support w/ helm
• Add option to skip crds
• Add test version that looks like pytest
• Test harness for CLI
• Allow policy checking end to end flux-local: Allow policy checking #43
• Enable diff command
• Support selection of flux namespaces flux-local: Allow selecting different clusters for flux-system by namespace #44
• Ability to create and print manifest yaml file
• Ability to consume manifest file for building, etc flux-local: Manifest improvements #45
• Improve documentation for build use cases (w/ helm)
• Improve documentation for manifest read/write use cases. flux-local: Manifest improvements #45
• Improve documentation for policy use cases flux-local: Allow policy checking #43

[allenporter]

The remaining items will be tracked separately.