Using builder cli » History » Version 1
Olivier Bitsch, 06/25/2021 10:58 AM
| 1 | 1 | Olivier Bitsch | Builder-CI provide a simple builder-ci cli command. |
|---|---|---|---|
| 2 | |||
| 3 | ~~~ |
||
| 4 | root@builder:~# builder-ci |
||
| 5 | usage: builder-ci [-h] {build,list,remove,logs} ... |
||
| 6 | |||
| 7 | Helper for automated Build system |
||
| 8 | |||
| 9 | positional arguments: |
||
| 10 | {build,list,remove,logs} |
||
| 11 | action help |
||
| 12 | build build the project |
||
| 13 | list list the projects |
||
| 14 | remove list the projects |
||
| 15 | logs get logs of project |
||
| 16 | |||
| 17 | optional arguments: |
||
| 18 | -h, --help show this help message and exit |
||
| 19 | ~~~ |
||
| 20 | |||
| 21 | ## Get list of all builds |
||
| 22 | |||
| 23 | ~~~ |
||
| 24 | builder-ci list |
||
| 25 | ~~~ |
||
| 26 | |||
| 27 | The resulting list represents the ID, the project name and the status of the build. |
||
| 28 | |||
| 29 | ## Run or re-run manually a build |
||
| 30 | |||
| 31 | In usual case, builds are automatically handled by the listener. But you can re-run a build with the following command. |
||
| 32 | |||
| 33 | ~~~ |
||
| 34 | builder-ci build <id> |
||
| 35 | ~~~ |
||
| 36 | |||
| 37 | It can be very convenient to manually run the build for debugging as you will get real time logging. |
||
| 38 | |||
| 39 | > Warning : replaying a build might fails as system will never override existing files (e.g. into repository). Ensure to make proper cleanup before. |
||
| 40 | |||
| 41 | ## Get logs of a build |
||
| 42 | |||
| 43 | You can easily get logs of a build with the following command: |
||
| 44 | |||
| 45 | ~~~ |
||
| 46 | builder-ci logs <id> |
||
| 47 | ~~~ |
||
| 48 | |||
| 49 | ## Get builder logs |
||
| 50 | |||
| 51 | 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. |
||
| 52 | |||
| 53 | ~~~ |
||
| 54 | journalctl -u builder-ci-api -u builder-ci-worker -f |
||
| 55 | ~~~ |