Review/extend DEVELOPMENT documentation

[dholbach]

Each of the controllers should have clear guidelines on how to build and run the
projects. This includes the sections:
○ How to install dependencies
○ How to install the controller
○ How to run the test suite locally
○ How to run the controller locally

Some of the information might already be there - let's double-check it's up to date and accurate.

[dholbach]

Please note this file has moved to https://github.com/fluxcd/helm-controller/blob/main/DEVELOPMENT.md now

[dholbach]

This issue might be well-suited for new contributors. Basically the ask is: if you have a fairly clean installation of whatever your OS is: let us know if the instructions in the file above were everything that's needed to get you going on the individual tasks. Please report back if you ran into issues and the docs should be clearer (or make a PR!). Thanks a lot in advance!

[cebernardi]

Hi all!
I was recently trying to set up the project and run the tests (MacOS environment) and I noticed that:

• tests fail to run if one doesn't have kubebuilder-tools installed (unable to start control plane itself: failed to start the controlplane. retried 5 times: fork/exec /usr/local/kubebuilder/bin/etcd: no such file or directory); I see that there is already a possibly related open issue
• version 0.5.0+ of controller-gen should be enforced (

  helm-controller/Makefile

  Line 108 in fd79fac

  go get sigs.k8s.io/controller-tools/cmd/controller-gen@v0.5.0 ;\

  ); I had 0.4.0 and the Makefile target did not download a new version, so I run into the controller-gen bug where negative values are generated as strings (here the bug and here the bit that was failing for me)

I see that the new projects generated with kubeebuilder adopt a different approach and download both controller-gen and test-env into a local folder, so only the project scope is affected.

If there is consensus I could adapt the Makefile to this approach as well.

Otherwise, I could just add some lines to the DEVELOPMENT.md where I list the above as manual steps.