itsbill / fast-vm Goto Github PK
View Code? Open in Web Editor NEWThis project forked from ondrejhome/fast-vm
'fast-vm' is a script for defining VMs from images provided in thin LVM pool.
License: GNU General Public License v3.0
This project forked from ondrejhome/fast-vm
'fast-vm' is a script for defining VMs from images provided in thin LVM pool.
License: GNU General Public License v3.0
== FAST-VM == fast-vm โ script for defining VMs from images provided in thin LVM pool fast-vm provides command-line interface to create virtual machines (VMs) in libvirt, based on imported disks in LVM and XML templates. === 5-minute Quick Start === Check the videos below on how to: - install and configure fast-vm (1m) - https://asciinema.org/a/147355 - import images and create VMs (1m) - https://asciinema.org/a/143564 - do basic operations in fast-vm (2m) - https://asciinema.org/a/143565 === DOCUMENTATION and USER GUIDE === user and installation guide: https://www.famera.cz/blog/fast-vm/user_guide.html man pages: fast-vm(8) fast-vm.conf(5) configure-fast-vm(8) ====== Supported/Tested OS ===== Distribution Installation method - RHEL 7.5 RPM - CentOS 7.4 RPM - Fedora 28 RPM - Debian 9.4 DEB - Gentoo ebuild ====== Requirements ====== * libvirt with qemu/kvm * libxml2 (xmllint) * LVM thin pool support * LVM VG with reasonable amount of free space (to create LV with thin pool) ** you can use 'losetup' to create a loopback device with LVM * preconfigured VM disk images and XML files (downloadable separately) * 'dhcp_release' for proper DHCP static leases release * 'flock' for image locking (prevent use of not fully imported images) * (optional) 'bash-completion' for bash completion to work * (optional) 'pv' to show import progress * (optional) 'curl' to pass http(s) link for image_import * (optional) OVMF UEFI image for UEFI support in images === How to contribute === - check GitHub issues with tag 'help_wanted' - report issues/request features in GitHub issues If unsure where to start check with author === License and Support === fast-vm is distributed under GPLv3 (or newer if it exists). Author will try to supports only the newest release. === Author === Ondrej Famera <[email protected]> or <[email protected]> ====== Known bugs/limitation ====== * initial setup requires root * Gentoo might require user to be in group 'kvm' to use guestfish from hacks files * VM images are provided separately - publicly available images can be found at https://github.com/OndrejHome/fast-vm-public-images * using 'dhcp_release' to remove DHCP static reservation is not the cleanest way of doing so, but there is no other supported way of doing this through libvirt (TODO: make RFE/BUG into libvirt) * sometimes the VM doesn't get designated IP address because the dnsmasq holds the lease for some older MAC address (dhcp_release should be fixing this but it's not 100% working solution) - use fast-vm-net-cleanup to fix this issue * (from fast-vm-1.3) random failures of 'virsh list' are not handled. For example if 'virsh list' is called 2 times and second time it fails, then fast-vm doesn't handle that well. Re-running command helps. This was observed on my testing machine, but I failed to reproduce behaviour. The logs shows following error around time when this happens error : virHashForEach:597 : Hash operation not allowed during iteration * (upgrading to 'fast-vm-1.4) because of the VM metadata location change you need to run the 'configure-fast-vm' as root after upgrade to migrate the metadata to new location ====== FAQ ====== Q: Why is it using LVM? A: Because LVM provides very reasonable management of block devices and writable snapshots with thin provisioning. Q: Why is it not using file-based disk images? A: It takes much more space. Q: Why not to use file-based disk images with cow (copy-on-write) image? A: Because if you change the image, the cow images will get corrupted unless you somehow re-export them. By using LVM this is not a concern as the LVM is keeping track of changes and will preserve the changes stuff in snaphost so it is safe to edit base image while having machines that are based on previous version of the base image. Q: Why not to use BTRFS cow? A: BTRFS is not as widely spread as LVM and it is not clear if it would be able to provide same functionality as LVM. There is possibility that I will look at this in the future.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.