2022-04-30 23:24:07 +02:00
|
|
|
---
|
|
|
|
|
weight: 20
|
|
|
|
|
---
|
|
|
|
|
# Configuration
|
|
|
|
|
|
|
|
|
|
All vieter operations by default try to read in the TOML file `~/.vieterrc` for
|
|
|
|
|
configuration. The location of this file can be changed by using the `-f` flag.
|
|
|
|
|
|
|
|
|
|
If the above file doesn't exist or you wish to override some of its settings,
|
|
|
|
|
configuration is also possible using environment variables. Every variable in
|
|
|
|
|
the config file has a respective environment variable of the following form:
|
|
|
|
|
say the variable is called `api_key`, then the respective environment variable
|
|
|
|
|
would be `VIETER_API_KEY`. In essence, it's the variable in uppercase prepended
|
|
|
|
|
with `VIETER_`.
|
|
|
|
|
|
|
|
|
|
If a variable is both present in the config file & as an environment variable,
|
|
|
|
|
the value in the environment variable is used.
|
|
|
|
|
|
|
|
|
|
{{< hint info >}}
|
|
|
|
|
**Note**
|
|
|
|
|
All environment variables can also be provided from a file by appending them
|
|
|
|
|
with `_FILE`. This for example allows you to provide the API key from a docker
|
|
|
|
|
secrets file.
|
|
|
|
|
{{< /hint >}}
|
|
|
|
|
|
|
|
|
|
## Modes
|
|
|
|
|
|
|
|
|
|
The vieter binary can run in several "modes", indicated by the first argument
|
|
|
|
|
passed to them. Each mode requires a different configuration.
|
|
|
|
|
|
|
|
|
|
### Server
|
|
|
|
|
|
|
|
|
|
* `log_level`: defines how much logs to show. Valid values are one of `FATAL`,
|
|
|
|
|
`ERROR`, `WARN`, `INFO` or `DEBUG`. Defaults to `WARN`
|
|
|
|
|
* `log_file`: log file to write logs to. Defaults to `vieter.log` in the
|
|
|
|
|
current directory.
|
|
|
|
|
* `pkg_dir`: where Vieter should store the actual package archives.
|
2022-05-03 20:13:28 +02:00
|
|
|
* `data_dir`: where Vieter stores the repositories, log file & database.
|
2022-04-30 23:24:07 +02:00
|
|
|
* `api_key`: the API key to use when authenticating requests.
|
|
|
|
|
* `default_arch`: architecture to always add packages of arch `any` to.
|
|
|
|
|
|
|
|
|
|
### Builder
|
|
|
|
|
|
|
|
|
|
* `api_key`: the API key to use when authenticating requests.
|
|
|
|
|
* `address`: Base your URL of your Vieter instance, e.g. https://example.com
|
|
|
|
|
* `base_image`: image to use when building a package. It should be an Archlinux
|
|
|
|
|
image. The default if not configured is `archlinux:base-devel`, but this
|
|
|
|
|
image only supports arm64. If you require aarch64 support as well, consider
|
|
|
|
|
using
|
|
|
|
|
[`menci/archlinuxarm:base-devel`](https://hub.docker.com/r/menci/archlinuxarm)
|
|
|
|
|
([GH](https://github.com/Menci/docker-archlinuxarm))
|
|
|
|
|
|
|
|
|
|
### Repos
|
|
|
|
|
|
|
|
|
|
* `api_key`: the API key to use when authenticating requests.
|
|
|
|
|
* `address`: Base your URL of your Vieter instance, e.g. https://example.com
|
2022-05-03 20:13:28 +02:00
|
|
|
|
|
|
|
|
### Cron
|
|
|
|
|
|
|
|
|
|
* `log_level`: defines how much logs to show. Valid values are one of `FATAL`,
|
|
|
|
|
`ERROR`, `WARN`, `INFO` or `DEBUG`. Defaults to `WARN`
|
|
|
|
|
* `api_key`: the API key to use when authenticating requests.
|
|
|
|
|
* `address`: Base your URL of your Vieter instance, e.g. https://example.com.
|
|
|
|
|
This *must* be the publicly facing URL of your Vieter instance.
|
|
|
|
|
* `data_dir`: where Vieter stores the log file.
|
|
|
|
|
* `base_image`: Docker image from which to create the builder images.
|
|
|
|
|
* `max_concurrent_builds`: amount of builds to run at once.
|
|
|
|
|
* `api_update_frequency`: how frequenty to check for changes in the repo list.
|
|
|
|
|
* `image_rebuild+frequency`: how frequently to rebuild the builder image
|
|
|
|
|
* `global_schedule`: cron schedule to use for any repo without an individual
|
|
|
|
|
schedule
|
