Skip to content
/ autokvm Public

An automation library for managing KVM virtual machines and related network functions on RHEL based Linux

Notifications You must be signed in to change notification settings

tassm/autokvm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

autokvm

A script library for high speed deployment of virtual machines using cloud images. Autokvm allows near pain free deployment of virtual machines on your network. Machines can be configures with static IP or DHCP from bridge interface. No setup or configuration should be required to get things working in your guests. Autokvm leverages libvirt for automation of QEMU/KVM.

Only RHEL based VMs are supported at this time.

These scripts were developed and tested on CentOS 8 and Fedora 30 and should be compliant with all RHEL8+ distributions.

Requirements

  • RHEL8+ Linux
  • VT-x or AMD-V virtualization enabled in your system BIOS
  • All scripts must be run with root privileges

Installation

  1. Clone the repository
  2. CD to the repositories base directory
  3. Run autokvm-install.sh

Usage

Example files can be found in /etc/autokvm.cfg.d/example following the install.

  • network-config-sample.conf can be used in both cloud-vm-deploy.sh and network-bridge-add.sh
  • vm-config-sample.conf can be used in cloud-vm-deploy.sh to provide the VM configuration parameters

Run the various scripts with -h flag as the first argument for the usage message.

Networks

By default, the guest networking will be configured via DHCP from the network on the bridge interface. If the network-config parameter is supplied, the guest will be deployed with a static IP as specified in the network-config file argument when running cloud-vm-deploy.sh. Valid parameters must be supplied as specified in the example network config file in order to be able to connect to the VM following the install.

Bridge Interfaces

The Default bridge interface generated by libvirt is virbr0 This interface provides a NAT network for accessing hosts from the hypervisor.

For hosts to be accessible from your LAN you should create a bridge for your systems Ethernet connection by using the included network-bridge-add.sh or other means. This will then be used in the BRIDGE_INTERFACE parameter of your vm-config file.

Notes

  • Debian 10 image is not currently supported, associated issues with cloud-init

About

An automation library for managing KVM virtual machines and related network functions on RHEL based Linux

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages