community

History

Niko Pen 9980ad3162 link fix		2018-10-24 17:30:51 +02:00
..
gubernator-images	…
OWNERS	…
README.md	Adding Conformance Guidelines document.	2018-07-20 13:01:25 -07:00
adding-an-APIGroup.md	…
api-conventions.md	Document conditions vs fields (#2350 )	2018-10-18 09:54:52 -07:00
api_changes.md	Further clarify defaulting rules & remove example	2018-08-23 10:48:25 -07:00
arch-roadmap-1.png	…
architectural-roadmap.md	Fix blog links after migration from blog.kubernetes.io to kubernetes.io/blog	2018-10-22 15:01:25 -07:00
automation.md	Replace submit queue with Tide in docs	2018-10-06 23:08:24 +05:30
bazel.md	…
cherry-picks.md	Updates and clarifies cherrypick process	2018-10-17 12:34:54 -07:00
client-libraries.md	…
collab.md	…
component-config-conventions.md	…
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	…
cri-container-stats.md	…
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	Add rsync as development dependency	2018-10-13 08:41:06 +02:00
e2e-node-tests.md	…
e2e-tests.md	Fix blog links after migration from blog.kubernetes.io to kubernetes.io/blog	2018-10-22 15:01:25 -07:00
event-style-guide.md	…
flaky-tests.md	Replace submit queue with Tide in docs	2018-10-06 23:08:24 +05:30
flexvolume.md	Flexvolume example updates, and miscellaneous documentation fixes.	2018-08-08 15:00:29 -07:00
generating-clientset.md	Update generating-clientset.md	2018-07-19 22:47:48 +08:00
getting-builds.md	…
godep.md	Mention -v flag for godep-restore.sh	2018-07-23 13:35:35 +03:00
gubernator.md	…
help-wanted.md	…
how-to-doc.md	…
instrumentation.md	…
issues.md	…
kubectl-conventions.md	…
kubelet-cri-networking.md	…
kubemark-guide.md	…
logging.md	…
mesos-style.md	…
node-performance-testing.md	…
on-call-federation-build-cop.md	…
profiling.md	…
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	link fix	2018-10-24 17:30:51 +02:00
running-locally.md	…
scheduler.md	…
scheduler_algorithm.md	…
staging.md	…
strategic-merge-patch.md	…
testing.md	syntax fix for testing doc	2018-08-21 18:11:01 -04:00
update-release-docs.md	…
updating-docs-for-feature-changes.md	…
vagrant.md	…
welcome-to-kubernetes-new-developer-guide.md	…
writing-a-getting-started-guide.md	Fix wrong link	2018-09-22 02:53:56 -04:00
writing-good-e2e-tests.md	Replace submit queue with Tide in docs	2018-10-06 23:08:24 +05:30

README.md

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

Contributor Guide (Please start here) to learn about how to contribute to Kubernetes
GitHub Issues (/contributors/guide/issue-triage.md): How incoming issues are triaged.
Pull Request Process (/contributors/guide/pull-requests.md): When and why pull requests are closed.
Getting Recent Builds (getting-builds.md): How to get recent builds including the latest builds that pass CI.
Automated Tools (automation.md): Descriptions of the automation that is running on our github repository.

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.