From 4ace487d9f5ec26daf2adc2f003f63be92533e24 Mon Sep 17 00:00:00 2001 From: ellenevans <35748459+ellenevans@users.noreply.github.com> Date: Fri, 31 Jan 2020 14:22:28 -0800 Subject: [PATCH] Create overview.md (#2160) * Create overview.md A document for the Concepts section that is purely a high level description of what the project is. The main landing page for the site includes lots of market-y stuff and process stuff, and is likely to be confusing to someone who is really new to all this. Most of this is stolen, shamelessly, from knative.tips. It also points out that Build has been moved to its own project. Since much of the documentation available on the wider web still indicates Build is part of Knative, it is valuable to explain where it went. * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> * Update docs/concepts/overview.md Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com> Co-authored-by: Sam O'Dell <31352624+samodell@users.noreply.github.com> --- docs/concepts/overview.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/concepts/overview.md diff --git a/docs/concepts/overview.md b/docs/concepts/overview.md new file mode 100644 index 000000000..10d597778 --- /dev/null +++ b/docs/concepts/overview.md @@ -0,0 +1,32 @@ +--- +title: "Overview" +weight: 5 +type: "docs" +--- + +This document contains a quick overview of Knative. + +Knative (pronounced kay-native) is a set of open source components for [Kubernetes](https://kubernetes.io) that implements +functionality to: + +* run stateless workloads, such as microservices +* support event subscription, delivery, and handling + +on Kubernetes clusters. + +Knative is implemented as a set of [controllers](https://kubernetes.io/docs/concepts/architecture/controller/) you install +on your Kubernetes cluster. Knative registers its own API types to the Kubernetes API, so working with it is not +too different from working with Kubernetes itself. + +Knative consists of two independent components that have their own GitHub projects: + +* [Knative Serving](https://knative.dev/docs/serving/): Run stateless services more easily on Kubernetes, + by making autoscaling, networking and rollouts easier. + +* [Knative Eventing](https://knative.dev/docs/eventing/): Create subscriptions to event sources declaratively, + and route events to Kubernetes endpoints. + +You can use either one or both components in your cluster. + +**Note**: Earlier versions of Knative included a Build component. That component has been broken out into its own +project, [Tekton Pipelines](https://tekton.dev/).