gosdc is a Go client for Joyent's SmartDataCenter
Table of Contents
To create a client
(*cloudapi.Client),
you'll need a few things:
- your account ID
- the ID of the key associated with your account
- your private key material
- the cloud endpoint you want to use (for example
https://us-east-1.api.joyentcloud.com)
Given these four pieces of information, you can initialize a client with the following:
package main
import (
"io/ioutil"
"log"
"os"
"github.com/joyent/gocommon/client"
"github.com/joyent/gosdc/cloudapi"
"github.com/joyent/gosign/auth"
)
func client(key, keyId, account, endpoint string) (*cloudapi.Client, error) {
keyData, err := ioutil.ReadFile(key)
if err != nil {
return nil, err
}
userAuth, err := auth.NewAuth(account, string(keyData), "rsa-sha256")
if err != nil {
return nil, err
}
creds := &auth.Credentials{
UserAuthentication: auth,
SdcKeyId: keyId,
SdcEndpoint: auth.Endpoint{URL: endpoint},
}
return cloudapi.New(client.NewClient(
creds.SdcEndpoint.URL,
cloudapi.DefaultAPIVersion,
creds,
log.New(os.Stderr, "", log.LstdFlags),
)), nil
}Projects using the gosdc API:
After creating a client, you can manipulate resources in the following ways:
Report bugs and request features using GitHub Issues, or contribute code via a GitHub Pull Request. Changes will be code reviewed before merging. In the near future, automated tests will be run, but in the meantime please go fmt, go lint, and test all contributions.
This library assumes a Go development environment setup based on How to Write Go Code. Your GOPATH environment variable should be pointed at your workspace directory.
You can now use go get github.com/joyent/gosdc to install the repository to the correct location, but if you are intending on contributing back a change you may want to consider cloning the repository via git yourself. This way you can have a single source tree for all Joyent Go projects with each repo having two remotes -- your own fork on GitHub and the upstream origin.
For example if your GOPATH is ~/src/joyent/go and you're working on multiple repos then that directory tree might look like:
~/src/joyent/go/
|_ pkg/
|_ src/
|_ github.com
|_ joyent
|_ gocommon
|_ gomanta
|_ gosdc
|_ gosign
$ mkdir -p ${GOPATH}/src/github.com/joyent
$ cd ${GOPATH}/src/github.com/joyent
$ git clone [email protected]:<yourname>/gosdc.git
# fetch dependencies
$ git clone [email protected]:<yourname>/gocommon.git
$ git clone [email protected]:<yourname>/gosign.git
$ go get -v -t ./...
# add upstream remote
$ cd gosdc
$ git remote add upstream [email protected]:joyent/gosdc.git
$ git remote -v
origin [email protected]:<yourname>/gosdc.git (fetch)
origin [email protected]:<yourname>/gosdc.git (push)
upstream [email protected]:joyent/gosdc.git (fetch)
upstream [email protected]:joyent/gosdc.git (push)
You can run the tests either locally or against live Triton. If you want to run the tests locally you'll want to generate an SSH key and pass the appropriate flags to the test harness as shown below.
cd ${GOPATH}/src/github.com/joyent/gosdc
ssh-keygen -b 2048 -C "Testing Key" -f test_key.id_rsa -t rsa -P ""
env KEY_NAME=`pwd`/test_key.id_rsa LIVE=false go test ./...
cd ${GOPATH}/src/github.com/joyent/gosdc
go build ./...
gosdc is licensed under the Mozilla Public License Version 2.0, a copy of which is available at LICENSE