Repository files navigation

This repo hosts an experimental Golang client library generated usingswagger-codegen andKubernetes OpenAPI spec. Currently the client capability meets the Bronze Requirement and is supported in Alpha state, as described inKubernetes: New Client Library Procedure. For more advanced functionality (e.g. controller and shared informer), please refer to the more mature KubernetesGo client.

Get the source:

cd $GOPATH/src/k8s.iogit clone --recursive https://github.com/kubernetes-client/go.git clientcd client

NOTE ongo get:

Currently this repo is still under experimental state and the domains haven't been set up forgo get yet. Please get the library from source.

Please seehttps://github.com/kubernetes-client/go/tree/master/examples forbasic examples of using this client library.

All APIs and Models' documentation can be found at theGenerated client's README file

This client library followssemver, so until the major version ofclient gets increased, your code will continue to work with explicitlysupported versions of Kubernetes clusters.

Key:

• ✓ Exactly the same features / API objects in both Go client and the Kubernetesversion.
• + Go client has features or api objects that may not be present in theKubernetes cluster, but everything they have in common will work.
• - The Kubernetes cluster has features the Go client library can't use(additional API objects, etc).

Check outhttps://github.com/kubernetes-client/gen into${GEN_DIR}.

Assume thathttps://github.com/kubernetes-client/go is in${GO_DIR}.

cd${GO_DIR}/kubernetes${GEN_DIR}/openapi/go.sh ./ ./settings

Please seeCONTRIBUTING.md for instructions on how to contribute.