/go-nitro

A Golang client to the Citrix NetScaler API

Primary LanguageGoApache License 2.0Apache-2.0

An incomplete but mostly useful Go client for configuring Citrix NetScaler

About

The NITRO API is the REST-like API to the Citrix NetScaler. This project provides a Golang SDK that can be used to make configuration API calls to a Citrix NetScaler.

Usage

Import the SDK from github.com/chiradeep/go-nitro/netscaler. Config objects are available at github.com/chiradeep/go-nitro/config. Instantiate a client using NewNitroClient. To initialize the client from environment variables:

export NS_URL=http://<ip-address>
export NS_LOGIN=<netscaler-username>
export NS_PASSWORD=<netscaler-password>

Config object types can be passed in as strings ("lbvserver"), or looked up from netscaler.<config object type>.Type() The general pattern for NetScaler config objects is some combination of AddResource, UpdateResource, BindResource, UnbindResource and DeleteResource. See the NITRO REST docs for more information.

Example

package main

import (
        "github.com/chiradeep/go-nitro/config/lb"
        "github.com/chiradeep/go-nitro/netscaler"
)

function main() {
        client, _ := netscaler.NewNitroClientFromEnv()
        lb1 := lb.Lbvserver{
                Name:        "sample_lb",
                Ipv46:       "10.71.136.50",
                Lbmethod:    "ROUNDROBIN",
                Servicetype: "HTTP",
                Port:        8000,
        }
        result, err := client.AddResource(netscaler.Lbvserver.Type(), "sample_lb", &lb1)
        if err == nil {
            client.SaveConfig()
        }
}

Building

The structs for the config objects under config/ are generated from JSON declarations in jsonconfig. The JSON itself is generated by reverse engineering the official NITRO Java SDK (see https://github.com/chiradeep/json-nitro). To build the SDK, use make build. To regenerate the Go structs from JSON, use make generate

Unit Tests

The unit tests are invoked with make unit. Note that they are actually functional tests and need a running NetScaler. The tests also need the environment variables NS_URL, NS_LOGIN and NS_PASSWORD to be set.

TODO

Some REST operations are not yet supported:

Stats

No plan to support the stats API (http://<netscaler-ip-address>/nitro/v1/stat/<resource-type>) `