docs/serving
Gaurav Abbi 1b52510c44 Add a helloworld sample for haskell (#316)
* Add a helloworld sample for haskell

* Use stack as the build tool
* Use scotty as a web framework
* Use docker multi-stage build to create a smaller runtime image

* Apply review comments on the README.md

* Apply language review comments

- Fix `service.yaml` indentation
- Change heading for sample code recreation
2018-08-21 09:07:58 -07:00
..
images Document installation and usage of logging, monitoring and tracing components (#92) 2018-07-10 12:39:19 -07:00
samples Add a helloworld sample for haskell (#316) 2018-08-21 09:07:58 -07:00
README.md How to use paid SSL cert with Knative (#146) 2018-07-19 15:33:33 -07:00
accessing-logs.md Update accessing-logs.md (#327) 2018-08-13 08:40:55 -07:00
accessing-metrics.md Update Telemetry readmes (#248) 2018-08-13 03:34:55 -07:00
accessing-traces.md Add license footer and text (#204) 2018-07-19 12:05:32 -07:00
debugging-application-issues.md Add license footer and text (#204) 2018-07-19 12:05:32 -07:00
debugging-performance-issues.md Add license footer and text (#204) 2018-07-19 12:05:32 -07:00
gke-assigning-static-ip-address.md Update gke-assigning-static-ip-address.md 2018-07-22 22:12:44 -07:00
installing-logging-metrics-traces.md Clarifies working directory to run command (#329) 2018-08-13 11:25:55 -07:00
outbound-network-access.md Remove space (#305) 2018-08-01 16:45:37 -07:00
setting-up-a-logging-plugin.md Fixes to monitoring component installation. (#238) 2018-07-23 15:11:34 -07:00
using-a-custom-domain.md Add license footer and text (#204) 2018-07-19 12:05:32 -07:00
using-an-ssl-cert.md In case they don't have cert 2018-07-20 11:31:17 -07:00

README.md

Knative Serving

Knative Serving builds on Kubernetes and Istio to support deploying and serving of serverless applications and functions. Serving is easy to get started with and scales to support advanced scenarios.

The Knative Serving project provides middleware primitives that enable:

  • Rapid deployment of serverless containers
  • Automatic scaling up and down to zero
  • Routing and network programming for Istio components
  • Point-in-time snapshots of deployed code and configurations

Serving resources

Knative Serving defines a set of objects as Kubernetes Custom Resource Definitions (CRDs). These objects are used to define and control how your serverless workload behaves on the cluster:

  • Service: The service.serving.knative.dev resource automatically manages the whole lifecycle of your workload. It controls the creation of other objects to ensure that your app has a route, a configuration, and a new revision for each update of the service. Service can be defined to always route traffic to the latest revision or to a pinned revision.
  • Route: The route.serving.knative.dev resource maps a network endpoint to a one or more revisions. You can manage the traffic in several ways, including fractional traffic and named routes.
  • Configuration: The configuration.serving.knative.dev resource maintains the desired state for your deployment. It provides a clean separation between code and configuration and follows the Twelve-Factor App methodology. Modifying a configuration creates a new revision.
  • Revision: 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 are immutable objects and can be retained for as long as useful.

Diagram that displays how the Serving resources coordinate with each other.

Getting Started

To get started with Serving, check out one of the hello world sample projects. 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 and configuration created. Each time the Service is updated, a new revision is created.

For more information on the resources and their interactions, see the Resource Types Overview in the Knative Serving repository.

More samples and demos

Setting up Logging and Metrics

Debugging Knative Serving issues

Configuration and Networking

Known Issues

See the Knative Serving Issues page for a full list of known issues.


Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.