Developing for KubeSphere

The community repository hosts all information about building KubeSphere from source, how to contribute code and documentation, who to contact about what, etc. If you find a requirement that this doc does not capture, or if you find other docs with references to requirements that are not simply links to this doc, please submit an issue.

To start developing KubeSphere

First of all, you should fork the project. Then follow one of the three options below to develop the project. Please note you should replace the official repo when using go get or git clone below with your own one.

You need to install Docker first.

$ git clone https://github.com/kubesphere/kubesphere
$ cd kubesphere
$ make build
$ make compose-up

Exit docker runtime environment

$ make compose-down

2. You have a working Docker environment.

Exit docker runtime environment

$ docker stop $(docker ps -f name=kubesphere -q)

3. You have a working Go environment.

Install protoc compiler
Install protoc plugin:

$ go get github.com/golang/protobuf/protoc-gen-go
$ go get github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway
$ go get github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger
$ go get github.com/mwitkow/go-proto-validators/protoc-gen-govalidators

Get kubesphere source code and build service:

$ go get -d kubesphere.io/kubesphere
$ cd $GOPATH/src/kubesphere.io/kubesphere
$ make generate
$ GOBIN=`pwd`/bin go install ./cmd/...

Start KubeSphere service:
Exit go runtime environment

$ ps aux | grep kubesphere- | grep -v grep | awk '{print $2}' | xargs kill -9

Test KubeSphere

Visit http://127.0.0.1:9100/swagger-ui in browser, and try it online, or test kubesphere api service via command line:

DevOps

Please check How to set up DevOps environment.

2.3 KiB Raw Blame History