KEP-4292: Add e2e test for custom profile in kubectl debug (#127187)

* Remove KUBECTL_DEBUG_CUSTOM_PROFILE env var

* Add e2e test for custom profile in kubectl debug

* Keep feature flag until 1.33

* Update comment

* Simplify tests by relying on test framework functionality

* Rename import alias to better to pass verify-import-alias
This commit is contained in:
Arda Güçlü 2024-10-22 21:48:59 +03:00 committed by GitHub
parent c4a14d7ef5
commit 1caf9a150b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 164 additions and 4 deletions

View File

@ -212,9 +212,7 @@ func (o *DebugOptions) AddFlags(cmd *cobra.Command) {
cmd.Flags().StringVar(&o.TargetContainer, "target", "", i18n.T("When using an ephemeral container, target processes in this container name."))
cmd.Flags().BoolVarP(&o.TTY, "tty", "t", o.TTY, i18n.T("Allocate a TTY for the debugging container."))
cmd.Flags().StringVar(&o.Profile, "profile", ProfileLegacy, i18n.T(`Options are "legacy", "general", "baseline", "netadmin", "restricted" or "sysadmin".`))
if !cmdutil.DebugCustomProfile.IsDisabled() {
cmd.Flags().StringVar(&o.CustomProfileFile, "custom", o.CustomProfileFile, i18n.T("Path to a JSON or YAML file containing a partial container spec to customize built-in debug profiles."))
}
cmd.Flags().StringVar(&o.CustomProfileFile, "custom", o.CustomProfileFile, i18n.T("Path to a JSON or YAML file containing a partial container spec to customize built-in debug profiles."))
}
// Complete finishes run-time initialization of debug.DebugOptions.

View File

@ -430,7 +430,8 @@ const (
OpenAPIV3Patch FeatureGate = "KUBECTL_OPENAPIV3_PATCH"
RemoteCommandWebsockets FeatureGate = "KUBECTL_REMOTE_COMMAND_WEBSOCKETS"
PortForwardWebsockets FeatureGate = "KUBECTL_PORT_FORWARD_WEBSOCKETS"
DebugCustomProfile FeatureGate = "KUBECTL_DEBUG_CUSTOM_PROFILE"
// DebugCustomProfile should be dropped in 1.34
DebugCustomProfile FeatureGate = "KUBECTL_DEBUG_CUSTOM_PROFILE"
)
// IsEnabled returns true iff environment variable is set to true.

161
test/e2e/kubectl/debug.go Normal file
View File

@ -0,0 +1,161 @@
/*
Copyright 2024 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.
*/
// OWNER = sig/cli
package kubectl
import (
"context"
"os"
"path/filepath"
"github.com/onsi/ginkgo/v2"
"github.com/onsi/gomega"
"k8s.io/apimachinery/pkg/labels"
clientset "k8s.io/client-go/kubernetes"
"k8s.io/kubernetes/test/e2e/framework"
e2ekubectl "k8s.io/kubernetes/test/e2e/framework/kubectl"
e2epod "k8s.io/kubernetes/test/e2e/framework/pod"
testutils "k8s.io/kubernetes/test/utils"
imageutils "k8s.io/kubernetes/test/utils/image"
admissionapi "k8s.io/pod-security-admission/api"
)
var _ = SIGDescribe("kubectl debug", func() {
f := framework.NewDefaultFramework("kubectl-debug")
f.NamespacePodSecurityLevel = admissionapi.LevelPrivileged
var ns string
var c clientset.Interface
ginkgo.BeforeEach(func() {
c = f.ClientSet
ns = f.Namespace.Name
})
ginkgo.Describe("custom profile", func() {
ginkgo.It("should be applied on static profiles on ephemeral container", func(ctx context.Context) {
debugPodName := "e2e-test-debug-custom-profile-pod-ephemeral"
customProfileImage := imageutils.GetE2EImage(imageutils.BusyBox)
ginkgo.By("running the image " + customProfileImage)
e2ekubectl.RunKubectlOrDie(ns,
"run", debugPodName,
"--image="+customProfileImage,
podRunningTimeoutArg,
"--labels=run="+debugPodName,
"--", "sh", "-c",
"sleep 3600")
ginkgo.By("verifying the pod " + debugPodName + " is running")
label := labels.SelectorFromSet(map[string]string{"run": debugPodName})
_, err := e2epod.WaitForPodsWithLabelRunningReady(ctx, c, ns, label, 1, framework.PodStartShortTimeout)
if err != nil {
framework.Failf("Failed getting pod %s: %v", debugPodName, err)
}
tmpDir, err := os.MkdirTemp("", "test-custom-profile-debug")
framework.ExpectNoError(err)
defer os.Remove(tmpDir) //nolint:errcheck
customProfileFile := "custom.yaml"
framework.ExpectNoError(os.WriteFile(filepath.Join(tmpDir, customProfileFile), []byte(`
securityContext:
capabilities:
add:
- NET_ADMIN
env:
- name: REQUIRED_ENV_VAR
value: value2
`), os.FileMode(0755)), "creating a custom.yaml in temp directory")
ginkgo.By("verifying ephemeral container has correct fields")
e2ekubectl.RunKubectlOrDie(ns,
"debug",
debugPodName,
"--image="+imageutils.GetE2EImage(imageutils.Nginx),
"--container=debugger",
"--profile=general", // general profile sets capability to SYS_PTRACE and custom should overwrite it to NET_ADMIN
"--custom="+filepath.Join(tmpDir, customProfileFile),
"--", "sh", "-c",
"sleep 3600")
ginkgo.By("verifying the container debugger is running")
framework.ExpectNoError(e2epod.WaitForContainerRunning(ctx, c, ns, debugPodName, "debugger", framework.PodStartShortTimeout))
output := e2ekubectl.RunKubectlOrDie(ns, "get", "pod", debugPodName, "-o", "jsonpath={.spec.ephemeralContainers[*]}")
ginkgo.By("verifying NET_ADMIN is added")
gomega.Expect(output).To(gomega.ContainSubstring("NET_ADMIN"))
ginkgo.By("verifying SYS_PTRACE is overridden")
gomega.Expect(output).NotTo(gomega.ContainSubstring("SYS_PTRACE"))
ginkgo.By("verifying REQUIRED_ENV_VAR is added")
gomega.Expect(output).To(gomega.ContainSubstring("REQUIRED_ENV_VAR"))
})
ginkgo.It("should be applied on static profiles while copying from pod", func(ctx context.Context) {
debugPodName := "e2e-test-debug-custom-profile-pod"
customProfileImage := imageutils.GetE2EImage(imageutils.BusyBox)
ginkgo.By("running the image " + customProfileImage)
e2ekubectl.RunKubectlOrDie(ns,
"run", debugPodName,
"--image="+customProfileImage,
podRunningTimeoutArg,
"--labels=run="+debugPodName,
"--", "sh", "-c",
"sleep 3600")
ginkgo.By("verifying the pod " + debugPodName + " is running")
label := labels.SelectorFromSet(map[string]string{"run": debugPodName})
err := testutils.WaitForPodsWithLabelRunning(c, ns, label)
if err != nil {
framework.Failf("Failed getting pod %s: %v", debugPodName, err)
}
tmpDir, err := os.MkdirTemp("", "test-custom-profile-debug")
framework.ExpectNoError(err)
defer os.Remove(tmpDir) //nolint:errcheck
customProfileFile := "custom.yaml"
framework.ExpectNoError(os.WriteFile(filepath.Join(tmpDir, customProfileFile), []byte(`
securityContext:
capabilities:
add:
- NET_ADMIN
env:
- name: REQUIRED_ENV_VAR
value: value2
`), os.FileMode(0755)), "creating a custom.yaml in temp directory")
ginkgo.By("verifying copied pod has correct fields")
e2ekubectl.RunKubectlOrDie(ns,
"debug",
debugPodName,
"--image="+imageutils.GetE2EImage(imageutils.Nginx),
"--copy-to=my-debugger",
"--container=debugger",
"--profile=general", // general profile sets capability to SYS_PTRACE and custom should overwrite it to NET_ADMIN
"--custom="+filepath.Join(tmpDir, customProfileFile),
"--", "sh", "-c",
"sleep 3600")
ginkgo.By("verifying the container in pod my-debugger is running")
framework.ExpectNoError(e2epod.WaitForContainerRunning(ctx, c, ns, "my-debugger", "debugger", framework.PodStartShortTimeout))
output := e2ekubectl.RunKubectlOrDie(ns, "get", "pod", "my-debugger", "-o", "jsonpath={.spec.containers[*]}")
ginkgo.By("verifying NET_ADMIN is added")
gomega.Expect(output).To(gomega.ContainSubstring("NET_ADMIN"))
ginkgo.By("verifying SYS_PTRACE is overridden")
gomega.Expect(output).NotTo(gomega.ContainSubstring("SYS_PTRACE"))
ginkgo.By("verifying REQUIRED_ENV_VAR is added")
gomega.Expect(output).To(gomega.ContainSubstring("REQUIRED_ENV_VAR"))
})
})
})