Skip to content

Commit 6bbafd5

Browse files
trshaferknative-prow-robot
authored andcommitted
Add documentation for the different knative services and deployments (#1467)
that are running on a kubernetes cluster after installing knative 0.6.0.
1 parent c050da8 commit 6bbafd5

File tree

1 file changed

+64
-0
lines changed

1 file changed

+64
-0
lines changed
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: "Knative Kubernetes Services"
3+
#linkTitle: "OPTIONAL_ALTERNATE_NAV_TITLE"
4+
weight: 9
5+
type: "docs"
6+
---
7+
8+
This document describes what is running when running knative serving.
9+
10+
After applying the serving yaml, this will install a few knative services and deployments on your kubernetes cluster. This document provides an overview of the deployments and the motivations for each one.
11+
12+
```sh
13+
$ kubectl get services -n knative-serving
14+
15+
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
16+
activator-service ClusterIP 10.96.61.11 <none> 80/TCP,81/TCP,9090/TCP 1h
17+
autoscaler ClusterIP 10.104.217.223 <none> 8080/TCP,9090/TCP 1h
18+
controller ClusterIP 10.101.39.220 <none> 9090/TCP 1h
19+
webhook ClusterIP 10.107.144.50 <none> 443/TCP 1h
20+
```
21+
22+
```sh
23+
$ kubectl get deployments -n knative-serving
24+
25+
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
26+
activator 1 1 1 1 1h
27+
autoscaler 1 1 1 1 1h
28+
controller 1 1 1 1 1h
29+
networking-certmanager 1 1 1 1 1h
30+
networking-istio 1 1 1 1 1h
31+
webhook 1 1 1 1 1h
32+
```
33+
34+
## Service: activator
35+
36+
The responsibilities of the activator are:
37+
* Receiving & buffering requests for inactive Revisions.
38+
* Reporting metrics to the autoscaler.
39+
* Retrying requests to a Revision after the autoscaler scales such Revision based on the reported metrics.
40+
41+
## Service: autoscaler
42+
43+
The autoscaler receives request metrics and adjusts the number of pods required to handle the load of traffic.
44+
45+
## Service: controller
46+
47+
The controller service reconciles all the public knative objects and autoscaling CRDs. When a user applies a knative service to the kubernetes api, this creates the config and route. It will convert config into revisions. It will convert Revision into Deployment and KPA.
48+
49+
## Service: webhook
50+
51+
The webhook intercepts all kubernetes api calls, all crd insertions and updates. It does two things:
52+
53+
1. Set default values
54+
2. Rejects inconsitent and invalid objects.
55+
56+
It validates and mutates k8s api calls.
57+
58+
## Deployment: networking-certmanager
59+
60+
The certmanager reconciles cluster ingress into cert manager objects.
61+
62+
## Deployment: networking-istio
63+
64+
This reconciles cluster ingress into a virtual service.

0 commit comments

Comments
 (0)