2017-02-01 00:45:59 +00:00
|
|
|
# Kubernetes
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
[![Submit Queue Widget]][Submit Queue] [![GoDoc Widget]][GoDoc]
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
<img src="https://github.com/kubernetes/kubernetes/raw/master/logo/logo.png" width="100">
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
----
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
Kubernetes is an open source system for managing [containerized applications]
|
|
|
|
|
across multiple hosts, providing basic mechanisms for deployment, maintenance,
|
|
|
|
|
and scaling of applications.
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
Kubernetes builds upon a decade and a half of experience at Google running
|
|
|
|
|
production workloads at scale using a system called [Borg],
|
|
|
|
|
combined with best-of-breed ideas and practices from the community.
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
Kubernetes is hosted by the Cloud Native Computing Foundation ([CNCF]).
|
|
|
|
|
If you are a company that wants to help shape the evolution of
|
|
|
|
|
technologies that are container-packaged, dynamically-scheduled
|
|
|
|
|
and microservices-oriented, consider joining the CNCF.
|
|
|
|
|
For details about who's involved and how Kubernetes plays a role,
|
|
|
|
|
read the CNCF [announcement].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
----
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
## To start using Kubernetes
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
See our documentation on [kubernetes.io].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
Try our [interactive tutorial].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
Take a free course on [Scalable Microservices with Kubernetes].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
## To start developing Kubernetes
|
2017-02-01 00:45:59 +00:00
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
The [community repository] hosts all information about
|
|
|
|
|
building Kubernetes from source, how to contribute code
|
|
|
|
|
and documentation, who to contact about what, etc.
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
If you want to build Kubernetes right away there are two options:
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
##### You have a working [Go environment].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ go get -d k8s.io/kubernetes
|
|
|
|
|
$ cd $GOPATH/src/k8s.io/kubernetes
|
|
|
|
|
$ make
|
|
|
|
|
```
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
##### You have a working [Docker environment].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ git clone https://github.com/kubernetes/kubernetes
|
|
|
|
|
$ cd kubernetes
|
|
|
|
|
$ make quick-release
|
|
|
|
|
```
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
If you are less impatient, head over to the [developer's documentation].
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
## Support
|
|
|
|
|
|
2017-06-06 07:19:04 +00:00
|
|
|
If you need support, start with the [troubleshooting guide]
|
|
|
|
|
and work your way through the process that we've outlined.
|
|
|
|
|
|
|
|
|
|
That said, if you have questions, reach out to us
|
|
|
|
|
[one way or another][communication].
|
|
|
|
|
|
|
|
|
|
[announcement]: https://cncf.io/news/announcement/2015/07/new-cloud-native-computing-foundation-drive-alignment-among-container
|
|
|
|
|
[Borg]: https://research.google.com/pubs/pub43438.html
|
|
|
|
|
[CNCF]: https://www.cncf.io/about
|
|
|
|
|
[communication]: https://github.com/kubernetes/community/blob/master/communication.md
|
|
|
|
|
[community repository]: https://github.com/kubernetes/community
|
2017-08-04 11:13:19 +00:00
|
|
|
[containerized applications]: https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/
|
2017-06-06 07:19:04 +00:00
|
|
|
[developer's documentation]: https://github.com/kubernetes/community/tree/master/contributors/devel
|
|
|
|
|
[Docker environment]: https://docs.docker.com/engine
|
|
|
|
|
[Go environment]: https://golang.org/doc/install
|
|
|
|
|
[GoDoc]: https://godoc.org/k8s.io/kubernetes
|
|
|
|
|
[GoDoc Widget]: https://godoc.org/k8s.io/kubernetes?status.svg
|
|
|
|
|
[interactive tutorial]: http://kubernetes.io/docs/tutorials/kubernetes-basics
|
|
|
|
|
[kubernetes.io]: http://kubernetes.io
|
|
|
|
|
[Scalable Microservices with Kubernetes]: https://www.udacity.com/course/scalable-microservices-with-kubernetes--ud615
|
|
|
|
|
[Submit Queue]: http://submit-queue.k8s.io/#/e2e
|
|
|
|
|
[Submit Queue Widget]: http://submit-queue.k8s.io/health.svg?v=1
|
2017-08-31 17:36:07 +00:00
|
|
|
[troubleshooting guide]: https://kubernetes.io/docs/tasks/debug-application-cluster/troubleshooting/
|
2017-02-01 00:45:59 +00:00
|
|
|
|
|
|
|
|
[]()
|
