Dynamic Admission Webhooks Overview
From Kubernetes mutating and validating webhook mechanisms:
Istio uses ValidatingAdmissionWebhooks
for validating Istio
configuration and MutatingAdmissionWebhooks
for automatically
injecting the sidecar proxy into user pods.
The webhook setup guides assuming general familiarity with Kubernetes Dynamic Admission Webhooks. Consult the Kubernetes API references for detailed documentation of the mutating and validating webhook configuration.
Verify dynamic admission webhook prerequisites
See the platform setup instructions for Kubernetes provider specific setup instructions. Webhooks will not function properly if the cluster is misconfigured. You can follow these steps once the cluster has been configured and dynamic webhooks and dependent features are not functioning properly.
Verify you’re using a supported version (1.14, 1.15, 1.16) of
kubectl
and of the Kubernetes server:$ kubectl version --short Client Version: v1.10.2 Server Version: v1.10.4-gke.0
admissionregistration.k8s.io/v1beta1
should be enabled$ kubectl api-versions | grep admissionregistration.k8s.io/v1beta1 admissionregistration.k8s.io/v1beta1
Verify
MutatingAdmissionWebhook
andValidatingAdmissionWebhook
plugins are listed in thekube-apiserver --enable-admission-plugins
. Access to this flag is provider specific.Verify the Kubernetes api-server has network connectivity to the webhook pod. e.g. incorrect
http_proxy
settings can interfere api-server operation (see related issues here and here for more information).