digitalocean/ go-qemu
Need help with go-qemu?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
About the developer
477 Stars 
66 Forks 
Other 
238 Commits 
15 Opened issues 
Description
Go packages to interact with QEMU using the QEMU Machine Protocol (QMP). Apache 2.0 Licensed.
Services available
Contributors list
Readme
go-qemu 
go-qemuis a collection of Go packages for interacting with running QEMU instances. Apache 2.0 Licensed.
#go-qemuon freenode if you'd like to discuss the project.
Installation
Use
go getto retrieve all of the packages in
go-qemu:
$ go get github.com/digitalocean/go-qemu/...
Overview
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 or more QEMU virtual machines on a hypervisor.- Provides easier access for managing groups of VMs than the
qemu
package. - Provides access to individual
qemu.Domain
types.
- Provides easier access for managing groups of VMs than the
-
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 Machine Protocol (QMP).- Typically not used by consumers outside of this repository.
- Wraps code-generated types with friendlier APIs.
Details
Package
qemuis used in production at DigitalOcean, alongside package
libvirt. This being said, it is possible that there may still be subtle bugs which could cause the packages to act in unexpected ways.
If you encounter any problems, please look at the open issues and if your problem does not match any of the ones listed, file a new issue with as much detail as you are willing to provide.
The API is not considered stable at this time. We do not anticipate making major changes to the API, but it is possible that the API may change over time, if deemed necessary by the project maintainers. If you would like to include package
qemuin a project, we highly recommend vendoring it into your project.