cd ansible

# 1. Build golden image (libvirt only)
ansible-playbook playbooks/libvirt/build-golden-image.yml

# 2. Run all tests
ansible-playbook playbooks/run-tests.yml

# 3. Run specific test
ansible-playbook playbooks/run-tests.yml -e "test_filter=Sparky_Knot"

Documentation

See ANSIBLE-GUIDE.md for complete documentation.

Structure

ansible/
├── ansible.cfg              # Ansible configuration
├── inventory/
│   ├── hosts.yml           # Provider groups (libvirt, aws, azure)
│   └── group_vars/
│       ├── all.yml         # Provider-agnostic variables
│       ├── libvirt.yml     # Libvirt-specific settings
│       ├── aws.yml         # AWS-specific settings (placeholder)
│       └── azure.yml       # Azure-specific settings (placeholder)
├── vars/
│   └── test-definitions.yml # Test repository list
├── tasks/
│   └── run-test-with-infrastructure.yml # Provider-aware orchestration
├── playbooks/
│   ├── libvirt/            # Libvirt-specific playbooks
│   │   └── build-golden-image.yml
│   ├── aws/                # AWS-specific playbooks (future)
│   ├── azure/              # Azure-specific playbooks (future)
│   └── run-tests.yml       # Provider-agnostic test runner
└── roles/
    ├── download_image/     # Download QCOW2 images
    ├── golden_image/       # Build golden image
    ├── bootstrap_sparrowdo/# Bootstrap Sparrowdo
    ├── provision_vm/       # Provision VMs (libvirt)
    ├── run_test/          # Execute Sparrowdo tests
    └── cleanup_vm/        # Cleanup VMs (libvirt)

Roles

Role	Purpose
`download_image`	Download and cache QCOW2 images
`golden_image`	Create golden image with virt-customize
`bootstrap_sparrowdo`	Bootstrap Sparrowdo on golden image
`provision_vm`	Provision VM as linked clone
`run_test`	Execute Sparrowdo test
`cleanup_vm`	Clean up VMs and disks

Playbooks

Provider-Agnostic

Playbook	Purpose
`run-tests.yml`	Run tests from test-definitions.yml (works on any provider)

Libvirt-Specific

Playbook	Purpose
`libvirt/build-golden-image.yml`	Build golden image with interactive prompts

Future

aws/ - AWS-specific setup playbooks
azure/ - Azure-specific setup playbooks

Configuration

Provider Groups

The inventory is organized by provider type:

libvirt - Local VM testing (requires golden image)
aws - AWS EC2 testing (uses AMIs, ready for implementation)
azure - Azure VM testing (uses VM images, ready for implementation)

Test Definitions

Edit vars/test-definitions.yml to add/modify tests:

tests:
  - name: "Sparky_Knot"
    repo_url: "https://git.resf.org/testing/Sparky_Knot.git"
    # Optional: branch, timeout

Provider-Specific Settings

all.yml - Settings for all providers (SSH, Sparrowdo, etc.)
libvirt.yml - VM resources, image paths, packages
aws.yml - AMI IDs, instance types (when implemented)
azure.yml - Image references, VM sizes (when implemented)

Examples

Build Golden Image (Libvirt Only)

# Interactive prompt for Rocky image URL
ansible-playbook playbooks/libvirt/build-golden-image.yml

Run All Tests

ansible-playbook playbooks/run-tests.yml

Run Specific Test

ansible-playbook playbooks/run-tests.yml -e "test_filter=Sparky_Knot"

Run Tests on Specific Provider

ansible-playbook playbooks/run-tests.yml --limit libvirt
# Future: --limit aws or --limit azure

Override VM Resources

ansible-playbook playbooks/run-tests.yml -e "vm_memory=4096" -e "vm_vcpus=4"

Troubleshooting

Verbose Output

ansible-playbook playbooks/run-tests.yml -vvv

Check Syntax

ansible-playbook playbooks/libvirt/build-golden-image.yml --syntax-check

List Tasks

ansible-playbook playbooks/run-tests.yml --list-tasks

Key Features

Provider-aware - Supports multiple infrastructure providers (libvirt, AWS, Azure)
Test definitions - Centralized test repository list in vars/test-definitions.yml
Interactive prompts - No need to remember image URLs or flags
Result tracking - Shows passed/failed tests with summary report
Automatic cleanup - Infrastructure cleaned up after each test
Idempotent - Safe to re-run
Integration with Ascender - Works with Ansible automation platform

Script Mapping

Shell Script	Ansible Role
`download-image.sh`	`download_image`
`setup_base.sh` + `build-golden.sh`	`golden_image`
`bootstrap_golden.sh`	`bootstrap_sparrowdo`
`provision_vm.sh`	`provision_vm`
`run-test.sh`	`run_test`
`cleanup_vm.sh`	`cleanup_vm`

Prerequisites

sudo dnf install -y ansible qemu-kvm libvirt virt-install guestfs-tools rakudo
sudo systemctl enable --now libvirtd
sudo usermod -a -G libvirt $(whoami)
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N ""

License

[Your License Here]