stargate-vmagent

nodejs REST server / API for managing libvirt-based Virtual Machines

This is intended as a small-footprint "agent" for providing some basic management functions for Virtual Machines implemented behind the libvirt API (such as qemu). It's not intended as a full-fledged API like libvirt.

The initial list of functions to be supported are:

• Power cycle VM
• Set a temporary graphics (spice/vnc) password

Configure agent

Edit config/config.js

Permission agent to access libvirt API

For example this in /etc/polkit-1/rules.d/80-libvirt.rules:

polkit.addRule(function(action, subject) {
  if (action.id == "org.libvirt.unix.manage" && subject.local && subject.active && subject.user == "xyz") {
      return polkit.Result.YES;
  }
});

Generate a self-signed key/cert

openssl req -x509 -sha256 -nodes -days 1826 -newkey rsa:2048 -keyout NEW_SERVER_KEY.key -out NEW_SERVER_CERT.crt

Then edit config/config.js and indicate the location of the key and cert just created.

Extract Keytab and Set Environment Variable

Each time before running the agent:

export KRB5_KTNAME=/path/to/keytab