Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tcler/kiss-vm-ns
CLI tools to create KVM Guests, Containers and NetNS(ip netns,vrf) on Linux
https://github.com/tcler/kiss-vm-ns
cloud-init container freebsd generator headless kickstart kiss-netns kiss-ns kiss-vm kvm libvirt linux namespace netns qemu-kvm systemd-container systemd-nspawn virtual-machine vm
Last synced: 3 months ago
JSON representation
CLI tools to create KVM Guests, Containers and NetNS(ip netns,vrf) on Linux
- Host: GitHub
- URL: https://github.com/tcler/kiss-vm-ns
- Owner: tcler
- License: bsd-2-clause
- Created: 2019-12-13T11:16:59.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T15:04:09.000Z (7 months ago)
- Last Synced: 2024-04-13T18:14:00.307Z (7 months ago)
- Topics: cloud-init, container, freebsd, generator, headless, kickstart, kiss-netns, kiss-ns, kiss-vm, kvm, libvirt, linux, namespace, netns, qemu-kvm, systemd-container, systemd-nspawn, virtual-machine, vm
- Language: Shell
- Homepage:
- Size: 18.1 MB
- Stars: 54
- Watchers: 6
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Summary
Here we provide three CLI tools **vm, ns, netns** that used to auto create KVM Guests, Containers and "net ns" on Linux hosts.
//The prefix **kiss** is taken from the [KISS principle](https://en.wikipedia.org/wiki/KISS_principle)
# Requirements/Dependencies
```
kiss-vm: #'sudo vm prepare' will install all dependencies
bash-completion libvirt libvirt-client virt-install virt-viewer qemu-kvm qemu-img
expect nmap-ncat tmux libguestfs-tools-c libvirt-nss dialog udisks2 genisoimage
iptables-nft bind-utils netpbm gocr vncdotool(pip3)
swtpm-tools edk2-ovmf virtio-win python3-qemu-qmp
qemu-system-{aarch64,s390x,ppc,riscv}
kiss-netns:
iproute tmux
kiss-ns:
systemd-nspawn tmux
```
# Install
```
curl -Lks https://raw.githubusercontent.com/tcler/kiss-vm-ns/master/utils/kiss-update.sh|sudo bash && sudo vm prepare
#or
curl -Lks https://github.com/tcler/kiss-vm-ns/archive/refs/heads/master.tar.gz | tar zxf - &&
sudo gmake -C kiss-vm-ns-master && sudo vm prepare
```
# FAQ & Examples
## [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm)
**Q:** how to create a CentOS/RockyLinux/Fedora KVM Guest from location(see also: virt-install --location option)?
**A:** vm create $distro \[-n $vmname] \[-L\[=$localtion_url]] #if there's url in default distro.db, just use -L
```
vm create CentOS-9-stream -n centos9s -L=http://mirror.stream.centos.org/9-stream/BaseOS/$(uname -m)/os/
```
**Q:** how to create a Linux KVM Guest from qcow image(see also: virt-install --import option)?
**A:** vm create $distro \[-n $vmname] \[-I\[=$image_url]] #if there's url in default distro.db, just use -I
```
vm create openSUSE-leap-15.3
```
**Q:** how to get the distro list in default distro.db?
**A:** vm create \\ #bash completion will show avalible distro list in distro.db
```
$ vm create #
# CentOS-8-stream RHEL-6% Windows-10 Windows-server-2019 debian-9 fedora-33 openSUSE-leap-15.3
# CentOS-9-stream RHEL-7% Windows-11 Windows-server-2022 debian-testing fedora-34
CentOS-6 FreeBSD-12.3 RHEL-8% Windows-7 archlinux fedora-30 fedora-35
CentOS-7 FreeBSD-13.0 RHEL-9% Windows-server-2012r2 debian-10 fedora-31 fedora-rawhide
CentOS-8 FreeBSD-14.0 Rocky-8 Windows-server-2016 debian-11 fedora-32 openSUSE-leap-15.2
```
**Q:** does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support auto create FreeBSD Guest with sshd enabled?
**A:** yes, it does (by using vncdotool)
```
vm create FreeBSD-13.0 --msize 4096 --dsize 120G
```
**Q:** does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support auto Windows/Windows-server Guest installing?
**A:** yes, it does since [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) v2.0.0 (by using answer-file-generator.sh), and like Linux/FreeBSD it enable sshd by default on Windows Guest and support ssh login without password
```
vm create Windows-10 -C ~/Downloads/Win10-Evaluation.iso -f
vm create Windows-11 -C ~/Downloads/Win11-Evaluation.iso -f
```
**Q:** does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support auto installing other systems besides linux/freebsd/windows?
**A:** not yet, but it support maually install other systems from iso/localtion/image/pxe ...
```
vm create OI -C ~/Downloads/OI-hipster-gui-20211031.iso
vm create Fedora-35 --pxe [--net=$pxenet] [--diskless]
```
**Q:** How does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) realize automatic installation?
**A:** We mainly achieve the goal of automation by implementing [Redhat based kickstart file generator](https://github.com/tcler/kiss-vm-ns/blob/master/utils/ks-generator.sh), [cloud-init generator](https://github.com/tcler/kiss-vm-ns/blob/master/utils/cloud-init-iso-gen.sh), [windows answerfile generator](https://github.com/tcler/kiss-vm-ns/blob/master/utils/answer-file-generator.sh); then in some special scenarios, we use [OCR](https://en.wikipedia.org/wiki/Optical_character_recognition) technology and [VNC CLI client](https://github.com/sibson/vncdotool) to solve the problem.
\[2022-10] just found a website: [Windows Answer File Generator](https://www.windowsafg.com/win10x86_x64_uefi.html), paste here for people want to customize answerfile interactively
```
$ vm vnc jiyin-opensuse-leap-153 --get
[vncget@jiyin-opensuse-leap-153]:
jiyin-opensuse-leap-153:~ # exit
logout
jiyin-opensuse-leap-153 login: _
$ vm vnc jiyin-opensuse-leap-153 --putln=root --putln=redhat
[vncput@jiyin-opensuse-leap-153]> root key:enter redhat key:enter
$ vm vnc jiyin-opensuse-leap-153 --get
[vncget@jiyin-opensuse-leap-153]:
jiyin-opensuse-leap-153:~ # exit
logout
jiyin-opensuse-leap-153 login: root
Password:
Last login: Fri Apr 29 03:14:03 on tty1
openSUSE Leap 15.3 x86_64 (64-bit)
As "root" use the:
- zypper command for package management
- yast command for configuration management
Have a lot of fun...
jiyin-opensuse-leap-153:~ #
```
**Q:** does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support boot from emulated nvme device?
**A:** yes, it does since [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) v2.3.0, by adding --nvmeboot|--NB option.
BTW: the nvme driver has not been enabled on qemu-kvm in RHEL, it's only enabled on Fedora release.
**Q:** Does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support creating aarch64,s390x Guest on x86_64 host
**A:** Yes, since [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) v2.1.0. and it requires qemu-system-$arch has been installed on your x86_64 linux Host.
now we only verified by creating s390x,aarch64,ppc64le RHEL-8/RHEL-9/c8s/c9s Guest on x86_64 Fedora-35/Fedora-36 Host.
Update: Verified Guest list:
```
vm create --arch aarch64 CentOS-8-stream
vm create --arch ppc64le CentOS-8-stream
vm create --arch s390x CentOS-9-stream
vm create --arch aarch64 CentOS-9-stream
vm create --arch ppc64le CentOS-9-stream
vm create --arch aarch64 fedora-36
vm create --arch aarch64 openSUSE-leap-15.3
vm create --arch aarch64 debian-12
vm create --arch ppc64 debian-12
vm create --arch aarch64 debian-11
vm create --arch ppc64 debian-11
vm create --arch aarch64 FreeBSD-13.1
```
Update\[2023-06-06] now also support creating x86_64 Guest on aarch64 host(Fedora Linux Asahi Remix/M2)
**Q:** What other functions or usages does [kiss-vm](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-vm) support?
**A:** just run: 'vm help' to get more usage/examples info; and there are some useful scirpts under the [utils](https://github.com/tcler/kiss-vm-ns/tree/master/utils) dir.
**Q:** ssh login to VM Guest fail with "Permission denied (publickey,gssapi-keyex,gssapi-with-mic)", why?
**A:** try add **-o "HostKeyAlgorithms ssh-rsa"** option to ssh command; see also **ssh -Q key**, **ssh -Q help**
## [kiss-netns](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-netns)
example: https://github.com/tcler/linux-network-filesystems/blob/master/testcases/nfs/multipath-and-nconnect/main-netns.sh#L26
```
[me@ws ~]$ netns -h #get usage/help info
```
## [kiss-ns](https://github.com/tcler/kiss-vm-ns/blob/master/kiss-ns)
example: https://github.com/tcler/linux-network-filesystems/blob/master/testcases/nfs/multipath-and-nconnect/main-ns.sh#L26
```
[me@ws ~]$ ns -h #get usage/help info
```