Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
github.com/mroote/libretto
Libretto is a Golang library to create Virtual Machines (VM) on any cloud and Virtual Machine hosting platforms such as AWS, Azure, OpenStack, vSphere, or VirtualBox. Different providers have different utilities and API interfaces to achieve that, but the abstractions of their interfaces are quite similar.
go get github.com/apcera/libretto/...
go build ./...
rawKey, err := ioutil.ReadFile(*key)
if err != nil {
return err
}
vm := &aws.VM{
Name: "libretto-aws",
AMI: "ami-984734",
InstanceType: "m4.large",
SSHCreds: ssh.Credentials{
SSHUser: "ubuntu",
SSHPrivateKey: string(rawKey),
},
DeviceName: "/dev/sda1",
Region: "ap-northeast-1",
KeyPair: strings.TrimSuffix(filepath.Base(*key), filepath.Ext(*key)),
SecurityGroup: "sg-9fdsfds",
}
if err := aws.ValidCredentials(vm.Region); err != nil {
return err
}
if err := vm.Provision(); err != nil {
return err
}
vm := &vsphere.VM{
Host: "10.2.1.11",
Username: "username",
Password: "password",
Datacenter: "test-dc",
Datastores: "datastore1, datastore2",
Networks: "network1",
Credentials: ssh.Credentials{
SSHUser: "ubuntu",
SSHPassword: "ubuntu",
},
SkipExisting: true,
DestinationName: "Host1",
DestinationType: "host",
Name: "test-vm",
Template: "test-template",
OvfPath: "/Users/Test/Downloads/file.ovf",
}
if err := vm.Provision(); err != nil {
return err
}
token := os.Getenv("DIGITALOCEAN_API_KEY")
if token == "" {
return fmt.Errorf("Please export your DigitalOcean API key to 'DIGITALOCEAN_API_KEY' and run again.")
}
config := digitalocean.Config{
Name: defaultDropletName,
Region: defaultDropletRegion,
Image: defaultDropletImage,
Size: defaultDropletSize,
}
vm := digitalocean.VM{
ApiToken: token,
Config: config,
}
if err := vm.Provision(); err != nil {
return err
}
var config virtualbox.Config
config.NICs = []virtualbox.NIC{
virtualbox.NIC{Idx: 1, Backing: virtualbox.Bridged, BackingDevice: "en0: Wi-Fi (AirPort)"},
}
vm := virtualbox.VM{Src: "/Users/Admin/vm-bfb21a62-60c5-11e5-9fc5-a45e60e45ad5.ova",
Credentials: ssh.Credentials{
SSHUser: "ubuntu",
SSHPassword: "ubuntu",
},
Config: config,
}
if err := vm.Provision(); err != nil {
return err
}
var config vmrun.Config
config.NICs = []vmrun.NIC{
vmrun.NIC{Idx: 0, Backing: vmrun.Nat, BackingDevice: "en0"},
}
vm := vmrun.VM{Src: "/Users/Admin/vmware_desktop/trusty-orchestrator-dev.vmx",
Dst: "/Users/Admin/Documents/VMs",
Credentials: ssh.Credentials{
SSHUser: "ubuntu",
SSHPassword: "ubuntu",
},
Config: config,
}
if err := vm.Provision(); err != nil {
return err
}
metadata := openstack.NewDefaultImageMetadata()
volume := openstack.NewDefaultVolume()
vm := &openstack.VM{
IdentityEndpoint: os.Getenv("OS_AUTH_URL"),
Username: os.Getenv("OS_USERNAME"),
Password: os.Getenv("OS_PASSWORD"),
Region: os.Getenv("OS_REGION_NAME"),
TenantName: os.Getenv("OS_TENANT_NAME"),
FlavorName: "m1.medium",
ImageID: "",
ImageMetadata: metadata,
ImagePath: os.Getenv("OS_IMAGE_PATH"),
Volume: volume,
InstanceID: "",
Name: "test",
Networks: []string{"eab29109-3363-4b03-8a56-8fe27b71f3a0"},
FloatingIPPool: "net04_ext",
FloatingIP: nil,
SecurityGroup: "test",
Credentials: ssh.Credentials{
SSHUser: "ubuntu",
SSHPassword: "ubuntu",
},
}
err := vm.Provision()
if err != nil {
return err
}
We couldn't find a suitable Golang binding for this functionality, so we created this library. There are a couple of similar libraries but not in golang (fog.io in ruby, jcloud in java, libcloud in python).
Docker Machine is an effort toward that direction, but it is very Docker specific, and its providers dictate the VM images in many cases to reduce the number of parameters, but reduces the flexibility of the tool.
Virtual machine creation and life cycle management as well as common configuration steps during a deploy such as configuring SSH keys.
Actively used and developed. Can be called natively from Go in a Go application instead of shelling out to other tools.
Host to guest OS connectivity is not possible when using NAT networking in Virtualbox. As a result, presently networking configuration for VMs provisioned using the Virtualbox provider is limited to using Bridged networking. There should be a DHCP server running on the network that the VMs are bridged to.
Other Operating Systems might work but have not been tested.
Create a new package inside the virtualmachine
folder and implement the
Libretto VirtualMachine
interface. The provider should work at the minimum on
the Linux, Windows and OS X platforms unless it is a platform specific provider
in which case it should at least compile and return a descriptive error.
Dependencies should be versioned and stored using Godeps
(https://github.com/tools/godep)
Errors should be lower case so that they can be wrapped by the calling code. If
possible, types defined in the top level virtualmachine
package should be
reused.
FAQs
Unknown package
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.