github
/
k3s
mirror of https://github.com/k3s-io/k3s
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
k3s/README.md

85 lines
3.1 KiB
Markdown
Raw Normal View History

First commit
2014-06-06 23:40:48 +00:00
# Kubernetes
remove submit-queue from readme
2018-09-14 00:10:35 +00:00
[![GoDoc Widget]][GoDoc] [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/569/badge)](https://bestpractices.coreinfrastructure.org/projects/569)
Add aliases for links and link widgets
2015-09-15 11:39:05 +00:00
improve readme for contributor experience
2016-11-15 14:02:29 +00:00
<img src="https://github.com/kubernetes/kubernetes/raw/master/logo/logo.png" width="100">
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
----
Markdown files in root updated by update-generated-docs.sh.
2016-03-29 18:18:06 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
Kubernetes is an open source system for managing [containerized applications]
Update README.md with punctuation improvements Added a semicolon on line 10 after "hosts" to improve sentence structure and prevent confusion.
2018-01-23 16:16:37 +00:00
across multiple hosts; providing basic mechanisms for deployment, maintenance,
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
and scaling of applications.
Add a note about pre-production.
2014-07-03 21:10:20 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +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.
README: be more accurate about where k8s can run The README really undersells all of the places that can run Kubernetes. Direct users at the getting started guides and be more optimistics about the possibilities of running Kubernetes anywhere.
2016-05-15 18:59:31 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +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].
Updated readme.md
2014-12-02 21:20:48 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
----
Updated readme.md
2014-12-02 21:20:48 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
## To start using Kubernetes
Edit the community, discussion, and support section - add link to community page and cloud native computing foundation Also fixed urls: Changed: GoogleCloudPlatform To: kubernetes
2015-08-31 20:53:32 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
See our documentation on [kubernetes.io].
add pointer to feature repo Signed-off-by: Doug Davis <dug@us.ibm.com>
2016-08-23 21:22:08 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
Try our [interactive tutorial].
Add community expectations about conduct and reviewing.
2016-09-06 03:30:29 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
Take a free course on [Scalable Microservices with Kubernetes].
Update godoc badge from png to svg
2016-03-02 01:34:21 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
## To start developing Kubernetes
Edit the community, discussion, and support section - add link to community page and cloud native computing foundation Also fixed urls: Changed: GoogleCloudPlatform To: kubernetes
2015-08-31 20:53:32 +00:00
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +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.
Add build instructions for the impatient
2016-12-15 14:06:11 +00:00
If you want to build Kubernetes right away there are two options:
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
##### You have a working [Go environment].
Add build instructions for the impatient
2016-12-15 14:06:11 +00:00
```
$ go get -d k8s.io/kubernetes
$ cd $GOPATH/src/k8s.io/kubernetes
$ make
```
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
##### You have a working [Docker environment].
Add build instructions for the impatient
2016-12-15 14:06:11 +00:00
```
$ git clone https://github.com/kubernetes/kubernetes
$ cd kubernetes
$ make quick-release
```
Reword double negative; link to readme
2017-12-08 02:53:25 +00:00
For the full story, head over to the [developer's documentation].
Add build instructions for the impatient
2016-12-15 14:06:11 +00:00
improve readme for contributor experience
2016-11-15 14:02:29 +00:00
## Support
add corekube
2016-04-01 00:18:22 +00:00
Update README.md with punctuation improvements Added a semicolon on line 10 after "hosts" to improve sentence structure and prevent confusion.
2018-01-23 16:16:37 +00:00
If you need support, start with the [troubleshooting guide],
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00: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
Update README.md Update communication link Use git.k8s.io url for communication Use git.k8s.io for other links
2018-02-10 08:12:28 +00:00
[communication]: https://git.k8s.io/community/communication
[community repository]: https://git.k8s.io/community
Update link in README after docs migration Removing an extra hop caused by docs migration. Signed-off-by: Ahmet Alp Balkan <ahmetb@google.com>
2017-03-30 19:43:39 +00:00
[containerized applications]: https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/
Update README.md Update communication link Use git.k8s.io url for communication Use git.k8s.io for other links
2018-02-10 08:12:28 +00:00
[developer's documentation]: https://git.k8s.io/community/contributors/devel#readme
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00: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
Change README links to https
2018-07-18 13:24:42 +00:00
[interactive tutorial]: https://kubernetes.io/docs/tutorials/kubernetes-basics
[kubernetes.io]: https://kubernetes.io
Close kubernetes/community#420 * Move remaining community stuff out of kubernetes/kubernetes/README so that there's only one thing to maintain. * Put self-contained things into their own MD files. * Have other docs point to those files rather than attempt to repeat their content. * Make all docs smaller. See also companion PR in kubernetes/community.
2017-03-06 17:21:47 +00:00
[Scalable Microservices with Kubernetes]: https://www.udacity.com/course/scalable-microservices-with-kubernetes--ud615
Reword double negative; link to readme
2017-12-08 02:53:25 +00:00
[troubleshooting guide]: https://kubernetes.io/docs/tasks/debug-application-cluster/troubleshooting/
Add ga-beacon analytics to gendocs scripts hack/run-gendocs.sh puts ga-beacon analytics link into all md files, hack/verify-gendocs.sh verifies presence of link.
2015-05-14 22:12:45 +00:00
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/README.md?pixel)]()