Contributing
Last updated: February 18, 2019
Reading time: 1 minutes
Contributing
We are delighted you want to contribute to this project! Keep in mind that any contribution to this project MUST adhere to the Contributor Covenant Code of Conduct.
Here’s a short check list to help you contribute to this project:
- check the issue queue and PR queue to make sure you’re not duplicating any developer’s work.
- if there is an existing issue, please comment on it before starting to work on the implementation - if there isn’t one, please create it.
- fork the project.
- follow the instructions below to make sure you have all required prerequisites to build the project.
- create a pull request with your changes.
Any contribution is extremely appreciated - documentation, bug fixes or features. Thank you!
Prerequisites
- the Go toolchain
dep
make
(optional)
Building from source
dep ensure
make build
to build the librarymake examples
to build all examples inexamples/
- if running locally, you should provide an environment variable for the Kubernetes configuration file:
- on Linux (including Windows Subsystem for Linux) and macOS:
export KUBECONFIG=<path-to-config>
- on Windows:
$env:KUBECONFIG="<path-to-config>"
- on Linux (including Windows Subsystem for Linux) and macOS:
- alternatively, you can individually
go run
the desired example locally, provided you pass a valid Kubernetes config file