nutanix-go-sdk

Go Client SDK for various Nutanix APIs. Currently, only Karbon is fully supported but additional APIs are being added.

This client API SDK for Go is based upon the Google, Github Go client SDK found here: https://github.com/google/go-github

Currently, this is an alpha development release of the client library that is a work in progress.

Current APIs and status:

Karbon - implemented.

Documentation available KARBON

Prism Central (v3 API) - partial implementation

Documentation available PrismCentral

Prism Element (v2 API) - unimplemented

Documentation available PrismElement

Calm - no support currently

Documentation available Calm

Era - no support currently

Examples

A basic example is included below but additional examples are available in the examples folder

The following example will both print out the KubeConfig for the cluster name identified but also write it to a file for use.

func main() {
	httpClient := &http.Client{Transport: &http.Transport{
		TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
	}}

	con, err := nutanix.NewClient(httpClient, &nutanix.Config{Karbon: new(karbon.ServiceConfig)})
	if err != nil {
		panic(err)
	}

	cKubeRequest := &karbon.ClusterGetKubeConfigRequest{ClusterName: "cluster-name-01"}

	getRes, _, err := con.Karbon.Cluster.GetKubeConfig(cKubeRequest)
	if err != nil {
		fmt.Println("kubeconfig get error: ", err)
		return
	}

	fmt.Println(getRes.KubeConfig)

	err = ioutil.WriteFile("/tmp/kube.txt", []byte(getRes.KubeConfig), 0644)
	if err != nil {
		fmt.Println("error writing to file: ", err)
		os.Exit(1)
	}
}

The following example will list Nutanix clusters registered with the current Prism Central using the skip SSL verify in the main configuration without passing in an HTTP client.

package main

import (
	"encoding/json"
	"fmt"

	nutanix "github.com/routebyintuition/ntnx-go-sdk"
	"github.com/routebyintuition/ntnx-go-sdk/pc"
)

func main() {

	nconf := &nutanix.Config{
		PrismCentral:       new(pc.ServiceConfig),
		InsecureSkipVerify: true,
	}

	con, err := nutanix.NewClient(nil, nconf)
	if err != nil {
		fmt.Println("error on NewClient: ", err)
		return
	}

	cListRequest := new(pc.ClusterListRequest)
	fmt.Println("performing new list request")
	listRes, _, err := con.PC.Cluster.List(cListRequest)
	if err != nil {
		fmt.Println("cluster list error: ", err)
		return
	}

	out, _ := json.MarshalIndent(listRes, "", "  ")
	fmt.Println(string(out))
}

Configuration

It is NOT RECOMMENDED to hardcode connection and authentication information directly in the code. While this can be done, environmental variables are recommended. The environmental variable list used for the API are below:

Environmental Variables

Setting environmental variables is optional but recommended over hard-coded values.

Karbon API

• NUTANIX_KARBON_USER = Nutanix Karbon username
• NUTANIX_KARBON_PASS = Nutanix Karbon password
• NUTANIX_KARBON_URL = Nutanix Karbon URL (e.g. export NUTANIX_KARBON_URL="https://10.0.0.10:9440/karbon/")

Prism Central API

• NUTANIX_PC_USER = Nutanix Prism Central username
• NUTANIX_PC_PASS = Nutanix Prism Central password
• NUTANIX_PC_URL = Nutanix Prism Central URL (e.g. export NUTANIX_PC_URL="https://10.0.0.10:9440/api/nutanix/v3/")

Prism Element API

• NUTANIX_PE_USER = Nutanix Prism Element username
• NUTANIX_PE_PASS = Nutanix Prism Element password
• NUTANIX_PE_URL = Nutanix Prism Element URL (e.g. export NUTANIX_PC_URL="https://10.0.0.11:9440/api/nutanix/v2/")

Calm API

This segment is not yet implemented.

Manually setting credentials and configurations

Not recommended! You may end up checking your credentials into a source repository. Use this for testing only!

Credentials are set at a service level such that a single initialize of the client can have different credentials/endpoints for karbon, pc, pe, and calm. Examples can be found below:

Karbon with credentials

	karbonConfig := &karbon.ServiceConfig{
		User: nutanix.String("username"),
		Pass: nutanix.String("password"),
		URL:  nutanix.String("https://0.0.0.0:9440/karbon"),
	}
	ntnx, err := nutanix.NewClient(httpClient, &nutanix.Config{Karbon: karbonConfig})
	if err != nil {
		panic(err)
	}

All services with credentials

	karbonConfig := &karbon.ServiceConfig{
		User: nutanix.String("username"),
		Pass: nutanix.String("password"),
		URL:  nutanix.String("https://0.0.0.0:9440/karbon"),
	}
	peConfig := &pe.ServiceConfig{
		User: nutanix.String("username"),
		Pass: nutanix.String("password"),
		URL:  nutanix.String("https://0.0.0.0:9440/api/nutanix/v2/"),
	}
	pcConfig := &pc.ServiceConfig{
		User: nutanix.String("username"),
		Pass: nutanix.String("password"),
		URL:  nutanix.String("https://0.0.0.0:9440/api/nutanix/v3/"),
	}

	ntnxConfig := &nutanix.Config{
		Karbon:       karbonConfig,
		PrismElement: peConfig,
		PrismCentral: pcConfig,
	}

	ntnx, err := nutanix.NewClient(httpClient, ntnxConfig)
	if err != nil {
		panic(err)
	}

Initialization

We initialize our service clients by providing struct configs for each service we wish to use. Only services that have a struct config will be initialized. In the example below we have initalized karbon, prism central, and prism element. Since the structs are empty, the library will look to the environmental variables for configuration.

	ntnxEnvConfig := &nutanix.Config{
		Karbon:       &karbon.ServiceConfig{},
		PrismCentral: &pc.ServiceConfig{},
		PrismElement: &pe.ServiceConfig{},
	}
	ntnx, err := nutanix.NewClient(httpClient, ntnxEnvConfig)
	if err != nil {
		panic(err)
	}

Initialize just the Karbon API

This example will only initialize the karbon library and will rely upon environmental variables for configuration.

	ntnx, err := nutanix.NewClient(httpClient, &nutanix.Config{Karbon: new(karbon.ServiceConfig)})
	if err != nil {
		panic(err)
	}