community/contributors/devel
Davanum Srinivas 749edb1241 Add a tip about --ginkgo.noColor
Document the flag to switch off color in the output logs.
2017-04-05 17:36:03 -04:00
..
developer-guides imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
gubernator-images imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
local-cluster Fix markdown formatting 2017-03-13 14:06:00 -04:00
release Add "Individual Contributors" section to "Release Roles" doc 2017-03-16 12:06:48 -07:00
README.md Merge pull request #258 from heckj/fix_broken_readme_links 2017-01-18 16:54:59 -08:00
adding-an-APIGroup.md Fixed some typo in community documents. 2017-02-06 11:24:04 +08:00
api-conventions.md fix invalid url in api-conventions.md 2017-03-25 10:41:16 -04:00
api_changes.md Update api_changes.md 2017-03-23 22:27:46 -07:00
automation.md Fixed some typo in community documents. 2017-02-06 11:24:04 +08:00
bazel.md Update Bazel documentation to current state-of-the-world 2017-01-26 12:04:07 -08:00
cherry-picks.md Fix cherry-picks link. 2017-03-28 14:32:07 -07:00
client-libraries.md Merge pull request #459 from WilliamDenniss/patch-1 2017-03-29 14:48:23 -07:00
coding-conventions.md fix link 2017-03-18 22:37:05 +08:00
collab.md Update collab.md 2016-12-15 21:31:18 -08:00
community-expectations.md corrected # of pull requests 2017-03-01 19:49:32 +05:30
container-runtime-interface.md Update the CRI doc for 1.6 2017-03-16 10:52:45 -07:00
controllers.md Incorrect punctuation types 2016-12-22 15:50:25 +08:00
development.md Bug fix, Architecture, and Performance impromvenents guidelines (#497) 2017-04-03 17:48:42 -07:00
e2e-node-tests.md fix error links in test docs 2017-02-22 11:11:18 +08:00
e2e-tests.md Add a tip about --ginkgo.noColor 2017-04-05 17:36:03 -04:00
faster_reviews.md Incorrect serial number 2016-12-21 17:09:02 +08:00
flaky-tests.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
flexvolume.md Update flex volume documentation. 2017-03-22 14:52:30 -04:00
generating-clientset.md update generating-clientset.md 2016-12-14 10:48:34 -08:00
getting-builds.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
git_workflow.png imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
go-code.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
godep.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
gubernator.md Fixed some typo in community documents. 2017-02-06 11:24:04 +08:00
how-to-doc.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
instrumentation.md Update metric instrumentation guide 2017-01-10 10:59:05 +01:00
issues.md Update issues.md 2016-12-15 21:37:18 -08:00
kubectl-conventions.md Fix the link of /pkg/kubectl/cmd/logs.go 2017-03-29 22:27:57 +08:00
kubelet-cri-networking.md remove UNVERSIONED_WARNING (#382) 2017-02-17 14:50:10 -06:00
kubemark-guide.md Improved kubemark-guide to reflect recent changes 2017-01-18 23:09:17 +01:00
logging.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
mesos-style.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
node-performance-testing.md fix error links in test docs 2017-02-22 11:11:18 +08:00
on-call-build-cop.md Update buildcop instructions with how to force a build. 2017-03-29 14:33:40 -07:00
on-call-rotations.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
on-call-user-support.md correct user guide url 2017-02-24 14:26:42 +08:00
owners.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
pr_workflow.dia imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
pr_workflow.png imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
profiling.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
pull-request-commands.md Update reference to bot commands 2017-03-10 18:30:14 -08:00
pull-requests.md Close #420 2017-03-06 16:28:38 -08:00
running-locally.md correct user guide url 2017-02-24 14:26:42 +08:00
scheduler.md fix invalid url 2017-03-01 17:29:55 +08:00
scheduler_algorithm.md correct user guide url 2017-02-24 14:26:42 +08:00
security-release-process.md add gpg key 2017-03-14 19:53:35 -07:00
testing.md Add package scoping to integration testing example (#375) 2017-02-17 00:59:04 -06:00
update-release-docs.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
updating-docs-for-feature-changes.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
writing-a-getting-started-guide.md imported docs/devel as a subtree 2016-11-30 14:43:43 -05:00
writing-good-e2e-tests.md fix error links in test docs 2017-02-22 11:11:18 +08:00

README.md

Kubernetes Developer Guide

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

  • On Collaborative Development (collab.md): Info on pull requests and code reviews.

  • GitHub Issues (issues.md): How incoming issues are reviewed and prioritized.

  • Pull Request Process (pull-requests.md): When and why pull requests are closed.

  • Kubernetes On-Call Rotations (on-call-rotations.md): Descriptions of on-call rotations for build and end-user support.

  • Faster PR reviews (faster_reviews.md): How to get faster PR reviews.

  • 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.

  • 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.

Analytics