2014-06-06 19:40:48 -04:00
|
|
|
# Kubernetes
|
|
|
|
|
|
2017-08-22 11:56:16 -04:00
|
|
|
[![Submit Queue Widget]][Submit Queue] [![GoDoc Widget]][GoDoc] [](https://bestpractices.coreinfrastructure.org/projects/569)
|
2015-09-15 07:39:05 -04:00
|
|
|
|
2016-11-15 09:02:29 -05:00
|
|
|
<img src="https://github.com/kubernetes/kubernetes/raw/master/logo/logo.png" width="100">
|
|
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
----
|
2016-03-29 14:18:06 -04:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
Kubernetes is an open source system for managing [containerized applications]
|
2018-01-23 11:16:37 -05:00
|
|
|
across multiple hosts; providing basic mechanisms for deployment, maintenance,
|
2017-03-06 12:21:47 -05:00
|
|
|
and scaling of applications.
|
2014-07-03 17:10:20 -04:00
|
|
|
|
2017-03-06 12:21:47 -05: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.
|
2016-05-15 14:59:31 -04:00
|
|
|
|
2017-03-06 12:21:47 -05: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].
|
2014-12-02 16:20:48 -05:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
----
|
2014-12-02 16:20:48 -05:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
## To start using Kubernetes
|
2015-08-31 16:53:32 -04:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
See our documentation on [kubernetes.io].
|
2016-08-23 17:22:08 -04:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
Try our [interactive tutorial].
|
2016-09-05 23:30:29 -04:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
Take a free course on [Scalable Microservices with Kubernetes].
|
2016-03-01 20:34:21 -05:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
## To start developing Kubernetes
|
2015-08-31 16:53:32 -04:00
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
The [community repository] hosts all information about
|
|
|
|
|
building Kubernetes from source, how to contribute code
|
|
|
|
|
and documentation, who to contact about what, etc.
|
2016-12-15 09:06:11 -05:00
|
|
|
|
|
|
|
|
If you want to build Kubernetes right away there are two options:
|
|
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
##### You have a working [Go environment].
|
2016-12-15 09:06:11 -05:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ go get -d k8s.io/kubernetes
|
|
|
|
|
$ cd $GOPATH/src/k8s.io/kubernetes
|
|
|
|
|
$ make
|
|
|
|
|
```
|
|
|
|
|
|
2017-03-06 12:21:47 -05:00
|
|
|
##### You have a working [Docker environment].
|
2016-12-15 09:06:11 -05:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ git clone https://github.com/kubernetes/kubernetes
|
|
|
|
|
$ cd kubernetes
|
|
|
|
|
$ make quick-release
|
|
|
|
|
```
|
|
|
|
|
|
2017-12-07 21:53:25 -05:00
|
|
|
For the full story, head over to the [developer's documentation].
|
2016-12-15 09:06:11 -05:00
|
|
|
|
2016-11-15 09:02:29 -05:00
|
|
|
## Support
|
2016-03-31 20:18:22 -04:00
|
|
|
|
2018-01-23 11:16:37 -05:00
|
|
|
If you need support, start with the [troubleshooting guide],
|
2017-03-06 12:21:47 -05:00
|
|
|
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
|
2018-02-10 03:12:28 -05:00
|
|
|
[communication]: https://git.k8s.io/community/communication
|
|
|
|
|
[community repository]: https://git.k8s.io/community
|
2017-03-30 15:43:39 -04:00
|
|
|
[containerized applications]: https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/
|
2018-02-10 03:12:28 -05:00
|
|
|
[developer's documentation]: https://git.k8s.io/community/contributors/devel#readme
|
2017-03-06 12:21:47 -05:00
|
|
|
[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
|
2017-08-01 23:36:17 -04:00
|
|
|
[Submit Queue]: http://submit-queue.k8s.io/#/ci
|
2017-03-06 12:21:47 -05:00
|
|
|
[Submit Queue Widget]: http://submit-queue.k8s.io/health.svg?v=1
|
2017-12-07 21:53:25 -05:00
|
|
|
[troubleshooting guide]: https://kubernetes.io/docs/tasks/debug-application-cluster/troubleshooting/
|
2015-05-14 18:12:45 -04:00
|
|
|
|
|
|
|
|
[]()
|
