Skip to content

boringcactus/micro-ci

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 

micro-ci

Tiny self-hosted CI with minimal requirements.

Installation

cargo install micro-ci or yoink a Linux binary of the latest release.

Configuration

Global configuration on the server goes in micro-ci.toml in the config_dir() found by dirs Get yourself a GitHub access token here. Make sure you can serve static files over HTTP from some directory to some URL - in the use case for which I'm developing this, I can toss files in ~/public_html and they're public. micro-ci will make a subfolder for each project you build with it, so I've got it pointed at ~/public_html/ci.

github_token = "asdfghjkl"
web_root_path = "/path/to/folder"
web_root_url = "https://example.com/url/for/same/folder"
fetch_interval = 60 # measured in seconds

Local (per-repository) configuration goes in .micro-ci.toml at the same level where your command should be run. Command will be run with bash -c <command> 2>&1 so either be concise or write a helper script. (This probably means micro-ci doesn't work as well on Windows.)

github_repo = "boringcactus/micro-ci"
command = "cargo test"

Usage

For each repository you want to use micro-ci to test:

  • Clone it somewhere you won't manually touch
  • Check out the branch you want to run tests on
  • Run micro-ci in the folder where .micro-ci.toml lives and your test script should be run
  • To make micro-ci always run tests on the current commit, run micro-ci --run-now
  • For verbose logging if something's broken, set RUST_LOG=micro_ci=debug

About

A tiny CI server

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages