subpop / vm Goto Github PK

5.0 2.0 2.0 118 KB

a command line utility that provides a high-level interface to create and manage virtual machines

License: MIT License

Go 98.12% Makefile 1.88%

libvirt golang management snapshot virsh

vm's Introduction

About

vm is a command line utility that provides a high-level interface to create and manage virtual machines through libvirt.

It supports creation and deletion of domains and snapshots, connecting to serial and SSH terminals, downloading and converting templates from vagrantup.com and builder.libguestfs.org, and importing locally downloading images.

Installation

go get -u github.com/subpop/vm/cmd/vm

Distribution

vm includes a Makefile to aid distributions in packaging. The default target will build vm along with shell completion data and a man page. The Makefile includes an install target to install the binary and data into distribution-appropriate locations. To override the installation directory (commonly referred to as the DESTDIR), set the DESTDIR variable when running the install target:

[link@localhost vm]$ make
go build ./cmd/vm
go run ./cmd/vm --generate-fish-completion > vm.fish
go run ./cmd/vm --generate-bash-completion > vm.bash
go run ./cmd/vm --generate-man-page > vm.1
gzip -k vm.1
[link@localhost vm]$ make DESTDIR=_inst install
install -D -m755 -t _inst//usr/local/bin vm
install -D -m644 -t _inst//usr/local/share/man/man1 vm.1.gz
install -D -m644 -t _inst//usr/local/share/fish/completions vm.fish
install -d _inst//usr/local/share/bash-completion/completions
install -m644 -T vm.bash _inst//usr/local/share/bash-completion/completions/vm
[link@localhost vm]$

Usage

Download a base image:

vm image get https://dl.fedoraproject.org/pub/fedora/linux/releases/31/Cloud/x86_64/images/Fedora-Cloud-Base-31-1.9.x86_64.qcow2

Download and convert a Vagrant ".box":

vm image get https://dl.fedoraproject.org/pub/fedora/linux/releases/31/Cloud/x86_64/images/Fedora-Cloud-Base-Vagrant-31-1.9.x86_64.vagrant-libvirt.box

Create a domain backed by that image:

vm create Fedora-Cloud-Base-31-1.9.x86_64 --name my-f31

Create a domain without defining it:

vm create Fedora-Cloud-Base-31-1.9.x86_64 --transient

List active domains:

vm list

Start a created domain:

vm up my-f31

Connect to an existing domain over SSH:

vm connect -m ssh -u vagrant my-f31 -i ~/.ssh/cloud_user_rsa

Connect to an existing domain over VirtIO PTY:

vm connect -m console my-f31

Take a snapshot:

vm snapshot create my-f31 --name fresh_install

Revert to snapshot:

vm snapshot revert my-f31 --snapshot fresh_install

vm's People

Contributors

Stargazers

Watchers

Forkers

pengzai170 showsmall

vm's Issues

Add domain editing

Similar to virsh edit, but more user friendly (i.e. no editing XML by hand).

Add snapshotting capabilities

Take a snapshot upon creation
Add a quick "reset" option to revert a VM to the creation snapshot

Old VMs (RHEL 6 era) cannot start without a video device

Add option to import an image from a location on disk

For those times when you download a qcow2 image externally and have a copy of it present on disk.

Serial & console connections input line overwriting

Serial & console connections are doing that thing where long input lines don't wrap to the next line, rather they overwrite the current input line. Is this something that readline solves?

Release 0.1

Stuff to do:

generate flags introduce crash when running with unknown subcommand

[link@localhost ~]$ vm foo
panic: runtime error: invalid memory address or nil pointer dereference
[signal SIGSEGV: segmentation violation code=0x1 addr=0x0 pc=0x8ce14a]

goroutine 1 [running]:
main.main.func20(0xc00003aa00, 0x7fff79ad69c4, 0x3)
	/home/link/Projects/vm/cmd/vm/main.go:444 +0x8a
github.com/urfave/cli/v2.(*App).Run(0xc000001b00, 0xc00000e080, 0x2, 0x2, 0x0, 0x0)
	/home/link/go/pkg/mod/github.com/urfave/cli/[email protected]/app.go:304 +0x5f0
main.main()
	/home/link/Projects/vm/cmd/vm/main.go:452 +0x21a2

Add a --no-persist option to create

That destroys the VM automatically when it is powered off.

Running 'vm create' by itself does not report a positional argument error

Running vm create (without a positional image name argument) should report an error about a missing image name, not the underlying stat error that comes back when it tries to look up the file: stat /home/link/.local/share/vm/images/.qcow2: no such file or directory

error: no interfaces detected for domain

When connecting via SSH, the IP detection logic sometimes fails.

[link@thelio ~]$ vm connect -m ssh ic-rhel7-dev
error: no interfaces detected for ic-rhel7-dev
[link@thelio ~]$ vm connect -m ssh ic-rhel7-dev
error: no interfaces detected for ic-rhel7-dev
[link@thelio ~]$ vm connect -m ssh ic-rhel7-dev
error: no interfaces detected for ic-rhel7-dev
[link@thelio ~]$ vm connect -m ssh ic-rhel7-dev
error: no interfaces detected for ic-rhel7-dev
[link@thelio ~]$ vm connect -m ssh ic-rhel7-dev

Check for runtime requirements

There are a handful of external programs that are called at runtime. Their presence should be checked before doing anything.

qemu-img

--memory
--video <type>
--network <bridge_device_name>