runners

# Runners - GitHub Actions Self-Hosted Runners

## Overview

The `runners` command manages self-hosted GitHub Actions runners using Podman Quadlet containers. It supports multi-instance pools with ephemeral storage for clean builds.

**Key Concept:** Each runner instance connects to a GitHub repository and picks up workflow jobs. Ephemeral storage ensures each job starts with a clean state.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Config | `ujust runners config --repo-url=<URL> --instance=<N>` | Configure runner N for repo |
| Start | `ujust runners start [--instance=N\|all]` | Start runner(s) |
| Stop | `ujust runners stop [--instance=N\|all]` | Stop runner(s) |
| Restart | `ujust runners restart [--instance=N\|all]` | Restart runner(s) |
| Update | `ujust runners update [--instance=N\|all]` | Update to latest image |
| Rolling update | `ujust runners rolling-update` | Update with zero downtime |
| Sync | `ujust runners sync [--instance=N]` | Sync config from source |
| Logs | `ujust runners logs [--instance=N] [--lines=...]` | View logs |
| List | `ujust runners list` | List all runners |
| Shell | `ujust runners shell [--instance=N] [-- CMD...]` | Open shell in container |
| Setup shared storage | `ujust runners setup-shared-storage` | Setup shared storage directory |
| Delete | `ujust runners delete [--instance=N\|all]` | Remove runner(s) and images |

## Prerequisites

```bash
# 1. Authenticate GitHub CLI
gh auth login

# 2. Verify authentication
gh auth status
```

## Configuration

### Parameters

| Parameter | Long Flag | Short | Required | Description |
|-----------|-----------|-------|----------|-------------|
| Repo URL | `--repo-url` | `-r` | Yes | GitHub repository URL |
| Instance | `--instance` | `-n` | Yes | Instance number (1, 2, 3...) |
| Image | `--image` | `-i` | No | Container image |
| Tag | `--tag` | `-t` | No | Image tag (default: stable) |
| Workspace | `--workspace-dir` | `-w` | No | Optio