go-tutum

KO | EN

gitlite — search

#javascript #hacktoberfest #typescript #llm #android #rust #deep-learning #docker #nodejs #java #awesome-list #pytorch #openai #open-source

(★ 20)

Go Library for Tutum

go-tutum Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

go-tutum
========

Go library for Tutum's API. Full documentation available at [https://docs.tutum.co/v2/api/?golang](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](https://docs.tutum.co/v2/api/) with additional examples written in Go.

go-tutum

go-tutum Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

go-tutum

go-tutum Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README