Repository files navigation

go-qemu is a collection of Go packages for interacting with running QEMUinstances. Apache 2.0 Licensed.

Feel free to join us in#go-qemu on libera chatif you'd like to discuss the project.

Usego get to retrieve all of the packages ingo-qemu:

$ go get github.com/digitalocean/go-qemu/...

Here is a quick overview of each top-level package, and what they can be used for:

• hypervisor: Package hypervisor provides management facilities for one ormore QEMU virtual machines on a hypervisor.
  • Provides easier access for managing groups of VMs than theqemu package.
  • Provides access to individualqemu.Domain types.
• qemu: Package qemu provides an interface for interacting with running QEMU instances.
  • Typically used for managing a single VM.
  • Good for quick experiments.
• qmp: Package qmp enables interaction with QEMU instances via the QEMU MachineProtocol (QMP).
  • Typically not used by consumers outside of this repository.
  • Wraps code-generated types with friendlier APIs.

Packageqemu is used in production at DigitalOcean, alongside packagelibvirt. This being said, it ispossible that there may still be subtle bugs which could cause the packages to actin unexpected ways.

If you encounter any problems, pleaselook at the open issuesand if your problem does not match any of the ones listed, file a new issue with asmuch detail as you are willing to provide.

The API is not considered stable at this time. We do not anticipate making majorchanges to the API, but it is possible that the API may change over time, if deemednecessary by the project maintainers. If you would like to include packageqemu in a project, we highly recommend vendoring it into your project.