Skip to content
PodUtilsPublic

About

Ephemeral CI runners on your own servers: one fresh container or microVM per job, for GitHub and forge job sources, outbound 443 only.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

podrunner

One static program that runs a CI job in one fresh unit for each job. It finds a job, picks the safest isolation that the host offers, runs the official actions/runner once inside it, reports, and destroys the unit. It needs no root, no namespaces and no docker daemon; a proxy is the only way out of a unit.

Status: beta, not for production. No live job ran on github.com: the live gates (GitHub #74 and #75, T-033) wait for their reports. The plan and its milestones are in GitHub #1; the work is in TODO/ (TODO/PROGRESS.md). docs/cli.md gives the commands and docs/configuration.md the configuration file.

Quick start: the local mode

Run the workflows of a project on this host, each job in a fresh unit, with no root and no daemon (docs/local-mode.md). Take the installer of a release that attaches podrunner-install.sh (docs/install.md), with its version in place of VERSION:

curl -fsSLO "https://github.com/PodUtils/podrunner/releases/download/vVERSION/podrunner-install.sh"
sh podrunner-install.sh
cd YOUR-PROJECT && podrunner run .github/workflows/ci.yml --checkout .

The installer checks each file against the SHA-256 that it pins. For a host with no network, the release attaches one offline bundle for each architecture.

Build

cargo build --release
sh scripts/check-static.sh target/x86_64-unknown-linux-musl/release/podrunner

The binary is static musl. docs/development.md gives the rules of the code; AGENTS.md gives the rules of each session.

License

0BSD (LICENSE). THIRD_PARTY.md lists the components with other licences.

About

Ephemeral CI runners on your own servers: one fresh container or microVM per job, for GitHub and forge job sources, outbound 443 only.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages