Dynamic Admission Webhooks Overview
ValidatingAdmissionWebhooks for validating Istio
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 Webhook Configuration 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.18, 1.19, 1.20, 1.21) of
kubectland of the Kubernetes server:
$ kubectl version --short Client Version: v1.19.0 Server Version: v1.19.1
admissionregistration.k8s.io/v1should be enabled
$ kubectl api-versions | grep admissionregistration.k8s.io/v1 admissionregistration.k8s.io/v1 admissionregistration.k8s.io/v1beta1
ValidatingAdmissionWebhookplugins are listed in the
kube-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_proxysettings can interfere api-server operation (see related issues here and here for more information).