feat(server): use cron schedule for log removal instead
All checks were successful
ci/woodpecker/pr/docs Pipeline was successful
ci/woodpecker/pr/lint Pipeline was successful
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/docker Pipeline was successful
ci/woodpecker/pr/man Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
All checks were successful
ci/woodpecker/pr/docs Pipeline was successful
ci/woodpecker/pr/lint Pipeline was successful
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/docker Pipeline was successful
ci/woodpecker/pr/man Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
This commit is contained in:
parent
09c61143b0
commit
26796f2228
7 changed files with 75 additions and 21 deletions
|
|
@ -32,11 +32,11 @@ configuration variable required for each command.
|
|||
|
||||
### `vieter server`
|
||||
|
||||
* `port`: HTTP port to run on
|
||||
* Default: `8000`
|
||||
* `log_level`: log verbosity level. Value should be one of `FATAL`, `ERROR`,
|
||||
`WARN`, `INFO` or `DEBUG`.
|
||||
* Default: `WARN`
|
||||
* `log_file`: log file to write logs to.
|
||||
* Default: `vieter.log` (in the current directory)
|
||||
* `pkg_dir`: where Vieter should store the actual package archives.
|
||||
* `data_dir`: where Vieter stores the repositories, log file & database.
|
||||
* `api_key`: the API key to use when authenticating requests.
|
||||
|
|
@ -44,14 +44,27 @@ configuration variable required for each command.
|
|||
* Packages with architecture `any` are always added to this architecture.
|
||||
This prevents the server from being confused when an `any` package is
|
||||
published as the very first package for a repository.
|
||||
* Git repositories added without an `arch` value use this value instead.
|
||||
* `port`: HTTP port to run on
|
||||
* Default: `8000`
|
||||
* Targets added without an `arch` value use this value instead.
|
||||
* `global_schedule`: build schedule for any target that does not have a
|
||||
schedule defined. For information about this syntax, see
|
||||
[here](/usage/builds/schedule).
|
||||
* Default: `0 3` (3AM every night)
|
||||
* `base_image`: Docker image to use when building a package. Any Pacman-based
|
||||
distro image should work, as long as `/etc/pacman.conf` is used &
|
||||
`base-devel` exists in the repositories. Make sure that the image supports
|
||||
the architecture of your cron daemon.
|
||||
* Default: `archlinux:base-devel` (only works on `x86_64`). If you require
|
||||
`aarch64` support, consider using
|
||||
[`menci/archlinuxarm:base-devel`](https://hub.docker.com/r/menci/archlinuxarm)
|
||||
([GitHub](https://github.com/Menci/docker-archlinuxarm)). This is the
|
||||
image used for the Vieter CI builds.
|
||||
* `max_log_age`: maximum age of logs (in days). Logs older than this will get
|
||||
cleaned by the log removal daemon every 24 hours. If set to a negative value,
|
||||
no logs are ever removed. The age of logs is determined by the time the build
|
||||
was started.
|
||||
cleaned by the log removal daemon . If set to a negative value, no logs are
|
||||
ever removed. The age of logs is determined by the time the build was
|
||||
started.
|
||||
* Default: `-1`
|
||||
* `log_removal_schedule`: cron schedule defining when to clean old logs.
|
||||
* Default: `0 0` (every day at midnight)
|
||||
|
||||
### `vieter cron`
|
||||
|
||||
|
|
|
|||
24
docs/content/usage/builds/cleanup.md
Normal file
24
docs/content/usage/builds/cleanup.md
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
weight: 20
|
||||
---
|
||||
|
||||
# Cleanup
|
||||
|
||||
Vieter stores the logs of every single package build. While this is great for
|
||||
debugging why builds fails, it also causes an active or long-running Vieter
|
||||
instance to accumulate thousands of logs.
|
||||
|
||||
To combat this, a log removal daemon can be enabled that periodically removes
|
||||
old build logs. By starting your server with the `max_log_age` variable (see
|
||||
[Configuration](/configuration#vieter-server) for more info), a daemon will
|
||||
get enabled that periodically removes logs older than this setting. By default,
|
||||
this will happen every day at midnight, but this behavior can be changed using
|
||||
the `log_removal_schedule` variable.
|
||||
|
||||
{{< hint info >}}
|
||||
**Note**
|
||||
The daemon will always run a removal of logs on startup. Therefore, it's
|
||||
possible the daemon will be *very* active when first enabling this setting.
|
||||
After the initial surge of logs to remove, it'll calm down again.
|
||||
{{< /hint >}}
|
||||
|
||||
|
|
@ -1,3 +1,7 @@
|
|||
---
|
||||
weight: 10
|
||||
---
|
||||
|
||||
# Cron schedule syntax
|
||||
|
||||
The Vieter cron daemon uses a subset of the cron expression syntax to schedule
|
||||
|
|
|
|||
Reference in a new issue