485 lines
17 KiB
Go
485 lines
17 KiB
Go
/*
|
|
Copyright 2019 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package admissionwebhook
|
|
|
|
import (
|
|
"context"
|
|
"crypto/tls"
|
|
"crypto/x509"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"sort"
|
|
"strings"
|
|
"sync"
|
|
"testing"
|
|
"time"
|
|
|
|
"k8s.io/api/admission/v1beta1"
|
|
admissionregistrationv1 "k8s.io/api/admissionregistration/v1"
|
|
corev1 "k8s.io/api/core/v1"
|
|
v1 "k8s.io/api/core/v1"
|
|
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
"k8s.io/apimachinery/pkg/types"
|
|
"k8s.io/apimachinery/pkg/util/sets"
|
|
"k8s.io/apimachinery/pkg/util/wait"
|
|
clientset "k8s.io/client-go/kubernetes"
|
|
"k8s.io/client-go/rest"
|
|
kubeapiservertesting "k8s.io/kubernetes/cmd/kube-apiserver/app/testing"
|
|
"k8s.io/kubernetes/test/integration/framework"
|
|
)
|
|
|
|
const (
|
|
testTimeoutClientUsername = "webhook-timeout-integration-client"
|
|
)
|
|
|
|
// TestWebhookTimeoutWithWatchCache ensures that the admission webhook timeout policy is applied correctly with the watch cache enabled.
|
|
func TestWebhookTimeoutWithWatchCache(t *testing.T) {
|
|
testWebhookTimeout(t, true)
|
|
}
|
|
|
|
// TestWebhookTimeoutWithoutWatchCache ensures that the admission webhook timeout policy is applied correctly without the watch cache enabled.
|
|
func TestWebhookTimeoutWithoutWatchCache(t *testing.T) {
|
|
testWebhookTimeout(t, false)
|
|
}
|
|
|
|
type invocation struct {
|
|
path string
|
|
timeoutSeconds int
|
|
}
|
|
|
|
// testWebhookTimeout ensures that the admission webhook timeout policy is applied correctly.
|
|
func testWebhookTimeout(t *testing.T, watchCache bool) {
|
|
type testWebhook struct {
|
|
path string
|
|
timeoutSeconds int32
|
|
policy admissionregistrationv1.FailurePolicyType
|
|
objectSelector *metav1.LabelSelector
|
|
}
|
|
|
|
testCases := []struct {
|
|
name string
|
|
timeoutSeconds int32
|
|
mutatingWebhooks []testWebhook
|
|
validatingWebhooks []testWebhook
|
|
expectInvocations []invocation
|
|
expectError bool
|
|
errorContainsAnyOf []string
|
|
}{
|
|
{
|
|
name: "minimum of request timeout or webhook timeout propagated",
|
|
timeoutSeconds: 10,
|
|
mutatingWebhooks: []testWebhook{
|
|
{path: "/mutating/1/0s", policy: admissionregistrationv1.Fail, timeoutSeconds: 20},
|
|
{path: "/mutating/2/0s", policy: admissionregistrationv1.Fail, timeoutSeconds: 5},
|
|
},
|
|
validatingWebhooks: []testWebhook{
|
|
{path: "/validating/3/0s", policy: admissionregistrationv1.Fail, timeoutSeconds: 20},
|
|
{path: "/validating/4/0s", policy: admissionregistrationv1.Fail, timeoutSeconds: 5},
|
|
},
|
|
expectInvocations: []invocation{
|
|
{path: "/mutating/1/0s", timeoutSeconds: 10}, // from request
|
|
{path: "/mutating/2/0s", timeoutSeconds: 5}, // from webhook config
|
|
{path: "/validating/3/0s", timeoutSeconds: 10}, // from request
|
|
{path: "/validating/4/0s", timeoutSeconds: 5}, // from webhook config
|
|
},
|
|
},
|
|
{
|
|
name: "webhooks consume client timeout available, not webhook timeout",
|
|
timeoutSeconds: 10,
|
|
mutatingWebhooks: []testWebhook{
|
|
{path: "/mutating/1/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 20},
|
|
{path: "/mutating/2/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 5},
|
|
{path: "/mutating/3/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 20},
|
|
},
|
|
validatingWebhooks: []testWebhook{
|
|
{path: "/validating/4/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 5},
|
|
{path: "/validating/5/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 10},
|
|
{path: "/validating/6/1s", policy: admissionregistrationv1.Fail, timeoutSeconds: 20},
|
|
},
|
|
expectInvocations: []invocation{
|
|
{path: "/mutating/1/1s", timeoutSeconds: 10}, // from request
|
|
{path: "/mutating/2/1s", timeoutSeconds: 5}, // from webhook config (less than request - 1s consumed)
|
|
{path: "/mutating/3/1s", timeoutSeconds: 8}, // from request - 2s consumed
|
|
{path: "/validating/4/1s", timeoutSeconds: 5}, // from webhook config (less than request - 3s consumed by mutating)
|
|
{path: "/validating/5/1s", timeoutSeconds: 7}, // from request - 3s consumed by mutating
|
|
{path: "/validating/6/1s", timeoutSeconds: 7}, // from request - 3s consumed by mutating
|
|
},
|
|
},
|
|
{
|
|
name: "timed out client requests skip later mutating webhooks (regardless of failure policy) and fail",
|
|
timeoutSeconds: 3,
|
|
mutatingWebhooks: []testWebhook{
|
|
{path: "/mutating/1/5s", policy: admissionregistrationv1.Ignore, timeoutSeconds: 4},
|
|
{path: "/mutating/2/1s", policy: admissionregistrationv1.Ignore, timeoutSeconds: 5},
|
|
{path: "/mutating/3/1s", policy: admissionregistrationv1.Ignore, timeoutSeconds: 5},
|
|
},
|
|
expectInvocations: []invocation{
|
|
{path: "/mutating/1/5s", timeoutSeconds: 3}, // from request
|
|
},
|
|
expectError: true,
|
|
errorContainsAnyOf: []string{
|
|
// refer to https://github.com/kubernetes/kubernetes/issues/98606#issuecomment-774832633
|
|
// for the reason for triggering this scenario
|
|
"stream error",
|
|
"the server was unable to return a response in the time allotted",
|
|
},
|
|
},
|
|
}
|
|
|
|
roots := x509.NewCertPool()
|
|
if !roots.AppendCertsFromPEM(localhostCert) {
|
|
t.Fatal("Failed to append Cert from PEM")
|
|
}
|
|
cert, err := tls.X509KeyPair(localhostCert, localhostKey)
|
|
if err != nil {
|
|
t.Fatalf("Failed to build cert with error: %+v", err)
|
|
}
|
|
|
|
recorder := &timeoutRecorder{invocations: []invocation{}, markers: sets.NewString()}
|
|
webhookServer := httptest.NewUnstartedServer(newTimeoutWebhookHandler(recorder))
|
|
webhookServer.TLS = &tls.Config{
|
|
|
|
RootCAs: roots,
|
|
Certificates: []tls.Certificate{cert},
|
|
}
|
|
webhookServer.StartTLS()
|
|
defer webhookServer.Close()
|
|
|
|
s := kubeapiservertesting.StartTestServerOrDie(t, kubeapiservertesting.NewDefaultTestServerOptions(), []string{
|
|
"--disable-admission-plugins=ServiceAccount",
|
|
fmt.Sprintf("--watch-cache=%v", watchCache),
|
|
}, framework.SharedEtcd())
|
|
defer s.TearDownFn()
|
|
|
|
// Configure a client with a distinct user name so that it is easy to distinguish requests
|
|
// made by the client from requests made by controllers. We use this to filter out requests
|
|
// before recording them to ensure we don't accidentally mistake requests from controllers
|
|
// as requests made by the client.
|
|
clientConfig := rest.CopyConfig(s.ClientConfig)
|
|
clientConfig.Timeout = 0 // no timeout, we want to set this manually
|
|
clientConfig.Impersonate.UserName = testTimeoutClientUsername
|
|
clientConfig.Impersonate.Groups = []string{"system:masters", "system:authenticated"}
|
|
client, err := clientset.NewForConfig(clientConfig)
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
|
|
_, err = client.CoreV1().Pods("default").Create(context.TODO(), timeoutMarkerFixture, metav1.CreateOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
for i, tt := range testCases {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
recorder.Reset()
|
|
ns := fmt.Sprintf("reinvoke-%d", i)
|
|
_, err = client.CoreV1().Namespaces().Create(context.TODO(), &v1.Namespace{ObjectMeta: metav1.ObjectMeta{Name: ns}}, metav1.CreateOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
mutatingWebhooks := []admissionregistrationv1.MutatingWebhook{}
|
|
for j, webhook := range tt.mutatingWebhooks {
|
|
name := fmt.Sprintf("admission.integration.test.%d.%s", j, strings.Replace(strings.TrimPrefix(webhook.path, "/"), "/", "-", -1))
|
|
endpoint := webhookServer.URL + webhook.path
|
|
mutatingWebhooks = append(mutatingWebhooks, admissionregistrationv1.MutatingWebhook{
|
|
Name: name,
|
|
ClientConfig: admissionregistrationv1.WebhookClientConfig{
|
|
URL: &endpoint,
|
|
CABundle: localhostCert,
|
|
},
|
|
Rules: []admissionregistrationv1.RuleWithOperations{{
|
|
Operations: []admissionregistrationv1.OperationType{admissionregistrationv1.OperationAll},
|
|
Rule: admissionregistrationv1.Rule{APIGroups: []string{""}, APIVersions: []string{"v1"}, Resources: []string{"pods"}},
|
|
}},
|
|
ObjectSelector: webhook.objectSelector,
|
|
FailurePolicy: &tt.mutatingWebhooks[j].policy,
|
|
TimeoutSeconds: &tt.mutatingWebhooks[j].timeoutSeconds,
|
|
AdmissionReviewVersions: []string{"v1beta1"},
|
|
SideEffects: &noSideEffects,
|
|
})
|
|
}
|
|
mutatingCfg, err := client.AdmissionregistrationV1().MutatingWebhookConfigurations().Create(context.TODO(), &admissionregistrationv1.MutatingWebhookConfiguration{
|
|
ObjectMeta: metav1.ObjectMeta{Name: fmt.Sprintf("admission.integration.test-%d", i)},
|
|
Webhooks: mutatingWebhooks,
|
|
}, metav1.CreateOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
defer func() {
|
|
err := client.AdmissionregistrationV1().MutatingWebhookConfigurations().Delete(context.TODO(), mutatingCfg.GetName(), metav1.DeleteOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
}()
|
|
|
|
validatingWebhooks := []admissionregistrationv1.ValidatingWebhook{}
|
|
for j, webhook := range tt.validatingWebhooks {
|
|
name := fmt.Sprintf("admission.integration.test.%d.%s", j, strings.Replace(strings.TrimPrefix(webhook.path, "/"), "/", "-", -1))
|
|
endpoint := webhookServer.URL + webhook.path
|
|
validatingWebhooks = append(validatingWebhooks, admissionregistrationv1.ValidatingWebhook{
|
|
Name: name,
|
|
ClientConfig: admissionregistrationv1.WebhookClientConfig{
|
|
URL: &endpoint,
|
|
CABundle: localhostCert,
|
|
},
|
|
Rules: []admissionregistrationv1.RuleWithOperations{{
|
|
Operations: []admissionregistrationv1.OperationType{admissionregistrationv1.OperationAll},
|
|
Rule: admissionregistrationv1.Rule{APIGroups: []string{""}, APIVersions: []string{"v1"}, Resources: []string{"pods"}},
|
|
}},
|
|
ObjectSelector: webhook.objectSelector,
|
|
FailurePolicy: &tt.validatingWebhooks[j].policy,
|
|
TimeoutSeconds: &tt.validatingWebhooks[j].timeoutSeconds,
|
|
AdmissionReviewVersions: []string{"v1beta1"},
|
|
SideEffects: &noSideEffects,
|
|
})
|
|
}
|
|
validatingCfg, err := client.AdmissionregistrationV1().ValidatingWebhookConfigurations().Create(context.TODO(), &admissionregistrationv1.ValidatingWebhookConfiguration{
|
|
ObjectMeta: metav1.ObjectMeta{Name: fmt.Sprintf("admission.integration.test-%d", i)},
|
|
Webhooks: validatingWebhooks,
|
|
}, metav1.CreateOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
defer func() {
|
|
err := client.AdmissionregistrationV1().ValidatingWebhookConfigurations().Delete(context.TODO(), validatingCfg.GetName(), metav1.DeleteOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
}()
|
|
|
|
// wait until new webhook is called the first time
|
|
if err := wait.PollImmediate(time.Millisecond*5, wait.ForeverTestTimeout, func() (bool, error) {
|
|
_, err = client.CoreV1().Pods("default").Patch(context.TODO(), timeoutMarkerFixture.Name, types.JSONPatchType, []byte("[]"), metav1.PatchOptions{})
|
|
received := recorder.MarkerReceived()
|
|
if len(tt.mutatingWebhooks) > 0 && !received.Has("mutating") {
|
|
t.Logf("Waiting for mutating webhooks to become effective, getting marker object: %v", err)
|
|
return false, nil
|
|
}
|
|
if len(tt.validatingWebhooks) > 0 && !received.Has("validating") {
|
|
t.Logf("Waiting for validating webhooks to become effective, getting marker object: %v", err)
|
|
return false, nil
|
|
}
|
|
return true, nil
|
|
}); err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
pod := &corev1.Pod{
|
|
TypeMeta: metav1.TypeMeta{APIVersion: "v1", Kind: "Pod"},
|
|
ObjectMeta: metav1.ObjectMeta{
|
|
Namespace: ns,
|
|
Name: "labeled",
|
|
Labels: map[string]string{"x": "true"},
|
|
},
|
|
Spec: corev1.PodSpec{
|
|
Containers: []v1.Container{{
|
|
Name: "fake-name",
|
|
Image: "fakeimage",
|
|
}},
|
|
},
|
|
}
|
|
|
|
body, err := json.Marshal(pod)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
// set the timeout parameter manually so we don't actually cut off the request client-side, and wait for the server response
|
|
err = client.CoreV1().RESTClient().Post().Resource("pods").Namespace(ns).Body(body).Param("timeout", fmt.Sprintf("%ds", tt.timeoutSeconds)).Do(context.TODO()).Error()
|
|
// _, err = testClient.CoreV1().Pods(ns).Create(pod)
|
|
|
|
if tt.expectError {
|
|
if err == nil {
|
|
t.Fatalf("expected error but got none")
|
|
}
|
|
|
|
expected := false
|
|
if len(tt.errorContainsAnyOf) != 0 {
|
|
for _, errStr := range tt.errorContainsAnyOf {
|
|
if strings.Contains(err.Error(), errStr) {
|
|
expected = true
|
|
break
|
|
}
|
|
}
|
|
}
|
|
if !expected {
|
|
t.Errorf("expected the error to be any of %q, but got: %v", tt.errorContainsAnyOf, err)
|
|
}
|
|
return
|
|
}
|
|
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
if tt.expectInvocations != nil {
|
|
for i, invocation := range tt.expectInvocations {
|
|
if len(recorder.invocations) <= i {
|
|
t.Errorf("expected invocation of %s, got none", invocation.path)
|
|
continue
|
|
}
|
|
|
|
if recorder.invocations[i].path != invocation.path {
|
|
t.Errorf("expected invocation of %s, got %s", invocation.path, recorder.invocations[i].path)
|
|
continue
|
|
}
|
|
if recorder.invocations[i].timeoutSeconds != invocation.timeoutSeconds {
|
|
t.Errorf("expected invocation of %s with timeout %d, got %d", invocation.path, invocation.timeoutSeconds, recorder.invocations[i].timeoutSeconds)
|
|
continue
|
|
}
|
|
}
|
|
|
|
if len(recorder.invocations) > len(tt.expectInvocations) {
|
|
for _, invocation := range recorder.invocations[len(tt.expectInvocations):] {
|
|
t.Errorf("unexpected invocation of %s", invocation.path)
|
|
}
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
type timeoutRecorder struct {
|
|
mu sync.Mutex
|
|
markers sets.String
|
|
invocations []invocation
|
|
}
|
|
|
|
// Reset zeros out all counts
|
|
func (i *timeoutRecorder) Reset() {
|
|
i.mu.Lock()
|
|
defer i.mu.Unlock()
|
|
i.invocations = []invocation{}
|
|
i.markers = sets.NewString()
|
|
}
|
|
|
|
// MarkerReceived records the specified markers were received and returns the set of received markers
|
|
func (i *timeoutRecorder) MarkerReceived(markers ...string) sets.String {
|
|
i.mu.Lock()
|
|
defer i.mu.Unlock()
|
|
i.markers.Insert(markers...)
|
|
return i.markers.Union(nil)
|
|
}
|
|
|
|
func (i *timeoutRecorder) RecordInvocation(call invocation) {
|
|
i.mu.Lock()
|
|
defer i.mu.Unlock()
|
|
i.invocations = append(i.invocations, call)
|
|
sort.SliceStable(i.invocations, func(a, b int) bool {
|
|
aValidating := strings.Contains(i.invocations[a].path, "validating")
|
|
bValidating := strings.Contains(i.invocations[b].path, "validating")
|
|
switch {
|
|
case aValidating && bValidating:
|
|
// sort validating by path
|
|
return strings.Compare(i.invocations[a].path, i.invocations[b].path) < 0
|
|
case !aValidating && !bValidating:
|
|
// keep mutating in original order
|
|
return a < b
|
|
case aValidating && !bValidating:
|
|
// put validating last
|
|
return false
|
|
default:
|
|
return true
|
|
}
|
|
})
|
|
}
|
|
|
|
func newTimeoutWebhookHandler(recorder *timeoutRecorder) http.Handler {
|
|
allow := func(w http.ResponseWriter) {
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(&v1beta1.AdmissionReview{
|
|
Response: &v1beta1.AdmissionResponse{
|
|
Allowed: true,
|
|
},
|
|
})
|
|
}
|
|
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
defer r.Body.Close()
|
|
data, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
http.Error(w, err.Error(), 400)
|
|
}
|
|
review := v1beta1.AdmissionReview{}
|
|
if err := json.Unmarshal(data, &review); err != nil {
|
|
http.Error(w, err.Error(), 400)
|
|
}
|
|
if review.Request.UserInfo.Username != testTimeoutClientUsername {
|
|
// skip requests not originating from this integration test's client
|
|
allow(w)
|
|
return
|
|
}
|
|
|
|
if len(review.Request.Object.Raw) == 0 {
|
|
http.Error(w, err.Error(), 400)
|
|
}
|
|
pod := &corev1.Pod{}
|
|
if err := json.Unmarshal(review.Request.Object.Raw, pod); err != nil {
|
|
http.Error(w, err.Error(), 400)
|
|
}
|
|
|
|
// When resetting between tests, a marker object is patched until this webhook
|
|
// observes it, at which point it is considered ready.
|
|
if pod.Namespace == timeoutMarkerFixture.Namespace && pod.Name == timeoutMarkerFixture.Name {
|
|
if strings.HasPrefix(r.URL.Path, "/mutating/") {
|
|
recorder.MarkerReceived("mutating")
|
|
}
|
|
if strings.HasPrefix(r.URL.Path, "/validating/") {
|
|
recorder.MarkerReceived("validating")
|
|
}
|
|
allow(w)
|
|
return
|
|
}
|
|
|
|
timeout, err := time.ParseDuration(r.URL.Query().Get("timeout"))
|
|
if err != nil {
|
|
http.Error(w, err.Error(), http.StatusBadRequest)
|
|
}
|
|
invocation := invocation{path: r.URL.Path, timeoutSeconds: int(timeout.Round(time.Second) / time.Second)}
|
|
recorder.RecordInvocation(invocation)
|
|
|
|
switch {
|
|
case strings.HasSuffix(r.URL.Path, "/0s"):
|
|
allow(w)
|
|
case strings.HasSuffix(r.URL.Path, "/1s"):
|
|
time.Sleep(time.Second)
|
|
allow(w)
|
|
case strings.HasSuffix(r.URL.Path, "/5s"):
|
|
time.Sleep(5 * time.Second)
|
|
allow(w)
|
|
default:
|
|
http.NotFound(w, r)
|
|
}
|
|
})
|
|
}
|
|
|
|
var timeoutMarkerFixture = &corev1.Pod{
|
|
ObjectMeta: metav1.ObjectMeta{
|
|
Namespace: "default",
|
|
Name: "marker",
|
|
},
|
|
Spec: corev1.PodSpec{
|
|
Containers: []v1.Container{{
|
|
Name: "fake-name",
|
|
Image: "fakeimage",
|
|
}},
|
|
},
|
|
}
|