knative
/
docs
mirror of https://github.com/knative/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Edits for serving readme (#143)

This commit is contained in:
Ivan Nikittin 2018-07-17 17:14:34 -07:00 committed by GitHub
parent 2c623deec2
commit f68f841dcf
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
serving/README.md
View File

@ -8,13 +8,13 @@ and scales to support advanced scenarios.
The Knative Serving project provides middleware primitives that enable: The Knative Serving project provides middleware primitives that enable:
* Rapid deployment of serverless containers * Rapid deployment of serverless containers
* Automatic scale up and down to zero * Automatic scaling up and down to zero
* Routing and network programming for Istio components * Routing and network programming for Istio components
* Point in time snapshots of deployed code and configurations * Point-in-time snapshots of deployed code and configurations
## Serving resources ## Serving resources
Knative Serving defines a set of principled objects as Kubernetes Knative Serving defines a set of objects as Kubernetes
Custom Resource Definitions (CRDs). These objects are used to define and control Custom Resource Definitions (CRDs). These objects are used to define and control
how your serverless workload behaves on the cluster: how your serverless workload behaves on the cluster:
@ -31,8 +31,8 @@ how your serverless workload behaves on the cluster:
* [Configuration](https://github.com/knative/serving/blob/master/docs/spec/spec.md#configuration): * [Configuration](https://github.com/knative/serving/blob/master/docs/spec/spec.md#configuration):
The `configuration.serving.knative.dev` resource maintains The `configuration.serving.knative.dev` resource maintains
the desired state for your deployment. It provides a clean separation between the desired state for your deployment. It provides a clean separation between
code and configuration, following the Twelve-Factor App methodology. Modifying a configuration code and configuration and follows the Twelve-Factor App methodology. Modifying a configuration
will create a new revision. creates a new revision.
* [Revision](https://github.com/knative/serving/blob/master/docs/spec/spec.md#revision): * [Revision](https://github.com/knative/serving/blob/master/docs/spec/spec.md#revision):
The `revision.serving.knative.dev` resource is a point in time snapshot The `revision.serving.knative.dev` resource is a point in time snapshot
of the code and configuration for each modification made to the workload. Revisions of the code and configuration for each modification made to the workload. Revisions
@ -43,22 +43,21 @@ how your serverless workload behaves on the cluster:
## Getting Started ## Getting Started
To get started with Serving, check out one of the [hello world](samples/) sample projects. To get started with Serving, check out one of the [hello world](samples/) sample projects.
These projects use the `Service` resource, which manages all the details for you. These projects use the `Service` resource, which manages all of the details for you.
With the `Service` resource, a deployed service will automatically have a matching route With the `Service` resource, a deployed service will automatically have a matching route
and configuration created. Each time the `Service` is updated, a new revision will be and configuration created. Each time the `Service` is updated, a new revision is
created. created.
For more information on the resources and their interactions, see the For more information on the resources and their interactions, see the
[Resource Types Overview](https://github.com/knative/serving/blob/master/docs/spec/overview.md) [Resource Types Overview](https://github.com/knative/serving/blob/master/docs/spec/overview.md)
in the Knative Serving repo. in the Knative Serving repository.
To serve workloads from a custom domain, see [Use a custom domain](DNS.md) for details on how to override To serve workloads from a custom domain, see [Use a custom domain](DNS.md).
the default `example.com` domain.
## Known Issues ## Known Issues
See the [Knative Serving Issues](https://github.com/knative/serving/issues) for a full list of See the [Knative Serving Issues](https://github.com/knative/serving/issues) page for a full list of
known issues. known issues.
* **No support for TLS** - Currently the Knative Serving components do not support TLS connections for * **No support for TLS** - Currently the Knative Serving components do not support TLS connections for
@ -75,4 +74,4 @@ known issues.
## Networking ## Networking
* [Setting up DNS](./DNS.md) * [Setting up DNS](./DNS.md)