Lightweight Kubernetes
 
 
 
 
Go to file
Jerzy Szczepkowski 95d34a1343 Merge pull request #13016 from gmarek/master
Update constants in monitor_resources.go
2015-08-21 10:31:11 +02:00
Godeps Update spf13/cobra and spf13/pflag 2015-08-20 15:00:41 -07:00
api/swagger-spec Merge pull request #12957 from smarterclayton/handle_terminating_pods 2015-08-20 21:47:00 -07:00
build delete unused image hello-kubernetes 2015-08-14 15:45:44 -07:00
cluster Merge pull request #12985 from mbabker/gke-machine-type 2015-08-21 10:29:01 +02:00
cmd Merge pull request #12986 from BenTheElder/masquerade_all_flag 2015-08-21 10:28:07 +02:00
contrib External IPs support. 2015-08-20 16:10:01 -07:00
docs Merge pull request #13014 from a-robinson/typo 2015-08-21 10:30:04 +02:00
examples Added Node.js / MongoDB example 2015-08-19 18:04:53 -07:00
hack Merge pull request #12986 from BenTheElder/masquerade_all_flag 2015-08-21 10:28:07 +02:00
hooks Merge pull request #12188 from eparis/godeps-clean-test 2015-08-19 16:57:22 -07:00
pkg Merge pull request #12975 from wojtek-t/switch_cacher_for_pods 2015-08-21 10:28:38 +02:00
plugin Add TerminationGracePeriodSeconds to API 2015-08-20 11:03:38 -04:00
test Merge pull request #13016 from gmarek/master 2015-08-21 10:31:11 +02:00
third_party add jsonpath to kubectl 2015-08-20 08:57:24 +08:00
www add back missing analytics link 2015-08-13 10:03:07 -07:00
.gitignore Split hack/{verify,update}-* files so we don't always go build 2015-08-11 14:20:46 -04:00
.travis.yml Merge pull request #12188 from eparis/godeps-clean-test 2015-08-19 16:57:22 -07:00
CHANGELOG.md Change the CHANGELOG to be a pointer to the releases page. 2015-06-09 20:12:24 -07:00
CONTRIB.md Add ga-beacon analytics to gendocs scripts 2015-05-15 18:56:38 -07:00
CONTRIBUTING.md Update advice for getting support and filing issues. 2015-08-19 03:18:06 +00:00
DESIGN.md Fix links in DESIGN.md 2015-07-20 14:35:52 -07:00
LICENSE
Makefile Plumb linker flags through from the Makefile 2015-08-05 20:42:54 -07:00
README.md Update coveralls URLs 2015-08-17 09:02:41 -07:00
Vagrantfile Vagrant: Add support for nfs synced folders 2015-07-01 13:12:42 -07:00
logo.pdf
logo.png
logo.svg
logo_usage_guidelines.md Add ga-beacon analytics to gendocs scripts 2015-05-15 18:56:38 -07:00
shippable.yml Merge pull request #12188 from eparis/godeps-clean-test 2015-08-19 16:57:22 -07:00

README.md

Kubernetes

GoDoc Travis Coverage Status

Are you ...

  • Interested in learning more about using Kubernetes? Please see our user-facing documentation on kubernetes.io
  • Interested in hacking on the core Kubernetes code base? Keep reading!

Kubernetes is an open source system for managing containerized applications across multiple hosts, providing basic mechanisms for deployment, maintenance, and scaling of applications.

Kubernetes is:

  • lean: lightweight, simple, accessible
  • portable: public, private, hybrid, multi cloud
  • extensible: modular, pluggable, hookable, composable
  • self-healing: auto-placement, auto-restart, auto-replication

Kubernetes builds upon a decade and a half of experience at Google running production workloads at scale, combined with best-of-breed ideas and practices from the community.


Kubernetes can run anywhere!

However, initial development was done on GCE and so our instructions and scripts are built around that. If you make it work on other infrastructure please let us know and contribute instructions/code.

Kubernetes is ready for Production!

With the 1.0.1 release Kubernetes is ready to serve your production workloads.

Concepts

Kubernetes works with the following concepts:

Cluster
A cluster is a set of physical or virtual machines and other infrastructure resources used by Kubernetes to run your applications. Kubernetes can run anywhere! See the Getting Started Guides for instructions for a variety of services.
Node
A node is a physical or virtual machine running Kubernetes, onto which pods can be scheduled.
Pod
Pods are a colocated group of application containers with shared volumes. They're the smallest deployable units that can be created, scheduled, and managed with Kubernetes. Pods can be created individually, but it's recommended that you use a replication controller even if creating a single pod.
Replication controller
Replication controllers manage the lifecycle of pods. They ensure that a specified number of pods are running at any given time, by creating or killing pods as required.
Service
Services provide a single, stable name and address for a set of pods. They act as basic load balancers.
Label
Labels are used to organize and select groups of objects based on key:value pairs.

Documentation

Kubernetes documentation is organized into several categories.

Community, discussion and support

If you have questions or want to start contributing please reach out. We don't bite!

Please see the troubleshooting guide, or how to get more help.

If you are a company and are looking for a more formal engagement with Google around Kubernetes and containers at Google as a whole, please fill out this form and we'll be in touch.

Analytics