1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/kubesphere-ks-devops

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
CONTRIBUTING.md 3.5 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Rick Отправлено 19.08.2022 11:07 5c830fe

Welcome to go through the contribution guide!

Prepare yourself

Before you get started to contribute. Please the following requirements:

Technical area Level requires Links
Golang Skilled Youtube tutorial for beginner
GitHub Skilled Official learning lab
Kubernetes Basic development skills Official document
Kustomize Basic development skills Official document
Helm chart Basic development skills Official document
Docker Skilled Official document
Jenkins Familiar [optional] Official website, Tutorial in Chinese

Run it locally

Technically, apiserver and controller are all binary files. So, it's possible to run them in your local environment. You just need to make sure that the connection between your environment and a Kubernetes cluster works well. This is a default config file of these components, please see also the sample file.

Development locally

  • Run kind in local or remote machine
  • Make sure that you can access cluster via kubectl command in local machine
  • Execute the following command to install our CRDs:
make install
  • Copy config/samples/kubesphere.yaml to root directory of the repository.
  • Before starting the APIServer, execute the following one command to clone Swagger UI
make swagger-ui
  • Debug code...

  • Execute the following command to uninstall our CRDs:

make uninstall

Experimental support

octant-ks-devops is a plugin of octant. It provides a dashboard for Kubernetes and ks-devops.

APIs

For example, you can access an API like:

curl -H "X-Authorization: Bearer xxxx" \
  http://localhost:9090/kapis/devops.kubesphere.io/v1alpha3/devops/testblpsz/pipelines

Please get a token from Kubernetes cluster, and replace xxxx with it.

If you want to see ks-devops postman API collection , please visit ks-devops postman

Code contribution

If you're going to update or add CRD go struct, please run the following command once done with that:

make manifests generate generate-listers

then, it can generate CRDs and DeepCopy methods.

Lint your codes

We are using golangci-lint as our code linter. Before you make some code changes, please execute following command to check code style:

golangci-lint run
# Or with specified folder, e.g.
golangci-lint run controllers/jenkinsconfig

References

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/kubesphere-ks-devops.git
git@api.gitlife.ru:oschina-mirror/kubesphere-ks-devops.git
oschina-mirror
kubesphere-ks-devops
kubesphere-ks-devops
master