vieter/docs/content/usage/builds/_index.md

2.0 KiB

weight
20

Building packages

The automatic build system is what makes Vieter very useful as a replacement for an AUR helper. It can perodically build packages & publish them to your personal Vieter repository server, removing the need to build the packages locally.

Adding builds

Before the cron system can start building your package, you need to add its info to the system. The Vieter repository server exposes an HTTP API for this (see the HTTP API Docs for more info). For ease of use, the Vieter binary contains a CLI interface for interacting with this API (see Configuration for configuration details). The man pages describe this in greater detail, but the basic usage is as follows:

vieter targets add some-url some-branch some-repository

Here, some-url is the URL of the Git repository containing the PKGBUILD. This URL is passed to git clone, meaning the repository should be public. Vieter expects the same format as an AUR Git repository, so you can directly use AUR URLs here.

some-branch is the branch of the Git repository the build should check out. If you're using an AUR package, this should be master.

Finally, some-repo is the repository to which the built package archives should be published.

The above command intentionally leaves out a few parameters to make the CLI more useable. For information on how to modify all parameters using the CLI, see vieter-targets-edit(1).

Reading logs

The logs of each build are uploaded to the Vieter repository server, along with information about the exit code of the build container, when the build started/ended etc. These logs can then be accessed using the HTTP API.

For ease of use, the logs are also available using some CLI commands; see vieter-logs(1) for more information.