Files
radicle-native-ci/README.md
T
2024-04-15 19:30:22 +03:00

73 lines
1.9 KiB
Markdown

# radicle-native-ci
This is an adapter for the [Radicle CI broker], for performing CI runs
locally. This means it reads a JSON message from its stdin, and writes
two JSON messages to its stdout. Its configured via a configuration
file specified in the `RADICLE_NATIVE_CI` environment variable. There
is currently no logging.
The CI run is performed locally, without any isolation. This is not
safe and secure, but it's simple, and easy to get working. Do not use
this unless you trust the repository and its dependencies.
The repository must contain a file `./radicle/native.yaml` that
specifies how CI is run for the repository. For example:
```yaml
shell: |
cargo test --locked --workspace
```
[Radicle CI broker]: https://app.radicle.xyz/nodes/radicle.liw.fi/rad:zwTxygwuz5LDGBq255RA2CbNGrz8
## Architecture
See the [documentation](doc) directory for an architecture document.
## Configuration
The adapter requires the `RADICLE_NATIVE_CI` environment variable to
be set to the filename of a configuration file in YAML. For example:
~~~yaml
state: /srv/http
log: /home/_rad/native-ci.log
~~~
The fields are:
* `state` --- required, directory where per-run directories are stored
* `log` --- required, file where native CI should write a log
* `timeout` --- optional, maximum duration of the run, in seconds
## Packaging
There is simple, simplistic, rudimentary, personal-use-only packaging
for Debian in the `debian` directory, used by Lars to build packages
for his own use.
## Running tests
To run the test suite for the CI broker:
~~~sh
cargo test
~~~
(The usual way, for a Rust program.)
Also, there is `.radicle/native.yaml` for testing this with itself in
Radicle CI. You may want to run those manually.
## License
Radicle native CI is distributed under the terms of both the MIT
license and the Apache License (Version 2.0).
See [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.