t13a/libvirt repository overview

⁠Libvirt container

A containerized Libvirt⁠, disposable virtualization infrastructure intended for development. Do not use for production.

• Based on the official image of CentOS 7⁠
• Use Supervisor⁠ instead of Systemd⁠
• Use KVM⁠ if available
• Connect via SSH

⁠Getting started

⁠Prerequisites

• Bash
• Docker Compose
• GNU Make
• OpenSSH

⁠Setup

Currently, SSH is the only way to communicate with the container. Public key authentication and password authentication are available. By default, the valid public key is assumed to be in ~/.ssh/id_rsa.pub. If so, setup the container is very easy.

$ make all up # equivalent to `make build up`

To specify another location, override SSH_AUTHORIZED_KEYS environment variable.

$ make SSH_AUTHORIZED_KEYS="$(cat path/to/public-key)" all up

If you don't have or wan't to use your public key, You can disable public key authentication and enable password authentication.

$ make LIBVIRT_USER_PASSWORD='password' SSH_AUTHORIZED_KEYS='' all up

⁠Connect to Libvirt

There are several ways to connect to Libvirt. The simplest way is to login via SSH and run virsh (Libvirt management CLI).

$ ssh -p 2222 [email protected] virsh --connect=qemu:///system

Or, if virsh is installed on your computer, the following command is equivalent to the above.

$ virsh --connect=qemu+ssh://[email protected]:2222/system

⁠Teardown

To stop the container, execute the following command.

$ make down

You can return to the previous state by executing make up command again.

To erase everything including Docker image and volumes, execute the following command.

$ make clean

⁠Development

⁠E2E Test

We will actually provision an Ubuntu 16.04 LTS (Xenial Xerus)⁠ instance and login via SSH.

$ make test