-
Notifications
You must be signed in to change notification settings - Fork 446
/
faq2_15.toml
217 lines (172 loc) · 10.7 KB
/
faq2_15.toml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
[[qna]]
q = "What is KEDA and why is it useful?"
a = "KEDA stands for Kubernetes Event-driven Autoscaler. It is built to be able to activate a Kubernetes deployment (i.e. no pods to a single pod) and subsequently to more pods based on events from various event sources."
type = "General"
[[qna]]
q = "What are the prerequisites for using KEDA?"
a = """
KEDA is designed, tested and is supported to be run on any Kubernetes cluster that runs Kubernetes v1.17.0 or above.
It uses a CRD (custom resource definition) and the Kubernetes metric server so you will have to use a Kubernetes version which supports these.
> 💡 Kubernetes v1.16 is supported with KEDA v2.4.0 or below
"""
type = "General"
[[qna]]
q = "Can KEDA be used in production?"
a = "Yes! KEDA v2.0 is suited for production workloads, but we still support v1.5 if you are running that as well.."
type = "General"
[[qna]]
q = "What does it cost?"
a = "There is no charge for using KEDA itself, we just ask people to [become a listed user](https://github.com/kedacore/keda-docs#become-a-listed-keda-user) when possible."
type = "General"
[[qna]]
q = "Can I scale HTTP workloads with KEDA and Kubernetes?"
a = """
KEDA will scale a container using metrics from a scaler, but unfortunately there is no scaler today for HTTP workloads out-of-the-box.
We do, however, provide some alternative approaches:
- Use our HTTP add-on scaler which is currently in experimental stage ([GitHub](https://github.com/kedacore/http-add-on))
- Use [Prometheus scaler](/docs/latest/scalers/prometheus/) to create scale rule based on metrics around HTTP events
- Read [Anirudh Garg's blog post](https://dev.to/anirudhgarg_99/scale-up-and-down-a-http-triggered-function-app-in-kubernetes-using-keda-4m42) to learn more.
"""
type = "Features"
[[qna]]
q = "Is short polling intervals a problem?"
a = "Polling interval really only impacts the time-to-activation (scaling from 0 to 1) but once scaled to one it's really up to the HPA (horizontal pod autoscaler) which polls KEDA."
type = "Features"
[[qna]]
q = "Using multiple triggers for the same scale target"
a = """
KEDA allows you to use multiple triggers as part of the same `ScaledObject` or `ScaledJob`.
By doing this, your autoscaling becomes better:
- All your autoscaling rules are in one place
- You will not have multiple `ScaledObject`'s or `ScaledJob`'s interfering with each other
KEDA will start scaling as soon as when one of the triggers meets the criteria. Horizontal Pod Autoscaler (HPA) will calculate metrics for every scaler and use the highest desired replica count to scale the workload to.
"""
type = "Best Practices"
[[qna]]
q = "Don't combine `ScaledObject` with Horizontal Pod Autoscaler (HPA)"
a = """
We recommend not to combine using KEDA's `ScaledObject` with a Horizontal Pod Autoscaler (HPA) to scale the same workload.
They will compete with each other resulting given KEDA uses Horizontal Pod Autoscaler (HPA) under the hood and will result in odd scaling behavior.
If you are using a Horizontal Pod Autoscaler (HPA) to scale on CPU and/or memory, we recommend using the [CPU scaler](/docs/latest/scalers/cpu/) & [Memory scaler](/docs/latest/scalers/memory/) scalers instead.
"""
type = "Best Practices"
[[qna]]
q = "What does the target metric value in the Horizontal Pod Autoscaler (HPA) represent?"
a = """
The target metric value is used by the Horizontal Pod Autoscaler (HPA) to make scaling decisions.
The current target value on the Horizontal Pod Autoscaler (HPA) often does not match with the metrics on the system you are scaling on. This is because of how the Horizontal Pod Autoscaler's (HPA) [scaling algorithm](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/#algorithm-details) works.
By default, KEDA scalers use average metrics (the `AverageValue` metric type). This means that the HPA will use the average value of the metric between the total amount of pods. As of KEDA v2.7, ScaledObjects also support the `Value` metric type. You can learn more about it [here](https://keda.sh/docs/latest/concepts/scaling-deployments/#triggers).
"""
type = "Kubernetes"
[[qna]]
q = "Why does KEDA use external metrics and not custom metrics instead?"
a = """
Kubernetes allows you to autoscale based on custom & external metrics which are fundamentally different:
- **Custom metrics** are metrics that come from applications solely running on the Kubernetes cluster (Prometheus)
- **External metrics** are metrics that represent the state of an application/service that is running outside of the Kubernetes cluster (AWS, Azure, GCP, Datadog, etc.)
Because KEDA primarily serves metrics for metric sources outside of the Kubernetes cluster, it uses external metrics and not custom metrics.
This is why KEDA registers the `v1beta1.external.metrics.k8s.io` namespace in the API service. However, this is just an implementation detail as both offer the same functionality.
Read [about the different metric APIs](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/#support-for-metrics-apis) or [this article](https://cloud.google.com/kubernetes-engine/docs/concepts/custom-and-external-metrics) by Google Cloud to learn more.
"""
type = "Kubernetes"
[[qna]]
q = "Can I run multiple metric servers serving external metrics in the same cluster?"
a = """
Unfortunately, you cannot do that.
Kubernetes currently only supports one metric server serving `external.metrics.k8s.io` metrics per cluster. This is because only one API Service can be registered to handle external metrics.
If you want to know what external metric server is currently registered, you can use the following command:
```shell
~ kubectl get APIService/v1beta1.external.metrics.k8s.io
NAME SERVICE AVAILABLE AGE
v1beta1.external.metrics.k8s.io keda-system/keda-operator-metrics-apiserver True 457d
```
Once a new metric server is installed, it will overwrite the existing API Server registration and take over the `v1beta1.external.metrics.k8s.io` namespace. This will cause the previously installed metric server to be ignored.
There is an [open proposal](https://github.com/kubernetes-sigs/custom-metrics-apiserver/issues/70) to allow multiple metric servers in the same cluster, but it's not implemented yet.
"""
type = "Kubernetes"
[[qna]]
q = "Can I run multiple installations of KEDA in the same cluster?"
a = """
Unfortunately, you cannot do that.
This is a limitation that is because Kubernetes does not allow you to run multiple metric servers in the same cluster that serve external metrics.
Also, KEDA does not allow you to share a single metric server across multiple operator installations.
Learn more in the "Can I run multiple metric servers serving external metrics in the same cluster?" FAQ entry.
"""
type = "Kubernetes"
[[qna]]
q = "How can I get involved?"
a = """
There are several ways to get involved.
* Pick up an issue to work on. A good place to start might be issues which are marked as [Good First Issue](https://github.com/kedacore/keda/labels/good%20first%20issue) or [Help Wanted](https://github.com/kedacore/keda/labels/help%20wanted)
* We are always looking to add more scalers.
* We are always looking for more samples, documentation, etc.
* Please join us in our [weekly standup](https://github.com/kedacore/keda#community).
"""
type = "Community"
[[qna]]
q = "Where can I get to the code for the Scalers?"
a = "All scalers have their code [here](https://github.com/kedacore/keda/tree/main/pkg/scalers)."
type = "Community"
[[qna]]
q = "How do I access KEDA resources using `client-go`?"
a = """KEDA client-go is exported as part of the KEDA repository."""
[[qna]]
q = "How do I run KEDA with `readOnlyRootFilesystem=true`?"
a = """
As default, KEDA v2.10 or above sets `readOnlyRootFilesystem=true` as default without any other manual intervention.
If you are running KEDA v2.9 or below, you can't run KEDA with `readOnlyRootFilesystem=true` as default because Metrics adapter generates self-signed certificates during deployment and stores them on the root file system.
To overcome this, you can create a secret/configmap with a valid CA, cert and key and then mount it to the Metrics Deployment.
To use your certificate, you need to reference it in the container `args` section, e.g.:
```
args:
- '--client-ca-file=/cabundle/service-ca.crt'
- '--tls-cert-file=/certs/tls.crt'
- '--tls-private-key-file=/certs/tls.key'
```
It is also possible to run KEDA with `readOnlyRootFilesystem=true` by creating an emptyDir volume and mounting it to the path where,
by default, metrics server writes its generated cert. The corresponding helm command is:
```
helm install keda kedacore/keda --namespace keda \
--set 'volumes.metricsApiServer.extraVolumes[0].name=keda-volume' \
--set 'volumes.metricsApiServer.extraVolumeMounts[0].name=keda-volume' \
--set 'volumes.metricsApiServer.extraVolumeMounts[0].mountPath=/apiserver.local.config/certificates/' \
--set 'securityContext.metricServer.readOnlyRootFilesystem=true'
```
"""
type = "Features"
[[qna]]
q = "How do I run KEDA with TLS v1.3 only?"
a = """
By default, Keda listens on TLS v1.1 and TLSv1.2, with the default Golang ciphersuites.
In some environments, these ciphers may be considered less secure, for example CBC ciphers.
As an alternative, you can configure the minimum TLS version to be v1.3 to increase security.
Since all modern clients support this version, there should be no impact in most scenarios.
You can set this with args - e.g.:
```
args:
- '--tls-min-version=VersionTLS13'
```
"""
type = "Features"
[[qna]]
q = "Does KEDA depend on any Azure service?"
a = "No, KEDA only takes a dependency on standard Kubernetes constructs and can run on any Kubernetes cluster whether in OpenShift, AKS, GKE, EKS or your own infrastructure."
type = "Azure"
[[qna]]
q = "Does KEDA only work with Azure Functions?"
a = "No, KEDA can scale up/down any container that you specify in your deployment. There has been work done in the Azure Functions tooling to make it easy to scale an Azure Function container."
type = "Azure"
[[qna]]
q = "Why should we use KEDA if we are already using Azure Functions in Azure?"
a = """
There are a few reasons for this:
* Run functions on-premises (potentially in something like an 'intelligent edge' architecture)
* Run functions alongside other Kubernetes apps (maybe in a restricted network, app mesh, custom environment, etc.)
* Run functions outside of Azure (no vendor lock-in)
* Specific need for more control (GPU enabled compute clusters, policies, etc.)
"""
type = "Azure"
[[qna]]
q = "Does scaler search support wildcard search?"
a = "Yes. The search actually supports wildcard search. We've made our search to automatically perform wildcard filtering on the fly so you don't have to append special symbols within your search query."
type = "Website"