flux-releaser/README.md
kjuulh c3739c1bc1
feat: can upload archives
Signed-off-by: kjuulh <contact@kjuulh.io>
2024-02-18 01:29:46 +01:00

51 lines
1.4 KiB
Markdown

# Flux releaser
## Usage
```bash
mkdir -p some/path
mkdir -p some/path/someEnvironment
touch some/path/someEnvironment/someFile.txt
# Should be run from a ci pipeline
flux-releaser commit \
--app someApp \
--branch someBranch \
--include some/path \
--registry https://flux-releaser.i.kjuulh.io
```
!!! note
include path should include a sub folder for each releaseable artifact
flux releaser can also be used as a library, which is especially useful if integrated with dagger
Now you can release or auto-release this your desired environment and app
```bash
flux-releaser release \
--app someApp \
--branch someBranch \
--registry https://flux-releaser.i.kjuulh.io
```
If cuddle.yaml is available it will automatically include required information from its references
```bash
flux-releaser release --branch someBranch
```
## Install
### Client & CI
Flux releaser is a rust app used client side and in CI as a cli app (flux-releaser), or alternatively as a rust library.
### Registry
Flux releaser requires a server to function. Said flux is packaged in a helm chart, and is available at `tbd`, if the helm chart is used, it will stand-up a cockroach cluster and minio for artifacts.
Flux releaser also requires a connection to a flux gitops registry. This is provided to the flux app on the server via. a toml file (see configuration), but the defaults should work fine.