https://github.com/plus3it/flux-cli-formula
SaltStack-based content for installing and configuring the Flux continuous-delivery application to selected client-types
https://github.com/plus3it/flux-cli-formula
Last synced: 7 days ago
JSON representation
SaltStack-based content for installing and configuring the Flux continuous-delivery application to selected client-types
- Host: GitHub
- URL: https://github.com/plus3it/flux-cli-formula
- Owner: plus3it
- License: apache-2.0
- Created: 2026-05-11T11:25:55.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-22T13:15:59.000Z (30 days ago)
- Last Synced: 2026-05-22T18:16:11.053Z (30 days ago)
- Language: Jinja
- Size: 91.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
flux-cli-formula
==================
A SaltStack formula designed to install and configure the [Flux](https://fluxcd.io/flux/cmd/) CLI utility on installation-targets.
It is primarily expected that this formula will be run via [P3](https://www.plus3it.com/)'s "[watchmaker](https://watchmaker.readthedocs.io/en/stable/)" framework.
This formula is able to install the Flux CLI on both Linux[^1] and Windows Server[^2] operating environments. Intallation for internet-connected systems may come from the Flux CLI project's ["releases" page](https://github.com/fluxcd/flux2/releases). If installing this way, the formula will install the latest-available version of the content. Alternately:
* Sites whose installation-targets won't be able to reach the Flux CLI project's GitHub repository will need to self-host copies of the desired content.
* Sites that wish to use a specific version of the Flux CLI will need to target that content
Targeting specific versions of the FluX CLI or local copies of the install-archives can be directed to do so by adding appropriate content to the formula's associated Pillar-data (see thish projct's [pillar.example](pillar.example) file for guidance).
## Available states
- [flux-cli](#flux-cli)
- [flux-cli.clean](#flux-cli.clean)
- [flux-cli.package](#flux-cli.package)
- [flux-cli.package.clean](#flux-cli.package.clean)
- [flux-cli.config](#flux-cli.config)
- [flux-cli.config.clean](#flux-cli.config.clean)
### flux-cli
Executes the `package` and `config` states to install and configure the Flux CLI
### flux-cli.clean
Executes the `package` and `config` states' `clean` actions to fully uninstall the Flux CLI and remove previously-installed browser policy-configs (and, on Windows, associated registry entries)
### flux-cli.package
Executes _just_ the `package` state to install the Flux CLI package.
### flux-cli.package.clean
Executes _just_ the `package.clean` state to uninstall the Flux CLI package.
### flux-cli.config
Executes _just_ the `config` state to install/configure the Flux CLI client-configuration (etc.) files
### flux-cli.config.clean
Executes _just_ the `config` state to uninstall the Flux CLI client-configuration (etc.) files and, on Windows, remove any registry-keys set by prior install-runs of the formula.
[^1]: As of this README's writing, only Enterprise Linux and related distros (Red Hat and Oracle Enterprise, CentOS Stream, Rocky and Alma Linux). It has only been specifically tested with EL **_9_** variants.
[^2]: As of this README's writing, this functionality has only been tested on Windows Server 2022