96 lines
3.0 KiB
Markdown
96 lines
3.0 KiB
Markdown
[](https://waffle.io/go-chef/chef)
|
|
[](https://app.wercker.com/project/bykey/9cfd4b53ea24e0894904067f283e4cf8)
|
|
[](https://coveralls.io/r/go-chef/chef?branch=master)
|
|
|
|
# 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](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](https://github.com/spheromak)
|
|
|AJ Christensen |[@fujin](https://github.com/fujin)
|
|
|Brad Beam |[@bradbeam](https://github.com/bradbeam)
|
|
|Kraig Amador |[@bigkraig](https://github.com/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.
|