kubernetes
/
community
mirror of https://github.com/kubernetes/community.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
community/contributors/devel
History
Brian Pursley 5267030865 Update Testing Guide to clarify how to use go test as an alternative to make test 2020-06-16 09:20:01 -04:00
..
sig-api-machinery docs: fix typo 2020-05-07 22:15:29 +07:00
sig-architecture Replace refs for conformance.txt to conformance.yaml 2020-06-10 07:30:38 +00:00
sig-cli Fix wrong link to pkg/kubectl/cmd/logs/logs.go 2019-06-05 20:55:34 +05:30
sig-instrumentation Add instructions for structured logging migration 2020-06-03 16:03:43 +02:00
sig-node improve sig-node e2e-node testing documentation 2020-06-09 15:29:06 -07:00
sig-release devel/sig-release: Update cherry-picks.md 2020-06-14 02:19:10 -04:00
sig-scalability update the guide to reflect of new cloud provider 2019-11-22 09:43:50 +08:00
sig-scheduling Update scheduler.md 2019-09-14 13:36:27 +08:00
sig-storage devel: add OWNERS files for sig sub-directories 2019-02-04 20:53:07 +05:30
sig-testing Update Testing Guide to clarify how to use go test as an alternative to make test 2020-06-16 09:20:01 -04:00
OWNERS Move calebamiles to emeritus 2020-05-13 15:40:14 -04:00
README.md Update old glog references to klog 2019-10-09 17:03:36 -06:00
automation.md Jenkins is no more 2019-04-23 22:52:05 +01:00
development.md Development: Fix typo 2020-06-12 14:00:14 -05:00
running-locally.md Delete deprecated flag in the guide 2020-04-04 00:59:05 +09:00

README.md

Table of Contents

The developer guide is for anyone wanting to either write code which directly accesses the Kubernetes API, or to contribute directly to the Kubernetes project. It assumes some familiarity with concepts in the User Guide and the Cluster Admin Guide.

The process of developing and contributing code to the Kubernetes project

Setting up your dev environment, coding, and debugging

  • Development Guide (development.md): Setting up your development environment.

  • Testing (testing.md): How to run unit, integration, and end-to-end tests in your development sandbox.

  • Conformance Testing (conformance-tests.md) What is conformance testing and how to create/manage them.

  • Hunting flaky tests (flaky-tests.md): We have a goal of 99.9% flake free tests. Here's how to run your tests many times.

  • Logging Conventions (logging.md): klog levels.

  • Profiling Kubernetes (profiling.md): How to plug in go pprof profiler to Kubernetes.

  • Instrumenting Kubernetes with a new metric (instrumentation.md): How to add a new metrics to the Kubernetes code base.

  • Coding Conventions (coding-conventions.md): Coding style advice for contributors.

  • Document Conventions (The Kubernetes documentation) Document style advice for contributors.

  • Running a cluster locally (running-locally.md): A fast and lightweight local cluster deployment for development.

Developing against the Kubernetes API

  • The REST API documentation explains the REST API exposed by apiserver.

  • Annotations (Annotations): are for attaching arbitrary non-identifying metadata to objects. Programs that automate Kubernetes objects may use annotations to store small amounts of their state.

  • API Conventions (api-conventions.md): Defining the verbs and resources used in the Kubernetes API.

  • API Client Libraries (Client Libraries): A list of existing client libraries, both supported and user-contributed.

Writing plugins

  • Authentication (Authentication): The current and planned states of authentication tokens.

  • Authorization Plugins (Authorization): Authorization applies to all HTTP requests on the main apiserver port. This doc explains the available authorization implementations.

  • Admission Control Plugins (admission_control)

Building releases

See the kubernetes/release repository for details on creating releases and related tools and helper scripts.