Skip to content

botagas/yunorunner_ynh

 
 

Repository files navigation

YunoRunner for YunoHost

Integration level Working status Maintenance status

Install YunoRunner with YunoHost

Read this README in other languages.

This package allows you to install YunoRunner quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Yunorunner is a CI server for YunoHost apps.

It is based on Incus / LXC and uses package_check.

This package allows you to self-host a yunorunner instance with the ability to also use it in your own github repositories. The process is:

  • Create a github personal access token in github developer settings and grant it these permissions: read metadata, read/write to commit statuses and pull requests
  • Clone YunoHost/apps and add necessary details within apps.toml file in your repo
  • Install the app and provide the token, select domain, add the repo for apps.toml
  • Create a webhook in github that points to https://example.tld/github, make it trigger on "Issue Comment" and "Pull Request"
  • (OPTIONAL) Edit your README and add the status/integration badges from your server as well

PATH for status: /api/badge/<app_name>/status

PATH for integration: /api/badge/<app_name>/integration

Example integration / status badge code:

[![Integration level](https://img.shields.io/endpoint?url=https://sub.domain.tld/api/badge/<app_name>/integration)](https://ci-apps.yunohost.org/ci/apps/<app_name>/)`
![Working status](https://img.shields.io/endpoint?url=https://sub.domain.tld/api/badge/<app_name>/status)

Shipped version: 2024.12.10~ynh1

Screenshots

Screenshot of YunoRunner

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that:

sudo yunohost app install https://github.com/YunoHost-Apps/yunorunner_ynh/tree/testing --debug
or
sudo yunohost app upgrade yunorunner -u https://github.com/YunoHost-Apps/yunorunner_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps

About

YunoRunner package for YunoHost

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 99.0%
  • Python 1.0%