bbbe67bf7c
* Vendors packages * Adds a Makefile that uses docker to build a static binary against musl using alpine linux. Signed-off-by: Gabriel Adrian Samfira <gsamfira@cloudbasesolutions.com>
146 lines
3.1 KiB
Go
146 lines
3.1 KiB
Go
// Package lxd implements a client for the LXD API
|
|
//
|
|
// # Overview
|
|
//
|
|
// This package lets you connect to LXD daemons or SimpleStream image
|
|
// servers over a Unix socket or HTTPs. You can then interact with those
|
|
// remote servers, creating instances, images, moving them around, ...
|
|
//
|
|
// # Example - instance creation
|
|
//
|
|
// This creates a container on a local LXD daemon and then starts it.
|
|
//
|
|
// // Connect to LXD over the Unix socket
|
|
// c, err := lxd.ConnectLXDUnix("", nil)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Instance creation request
|
|
// req := api.InstancesPost{
|
|
// Name: "my-container",
|
|
// Source: api.InstanceSource{
|
|
// Type: "image",
|
|
// Alias: "my-image",
|
|
// },
|
|
// Type: "container"
|
|
// }
|
|
//
|
|
// // Get LXD to create the instance (background operation)
|
|
// op, err := c.CreateInstance(req)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Wait for the operation to complete
|
|
// err = op.Wait()
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Get LXD to start the instance (background operation)
|
|
// reqState := api.InstanceStatePut{
|
|
// Action: "start",
|
|
// Timeout: -1,
|
|
// }
|
|
//
|
|
// op, err = c.UpdateInstanceState(name, reqState, "")
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Wait for the operation to complete
|
|
// err = op.Wait()
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// # Example - command execution
|
|
//
|
|
// This executes an interactive bash terminal
|
|
//
|
|
// // Connect to LXD over the Unix socket
|
|
// c, err := lxd.ConnectLXDUnix("", nil)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Setup the exec request
|
|
// req := api.InstanceExecPost{
|
|
// Command: []string{"bash"},
|
|
// WaitForWS: true,
|
|
// Interactive: true,
|
|
// Width: 80,
|
|
// Height: 15,
|
|
// }
|
|
//
|
|
// // Setup the exec arguments (fds)
|
|
// args := lxd.InstanceExecArgs{
|
|
// Stdin: os.Stdin,
|
|
// Stdout: os.Stdout,
|
|
// Stderr: os.Stderr,
|
|
// }
|
|
//
|
|
// // Setup the terminal (set to raw mode)
|
|
// if req.Interactive {
|
|
// cfd := int(syscall.Stdin)
|
|
// oldttystate, err := termios.MakeRaw(cfd)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// defer termios.Restore(cfd, oldttystate)
|
|
// }
|
|
//
|
|
// // Get the current state
|
|
// op, err := c.ExecInstance("c1", req, &args)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Wait for it to complete
|
|
// err = op.Wait()
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// # Example - image copy
|
|
//
|
|
// This copies an image from a simplestreams server to a local LXD daemon
|
|
//
|
|
// // Connect to LXD over the Unix socket
|
|
// c, err := lxd.ConnectLXDUnix("", nil)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Connect to the remote SimpleStreams server
|
|
// d, err = lxd.ConnectSimpleStreams("https://images.linuxcontainers.org", nil)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Resolve the alias
|
|
// alias, _, err := d.GetImageAlias("centos/7")
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Get the image information
|
|
// image, _, err := d.GetImage(alias.Target)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // Ask LXD to copy the image from the remote server
|
|
// op, err := d.CopyImage(*image, c, nil)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
//
|
|
// // And wait for it to finish
|
|
// err = op.Wait()
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
package lxd
|