go-tutum

Go library for Tutum's API. Full documentation available at https://docs.tutum.co/v2/api/?golang

##Set up

Installation:

In order to install the Tutum Go library, you can use :

go get github.com/tutumcloud/go-tutum/tutum

Auth:

In order to be able to make requests to the API, you should first obtain an ApiKey for your account. For this, log into Tutum, click on the menu on the upper right corner of the screen and select Get Api Key.

You can use your ApiKey with the Go library in any of the following ways:

Manually set in your Go code

tutum.User = "yourUsernameHere"
tutum.ApiKey = "yourApiKeyHere"

Store in a config file in ~/.tutum

[auth]
user = "username"
apikey = "apikey"

Set the environment variables TUTUM_USER and TUTUM_APIKEY

##Examples

Note

Each of the methods that require a uuid number as argument can also use a resource_uri as argument.

Creating and deploying a NodeCluster

nodecluster, err := tutum.CreateNodeCluster(tutum.NodeCreateRequest{Name: "Go-SDK-test", Region: "/api/v1/region/digitalocean/lon1/", NodeType: "/api/v1/nodetype/digitalocean/1gb/", Target_num_nodes: 2})

if err != nil {
  log.Println(err)
}

if err = nodecluster.Deploy(); err != nil {
   log.Println(err)
}

Creating and starting a Stack

stack, err := tutum.CreateStack(tutum.StackCreateRequest{Name: "new-stack", Services: []tutum.ServiceCreateRequest{{Image: "tutum/hello-world", Name: "test", Target_num_containers: 2}}})

if err != nil {
  log.Println(err)
}

if err = stack.Start(); err != nil {
   log.Println(err)
}

Listing running containers

containers, err := tutum.ListContainers()

if err != nil {
	log.Println(err)
}

log.Println(containers)

Stopping a running service

service, err := tutum.GetService("7eaf7fff-882c-4f3d-9a8f-a22317ac00ce")
// or service, err := tutum.GetService("/api/v1/service/7eaf7fff-882c-4f3d-9a8f-a22317ac00ce")


if err != nil {
	log.Println(err)
}

if err = service.Stop(); err != nil {
   log.Println(err)
}

Events

In order to handle events, you can call the TutumEvents function inside a goroutine.

tutum.StreamUrl = "wss://stream.tutum.co:443/v1/"

c := make(chan tutum.Event)
e := make(chan error)
go tutum.TutumEvents(c, e)

for {
	select {
		case event := <-c:
			log.Println(event)
		case err := <-e:
			log.Println(err)
	}
}

The complete API Documentation is available here with additional examples written in Go.