GreenNode Community SDK

A community Go SDK for GreenNode cloud services.

Installation

go get danny.vn/greennode

Quick Start

Service account (client credentials)

package main

import (
  "context"
  "fmt"

  "danny.vn/greennode"
  lbv2 "danny.vn/greennode/services/loadbalancer/v2"
)

func main() {
  c, err := greennode.NewClient(context.Background(), greennode.Config{
    Region:       "hcm-3",
    ClientID:     "__YOUR_CLIENT_ID__",
    ClientSecret: "__YOUR_CLIENT_SECRET__",
    ProjectID:    "__YOUR_PROJECT_ID__",
  })
  if err != nil {
    panic(err)
  }

  packages, err := c.LoadBalancer.ListLoadBalancerPackages(
    context.Background(), lbv2.NewListLoadBalancerPackagesRequest())
  if err != nil {
    panic(err)
  }

  for _, pkg := range packages.Items {
    fmt.Printf("Package: %+v\n", pkg)
  }
}

IAM user (username/password + optional TOTP)

package main

import (
  "context"

  "danny.vn/greennode"
  "danny.vn/greennode/auth"
)

func main() {
  c, err := greennode.NewClient(context.Background(), greennode.Config{
    Region:    "hcm-3",
    ProjectID: "__YOUR_PROJECT_ID__",
    IAMAuth: &auth.IAMUserAuth{
      RootEmail: "root@company.com",
      Username:  "your-username",
      Password:  "your-password",
      TOTP:      &auth.SecretTOTP{Secret: "YOUR_BASE32_SECRET"}, // omit if no 2FA
    },
  })
  if err != nil {
    panic(err)
  }

  // Use c.Compute, c.LoadBalancer, etc. as normal
  _ = c
}

The Region field (e.g. "hcm-3", "han-1") derives all endpoint URLs automatically. Explicit endpoint fields (e.g. VServerEndpoint) override the defaults if set.

Custom HTTP client

Use option.WithHTTPClient to inject a custom *http.Client — useful for rate limiting, tracing, or proxies:

import (
  "net/http"

  "danny.vn/greennode"
  "danny.vn/greennode/option"
)

httpClient := &http.Client{
  Transport: myRateLimitedTransport,
}

c, err := greennode.NewClient(ctx, greennode.Config{...},
  option.WithHTTPClient(httpClient),
)

Other options:

Option	Description
option.WithHTTPClient(c)	Replace the underlying *http.Client
option.WithTransport(t)	Set a custom http.RoundTripper on the default client
option.WithUserAgent(ua)	Override the User-Agent header

TOTP providers

Provider	Usage
&auth.SecretTOTP{Secret: "..."}	Compute TOTP from a base32 shared secret
auth.TOTPFunc(func(ctx) (string, error) { ... })	Bring your own source (Vault, env var, CLI prompt)
nil	No 2FA required

Services

Service	Description
Compute	Server lifecycle, floating IPs, server groups
Volume	Block volumes, snapshots, volume types
Network	VPCs, subnets, security groups, endpoints
Load Balancer	Load balancers, listeners, pools, certificates
GLB	Global load balancer pools, listeners
DNS	Hosted zones, DNS records
Identity	OAuth2 token acquisition
Portal	Portal info, project listing

See docs/architecture.md for the full architecture overview.

Documentation

• Architecture — layered design, request lifecycle, error handling
• API Coverage — what the SDK supports vs. what GreenNode exposes
• Test Coverage — coverage map and improvement plan

Contributing

Contributions are welcome. Please open an issue or submit a pull request.