Skip to content

Using builder cli

Jump to bottom
Olivier Bitsch edited this page Jun 25, 2021 · 2 revisions

Builder-CI provide a simple builder-ci cli command.

root@builder:~# builder-ci 
usage: builder-ci [-h] {build,list,remove,logs} ...

Helper for automated Build system

positional arguments:
  {build,list,remove,logs}
                        action help
    build               build the project
    list                list the projects
    remove              list the projects
    logs                get logs of project

optional arguments:
  -h, --help            show this help message and exit

Get list of all builds

builder-ci list

The resulting list represents the ID, the project name and the status of the build.

Run or re-run manually a build

In usual case, builds are automatically handled by the listener. But you can re-run a build with the following command.

builder-ci build <id>

It can be very convenient to manually run the build for debugging as you will get real time logging.

Warning : replaying a build might fails as system will never override existing files (e.g. into repository). Ensure to make proper cleanup before.

Get logs of a build

You can easily get logs of a build with the following command:

builder-ci logs <id>

Get builder logs

Builder-Ci attempt to provide a lot of logs, by example what command is ran or what issue it encountered. You can have real time logging with the following command.

journalctl -u builder-ci-api -u builder-ci-worker -f

Clone this wiki locally