forked from vieter-v/vieter
52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
---
|
|
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](https://rustybever.be/docs/vieter/api/) for more
|
|
info). For ease of use, the Vieter binary contains a CLI interface for
|
|
interacting with this API (see [Configuration](/configuration) for
|
|
configuration details). The [man
|
|
pages](https://rustybever.be/man/vieter/vieter-targets.1.html) 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)](https://rustybever.be/man/vieter/vieter-targets-edit.1.html).
|
|
|
|
## 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](https://rustybever.be/docs/vieter/api/).
|
|
|
|
For ease of use, the logs are also available using some CLI commands; see
|
|
[vieter-logs(1)](https://rustybever.be/man/vieter/vieter-logs.1.html) for more
|
|
information.
|