docs: update readme
All checks were successful
continuous-integration/drone/push Build is passing

Signed-off-by: kjuulh <contact@kjuulh.io>
This commit is contained in:
Kasper Juul Hermansen 2024-02-10 22:45:49 +01:00
parent 445720c22c
commit 39d4109c36
Signed by: kjuulh
GPG Key ID: 57B6E1465221F912

View File

@ -1 +1,47 @@
# 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
```
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.