community/contributors/devel
Kubernetes Prow Robot 1d747b3720
Merge pull request #3162 from eduartua/issue-3064-grouping-by-sig-instrumentation
Grouping  /devel files by SIGs - SIG Instrumentation
2019-01-29 14:29:33 -08:00
..
gubernator-images imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
sig-instrumentation file event-style-guide.md was moved to the new sig-instrumentation folder - URLs in k/community were updated 2019-01-28 14:59:09 -06:00
sig-release file release.md has been moved to /devel/sig-release - URLs in k/community updated 2019-01-29 11:23:48 -06:00
sig-scalability file /devel/profiling.md moved to /devel/sig-scalability. All tombstone files created and URLs updated. 2019-01-29 12:24:48 -06:00
sig-scheduling file scheduler.md moved to /devel/sig-scheduling - URLs updated - tombstone file created 2019-01-29 13:08:31 -06:00
sig-storage file flexvolume.md moved to the new folder /devel/sig-storage - tombstome file created - URLs updated 2019-01-29 15:04:02 -06:00
OWNERS Add guineveresaenger to OWNERS files in contributors 2019-01-24 22:13:04 -08:00
README.md Merge pull request #3162 from eduartua/issue-3064-grouping-by-sig-instrumentation 2019-01-29 14:29:33 -08:00
api-conventions.md Merge pull request #3028 from thockin/api-conventions-annotations 2019-01-18 07:38:37 -08:00
api_changes.md Update feature gate and alpha field guidance 2018-12-18 11:38:39 -05:00
automation.md Fix typos: creats -> creates (#2899) 2018-11-05 09:46:47 -08:00
bazel.md Update bazel documentation with current known issues and limitations 2018-11-07 16:52:06 -08:00
cherry-picks.md /devel/sig-release folder created - file cherry-picks.md moved to /devel/sig-release - URLs updated 2019-01-29 11:03:22 -06:00
collab.md Matching deletion dates 2019-01-23 08:19:37 -06:00
component-config-conventions.md Fix various spelling mistakes 2018-03-04 14:46:53 -08:00
conformance-tests.md Address review comments 2018-10-08 15:15:53 -07:00
container-runtime-interface.md Fix blog links after migration from blog.kubernetes.io to kubernetes.io/blog 2018-10-22 15:01:25 -07:00
controllers.md fix a typo in contributors/devel/controllers.md 2018-07-06 23:30:18 -07:00
cri-container-stats.md Use git.k8s.io for links 2017-12-21 18:34:08 -08:00
cri-testing-policy.md Update links of cri-tools 2018-09-07 10:47:41 +08:00
cri-validation.md Update links of cri-tools 2018-09-07 10:47:41 +08:00
development.md Update go versions in development.md 2019-01-07 10:52:44 +01:00
e2e-node-tests.md Use git.k8s.io for links 2017-12-21 18:34:08 -08:00
e2e-tests.md Adds the [LinuxOnly] tag 2019-01-22 19:50:08 -08:00
event-style-guide.md file event-style-guide.md was moved to the new sig-instrumentation folder - URLs in k/community were updated 2019-01-28 14:59:09 -06:00
flaky-tests.md Replace submit queue with Tide in docs 2018-10-06 23:08:24 +05:30
flexvolume.md file flexvolume.md moved to the new folder /devel/sig-storage - tombstome file created - URLs updated 2019-01-29 15:04:02 -06:00
generating-clientset.md Update generating-clientset.md 2018-07-19 22:47:48 +08:00
getting-builds.md getting-builds.md has been moved to /devel/sig-release - URLs updated 2019-01-29 11:18:55 -06:00
godep.md add acceptable justifications for updating a godep 2018-11-09 12:08:09 -05:00
gubernator.md Change k8s-merge-robot to k8s-ci-robot 2018-03-15 06:48:54 +08:00
help-wanted.md Date to remove file 2019-01-23 08:00:15 -06:00
instrumentation.md file logging.md was moved to the new sig-instrumentation folder - URLs in k/community were updated 2019-01-28 14:45:07 -06:00
kubectl-conventions.md Use git.k8s.io for links 2017-12-21 18:34:08 -08:00
kubelet-cri-networking.md remove UNVERSIONED_WARNING (#382) 2017-02-17 14:50:10 -06:00
kubemark-guide.md folder /devel/sig-scalability created - file kubemark-guide.md moved to it 2019-01-29 12:10:17 -06:00
logging.md file logging.md was moved to the new sig-instrumentation folder - URLs in k/community were updated 2019-01-28 14:45:07 -06:00
node-performance-testing.md Use git.k8s.io for links 2017-12-21 18:34:08 -08:00
profiling.md file /devel/profiling.md moved to /devel/sig-scalability. All tombstone files created and URLs updated. 2019-01-29 12:24:48 -06:00
release-cycle.png devel guide: pull in issue doc from sig-release/ephemera 2018-08-30 17:35:05 -07:00
release-lifecycle.png devel guide: pull in issue doc from sig-release/ephemera 2018-08-30 17:35:05 -07:00
release.md file release.md has been moved to /devel/sig-release - URLs in k/community updated 2019-01-29 11:23:48 -06:00
running-locally.md removed autogenerated munge analytics from files 2017-11-03 16:55:51 -07:00
scheduler.md file scheduler.md moved to /devel/sig-scheduling - URLs updated - tombstone file created 2019-01-29 13:08:31 -06:00
scheduler_algorithm.md folder /devel/sig-scheduling has been created - file scheduler_algorithm.md moved to it - tombstone file created 2019-01-29 13:03:54 -06:00
staging.md doc: fix some typo 2018-02-04 22:41:56 +08:00
strategic-merge-patch.md smp: OpenAPI annotations are now allowed 2017-12-26 16:04:31 +05:30
testing.md fix a changed url 2018-12-05 20:59:06 +08:00
vagrant.md Adding deprecation note for vagrant support 2018-11-19 00:28:03 -08:00
writing-good-e2e-tests.md Remove duplication (#2898) 2018-11-05 09:42:13 -08: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): Glog 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 (how-to-doc.md) 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.md): 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.