Nested VMs

On an ubuntu test runner, this action will install and prepare libvirt for nested virtualization and then stand up a cluster of vms for testing using Bolt and Terraform.

The Bolt module kvm_automation_tooling is used to provision the VMs.

Supported Platforms

Ubuntu 24.04

Supported VM Platforms

The action can created nested vms for any OS supported by kvm_automation_tooling which currently (v2) includes:

• Almalinux 10, 9, 8
• Debian 13, 12, 11
• Rocky 10, 9, 8
• Ubuntu 24.04, 22.04, 20.04, 18.04

Usage

Minimally, you must specify 'os', 'os-version' and 'os-arch' parameters.

- uses: jpartlow/nested_vms@v1
  with:
    # The default operating system to us for the VMs in the cluster.
    os: almalinux

    # The version of the operating system.
    os-version: 9

    # The architecture of the operating system.
    os-arch: x86_64

By default this will generate a single nested VM with an fqdn of 'test-agent-1.vm' that can be reached via SSH on the runner using the key "${HOME}/.ssh/ssh-id-test.pub" (where $HOME is the home directory of the runner user on the gha runner vm).

License

Copyright (C) 2025 Joshua Partlow

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.