README.md
Chef Server API Client Library in Golang
This is a Library that you can use to write tools to interact with the chef server.
Install
go get github.com/go-chef/chef
Test
go get -t github.com/go-chef/chef
go test -v github.com/go-chef/chef
SSL
If you run into an SSL verification problem when trying to connect to a ssl server with self signed certs setup your config object with SkipSSL: true
Usage
This example is setting up a basic client that you can use to interact with all the service endpoints (clients, nodes, cookbooks, etc.) More usage examples can be found in the examples directory.
package main
import (
"encoding/json"
"fmt"
"io/ioutil"
"log"
"os"
"github.com/go-chef/chef"
)
func main() {
// read a client key
key, err := ioutil.ReadFile("key.pem")
if err != nil {
fmt.Println("Couldn't read key.pem:", err)
os.Exit(1)
}
// build a client
client, err := chef.NewClient(&chef.Config{
Name: "foo",
Key: string(key),
// goiardi is on port 4545 by default. chef-zero is 8889
BaseURL: "http://localhost:4545",
})
if err != nil {
fmt.Println("Issue setting up client:", err)
}
// List Cookbooks
cookList, err := client.Cookbooks.List()
if err != nil {
fmt.Println("Issue listing cookbooks:", err)
}
// Print out the list
fmt.Println(cookList)
}
CONTRIBUTING
If you feel like contributing, great! Just fork the repo, make your improvements, and submit a pull request. Tests would, of course, be appreciated. Adding tests where there are no tests currently would be even more appreciated. At least, though, try and not break anything worse than it is. Test coverage has improved, but is still an ongoing concern.
AUTHORS
| Jesse Nelson | @spheromak |
| AJ Christensen | @fujin |
| Brad Beam | @bradbeam |
| Kraig Amador | @bigkraig |
COPYRIGHT
Copyright 2013-2014, Jesse Nelson
LICENSE
Like many Chef ecosystem programs, go-chef/chef is licensed under the Apache 2.0 License. See the LICENSE file for details.
Chef is copyright (c) 2008-2014 Chef, Inc. and its various contributors.
Thanks go out to the fine folks of Opscode and the Chef community for all their hard work.