Merge pull request #27071 from neolit123/1.21-add-kubelet-serving-cert-guide
kubeadm: add guide for kubelet serving certs and metrics-server
This commit is contained in:
+18
-1
@@ -408,7 +408,7 @@ be advised that this is modifying a design principle of the Linux distribution.
|
||||
|
||||
## `kubeadm upgrade plan` prints out `context deadline exceeded` error message
|
||||
|
||||
This error message is shown when upgrading a Kubernetes cluster with `kubeadm` in the case of running an external etcd. This is not a critical bug and happens because older versions of kubeadm perform a version check on the external etcd cluster. You can proceed with `kubeadm upgrade apply ...`.
|
||||
This error message is shown when upgrading a Kubernetes cluster with `kubeadm` in the case of running an external etcd. This is not a critical bug and happens because older versions of kubeadm perform a version check on the external etcd cluster. You can proceed with `kubeadm upgrade apply ...`.
|
||||
|
||||
This issue is fixed as of version 1.19.
|
||||
|
||||
@@ -420,3 +420,20 @@ To workaround the issue, re-mount the `/var/lib/kubelet` directory after perform
|
||||
|
||||
This is a regression introduced in kubeadm 1.15. The issue is fixed in 1.20.
|
||||
|
||||
## Cannot use the metrics-server securely in a kubeadm cluster
|
||||
|
||||
In a kubeadm cluster, the [metrics-server](https://github.com/kubernetes-sigs/metrics-server)
|
||||
can be used insecurely by passing the `--kubelet-insecure-tls` to it. This is not recommended for production clusters.
|
||||
|
||||
If you want to use TLS between the metrics-server and the kubelet there is a problem,
|
||||
since kubeadm deploys a self-signed serving certificate for the kubelet. This can cause the following errors
|
||||
on the side of the metrics-server:
|
||||
```
|
||||
x509: certificate signed by unknown authority
|
||||
x509: certificate is valid for IP-foo not IP-bar
|
||||
```
|
||||
|
||||
See [Enabling signed kubelet serving certificates](/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/#kubelet-serving-certs)
|
||||
to understand how to configure the kubelets in a kubeadm cluster to have properly signed serving certificates.
|
||||
|
||||
Also see [How to run the metrics-server securely](https://github.com/kubernetes-sigs/metrics-server/blob/master/FAQ.md#how-to-run-metrics-server-securely).
|
||||
|
||||
Reference in New Issue
Block a user