Skip to content

Latest commit

 

History

History
86 lines (57 loc) · 3.86 KB

CONTRIBUTING.md

File metadata and controls

86 lines (57 loc) · 3.86 KB

Contributing guidelines

Sign the CLA

Kubernetes projects require that you sign a Contributor License Agreement (CLA) before we can accept your pull requests.

Please see https://git.k8s.io/community/CLA.md for more info.

Prerequisites

  • go version v1.13+.
  • dep dep v0.5+
  • docker version 17.03+.
  • kubectl version v1.11.3+.
  • kustomize v3.1.0+
  • Access to a Kubernetes v1.11.3+ cluster.

Contributing steps

  1. Submit an issue describing your proposed change to the repo in question.
  2. The repo owners will respond to your issue promptly.
  3. If your proposed change is accepted, and you haven't already done so, sign a Contributor License Agreement (see details above).
  4. Fork the desired repo, develop and test your code changes.
  5. Submit a pull request.

How to build kubebuilder locally

  1. Run the following command to clone your fork of the project locally in the dir /src/sigs.k8s.io/kubebuilder
$ git clone [email protected]:<user>/kubebuilder.git $GOPATH/src/sigs.k8s.io/kubebuilder
  1. Ensure you activate module support before continue ($ export GO111MODULE=on)
  2. Build the project by using the command make build
  3. Run the command make install to create a bin with the source code

How to test kubebuilder locally

  1. Run the tests by using the command make test. It will execute unit tests.
  2. Run the script make generate to update/generate the mock data used in the e2e test in $GOPATH/src/sigs.k8s.io/kubebuilder/testdata/

IMPORTANT: The make generate is very helpful. By using it, you can check if good part of the commands still working successfully after the changes. Also, note that its usage is a pre-requirement to submit a PR.

NOTE To run make lint is required to install golangci-lint locally it. More info: https://github.com/golangci/golangci-lint#install

Where the CI Tests are configured?

  1. See the Travis file to check its tests and the scripts used on it.
  2. Note that the prow tests used in the CI are configured in kubernetes-sigs/kubebuilder/kubebuilder-presubmits.yaml.
  3. Check that all scripts used by the CI are defined in the project.

How to contribute to docs

We currently have 2 production branches, book-v2 and book-v1. book-v2 maps to book.kubebuilder.io which contains our latest released features, while book-v1 maps to book-v1.book.kubebuilder.io, which contains our legacy docs for kubebuilder V1.

Docs for unreleased features live in the master branch. We merge the master branch into the book-v2 branch when doing the releases.

If adding doc for an unreleased feature, the PR should target master branch. If updating existing docs, the PR should target master branch and then cherry-picked into book-v2 branch.

How to preview the changes performed in the docs?

Check the CI job after to do the Pull Request and then, click on in the Details of netlify/kubebuilder/deploy-preview

Community, discussion and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Becoming a reviewer or approver

Contributors may eventually become official reviewers or approvers in KubeBuilder and the related repositories. See CONTRIBUTING-ROLES.md for more information.

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.