# Rocky Linux Testing Framework

Simple, portable testing framework for Rocky Linux using Sparrowdo.

## Quick Start

### Prerequisites

```bash
sudo dnf install -y qemu-kvm libvirt virt-install guestfs-tools rakudo
sudo systemctl enable --now libvirtd
sudo usermod -a -G libvirt $(whoami)
```

### Manual Test

```bash
# Download base image
BASE=$(./scripts/download-image.sh https://download.rockylinux.org/pub/rocky/9/images/x86_64/Rocky-9-GenericCloud-Base.latest.x86_64.qcow2)

# Build golden image (includes Sparrowdo bootstrap)
./scripts/build-golden.sh "$BASE" /var/lib/libvirt/images/golden.qcow2

# Run a test
./scripts/run-test.sh my-test https://github.com/your-org/test-repo.git /var/lib/libvirt/images/golden.qcow2

# Cleanup
./scripts/cleanup-all.sh
```

### Jenkins

1. Create Pipeline job
2. Point to `Jenkinsfile.simple`
3. Set parameters:
   - `QCOW2_URL`: Rocky Linux image URL
   - `TEST_REPOS`: One repo URL per line
   - `MAX_PARALLEL`: Number of concurrent tests

## Scripts

- `download-image.sh` - Download/cache QCOW2 images
- `build-golden.sh` - Create golden image with Sparrowdo
- `run-test.sh` - Run single test in isolated VM
- `provision_vm.sh` - Create and start VM
- `cleanup_vm.sh` - Destroy VM
- `cleanup-all.sh` - Emergency cleanup

## How It Works

1. Download Rocky Linux QCOW2 (cached)
2. Build golden image:
   - Install Raku, Sparrowdo, dependencies
   - Create `rocky` user with sudo
   - Inject SSH keys
   - Bootstrap Sparrowdo
3. For each test:
   - Provision VM (linked clone, fast)
   - Clone test repo
   - Run `sparrowdo --no_sudo`
   - Cleanup VM

## Test Repository Format

Your test repo needs either `sparrowfile` or `main.raku`:

```raku
#!/usr/bin/env raku

use Sparrowdo;

task-run 'check-service', %(
    plugin => 'systemd-service',
    args => ['sshd', 'running']
);
```

## Portability

All logic is in shell scripts. Easy to move to:
- GitHub Actions: Call scripts in workflow
- GitLab CI: Call scripts in `.gitlab-ci.yml`
- Windmill: Call scripts as tasks
- Manually: Run scripts directly

## Troubleshooting

```bash
# List VMs
virsh -c qemu:///system list --all

# Get VM IP
virsh -c qemu:///system domifaddr <vm-name>

# SSH to VM
ssh -i ~/.ssh/id_rsa rocky@<ip>

# View VM console
virsh -c qemu:///system console <vm-name>

# Force cleanup
./scripts/cleanup-all.sh
```