wusa 0.0.4

CLI for managing containerized self-hosted GitHub Actions Runner

Wusa

Isis (Ancient Egyptian: ꜣst; Coptic: Ⲏⲥⲉ Ēse; Classical Greek: Ἶσις Isis; Meroitic: 𐦥𐦣𐦯‎ Wos[a] or Wusa) was a major goddess in ancient Egyptian religion whose worship spread throughout the Greco-Roman world.

Source: Wikipedia

Wusa is also a command-line tool to help manage containerized self-hosted GitHub Action Runner. In some rare cases, you might require special hardware to execute your CI/CD pipeline. For these cases, wusa removes the burden of setting up a docker container on your local machine, connecting it to your GitHub repositories, and managing it over time.

WARNING wusa is in the early stages, and issues might appear. Please try it out and let me know what you think of wusa.

Installation

If you wish to install wusa, use pip

pip install wusa

or use pipx

pipx install wusa

Usage

Wusa uses, at the moment, a ubuntu image with the GitHub Action runners. Wusa requires permission to be able to create runners for you. For this, run the following command and follow the steps:

wusa auth

Afterward, you can create a containerized docker runner for a repo by running

wusa create "ahelm/wusa"

With "ahelm/wusa" is the short name of the repository.

If you wish to list all the runner for a repository, run

wusa list-repo "ahelm/wusa"

or if you wish to remove a runner

wusa remove <some_runner_name>