/* Copyright 2016 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 services import ( "flag" "fmt" "io/ioutil" "os" "os/exec" "path/filepath" "strings" "time" "github.com/spf13/pflag" "k8s.io/klog" metav1 "k8s.io/apimachinery/pkg/apis/meta/v1" utilfeature "k8s.io/apiserver/pkg/util/feature" cliflag "k8s.io/component-base/cli/flag" kubeletconfigv1beta1 "k8s.io/kubelet/config/v1beta1" "k8s.io/kubernetes/cmd/kubelet/app/options" "k8s.io/kubernetes/pkg/features" kubeletconfig "k8s.io/kubernetes/pkg/kubelet/apis/config" kubeletconfigcodec "k8s.io/kubernetes/pkg/kubelet/kubeletconfig/util/codec" "k8s.io/kubernetes/test/e2e/framework" "k8s.io/kubernetes/test/e2e_node/builder" "k8s.io/kubernetes/test/e2e_node/remote" ) // TODO(random-liu): Replace this with standard kubelet launcher. // args is the type used to accumulate args from the flags with the same name. type args []string // String function of flag.Value func (a *args) String() string { return fmt.Sprint(*a) } // Set function of flag.Value func (a *args) Set(value string) error { // Note that we assume all white space in flag string is separating fields na := strings.Fields(value) *a = append(*a, na...) return nil } // kubeletArgs is the override kubelet args specified by the test runner. var kubeletArgs args var kubeletContainerized bool var hyperkubeImage string var genKubeletConfigFile bool func init() { flag.Var(&kubeletArgs, "kubelet-flags", "Kubelet flags passed to kubelet, this will override default kubelet flags in the test. Flags specified in multiple kubelet-flags will be concatenate.") flag.BoolVar(&kubeletContainerized, "kubelet-containerized", false, "Run kubelet in a docker container") flag.StringVar(&hyperkubeImage, "hyperkube-image", "", "Docker image with containerized kubelet") flag.BoolVar(&genKubeletConfigFile, "generate-kubelet-config-file", true, "The test runner will generate a Kubelet config file containing test defaults instead of passing default flags to the Kubelet.") } // RunKubelet starts kubelet and waits for termination signal. Once receives the // termination signal, it will stop the kubelet gracefully. func RunKubelet() { var err error // Enable monitorParent to make sure kubelet will receive termination signal // when test process exits. e := NewE2EServices(true /* monitorParent */) defer e.Stop() e.kubelet, err = e.startKubelet() if err != nil { klog.Fatalf("Failed to start kubelet: %v", err) } // Wait until receiving a termination signal. waitForTerminationSignal() } const ( // Ports of different e2e services. kubeletPort = "10250" kubeletReadOnlyPort = "10255" KubeletRootDirectory = "/var/lib/kubelet" // Health check url of kubelet kubeletHealthCheckURL = "http://127.0.0.1:" + kubeletReadOnlyPort + "/healthz" ) // startKubelet starts the Kubelet in a separate process or returns an error // if the Kubelet fails to start. func (e *E2EServices) startKubelet() (*server, error) { if kubeletContainerized && hyperkubeImage == "" { return nil, fmt.Errorf("the --hyperkube-image option must be set") } klog.Info("Starting kubelet") // set feature gates so we can check which features are enabled and pass the appropriate flags utilfeature.DefaultMutableFeatureGate.SetFromMap(framework.TestContext.FeatureGates) // Build kubeconfig kubeconfigPath, err := createKubeconfigCWD() if err != nil { return nil, err } // KubeletConfiguration file path kubeletConfigPath, err := kubeletConfigCWDPath() if err != nil { return nil, err } // Create pod directory podPath, err := createPodDirectory() if err != nil { return nil, err } e.rmDirs = append(e.rmDirs, podPath) err = createRootDirectory(KubeletRootDirectory) if err != nil { return nil, err } // PLEASE NOTE: If you set new KubeletConfiguration values or stop setting values here, // you must also update the flag names in kubeletConfigFlags! kubeletConfigFlags := []string{} // set up the default kubeletconfiguration kc, err := options.NewKubeletConfiguration() if err != nil { return nil, err } kc.CgroupRoot = "/" kubeletConfigFlags = append(kubeletConfigFlags, "cgroup-root") kc.VolumeStatsAggPeriod = metav1.Duration{Duration: 10 * time.Second} // Aggregate volumes frequently so tests don't need to wait as long kubeletConfigFlags = append(kubeletConfigFlags, "volume-stats-agg-period") kc.SerializeImagePulls = false kubeletConfigFlags = append(kubeletConfigFlags, "serialize-image-pulls") kc.StaticPodPath = podPath kubeletConfigFlags = append(kubeletConfigFlags, "pod-manifest-path") kc.FileCheckFrequency = metav1.Duration{Duration: 10 * time.Second} // Check file frequently so tests won't wait too long kubeletConfigFlags = append(kubeletConfigFlags, "file-check-frequency") // Assign a fixed CIDR to the node because there is no node controller. // Note: this MUST be in sync with the IP in // - cluster/gce/config-test.sh and // - test/e2e_node/conformance/run_test.sh. kc.PodCIDR = "10.100.0.0/24" kubeletConfigFlags = append(kubeletConfigFlags, "pod-cidr") kc.EvictionPressureTransitionPeriod = metav1.Duration{Duration: 30 * time.Second} kubeletConfigFlags = append(kubeletConfigFlags, "eviction-pressure-transition-period") kc.EvictionHard = map[string]string{ "memory.available": "250Mi", "nodefs.available": "10%", "nodefs.inodesFree": "5%", } kubeletConfigFlags = append(kubeletConfigFlags, "eviction-hard") kc.EvictionMinimumReclaim = map[string]string{ "nodefs.available": "5%", "nodefs.inodesFree": "5%", } kubeletConfigFlags = append(kubeletConfigFlags, "eviction-minimum-reclaim") var killCommand, restartCommand *exec.Cmd var isSystemd bool // Apply default kubelet flags. cmdArgs := []string{} if systemdRun, err := exec.LookPath("systemd-run"); err == nil { // On systemd services, detection of a service / unit works reliably while // detection of a process started from an ssh session does not work. // Since kubelet will typically be run as a service it also makes more // sense to test it that way isSystemd = true // We can ignore errors, to have GetTimestampFromWorkspaceDir() fallback // to the current time. cwd, _ := os.Getwd() // Use the timestamp from the current directory to name the systemd unit. unitTimestamp := remote.GetTimestampFromWorkspaceDir(cwd) unitName := fmt.Sprintf("kubelet-%s.service", unitTimestamp) if kubeletContainerized { cmdArgs = append(cmdArgs, systemdRun, "--unit="+unitName, "--slice=runtime.slice", "--remain-after-exit", "/usr/bin/docker", "run", "--name=kubelet", "--rm", "--privileged", "--net=host", "--pid=host", "-e HOST=/rootfs", "-e HOST_ETC=/host-etc", "-v", "/etc/localtime:/etc/localtime:ro", "-v", "/etc/machine-id:/etc/machine-id:ro", "-v", filepath.Dir(kubeconfigPath)+":/etc/kubernetes", "-v", "/:/rootfs:rw,rslave", "-v", "/run:/run", "-v", "/sys/fs/cgroup:/sys/fs/cgroup:rw", "-v", "/sys:/sys:rw", "-v", "/usr/bin/docker:/usr/bin/docker:ro", "-v", "/var/lib/cni:/var/lib/cni", "-v", "/var/lib/docker:/var/lib/docker", "-v", "/var/lib/kubelet:/var/lib/kubelet:rw,rslave", "-v", "/var/log:/var/log", "-v", podPath+":"+podPath+":rw", ) // if we will generate a kubelet config file, we need to mount that path into the container too if genKubeletConfigFile { cmdArgs = append(cmdArgs, "-v", filepath.Dir(kubeletConfigPath)+":"+filepath.Dir(kubeletConfigPath)+":rw") } cmdArgs = append(cmdArgs, hyperkubeImage, "/hyperkube", "kubelet", "--containerized") kubeconfigPath = "/etc/kubernetes/kubeconfig" } else { cmdArgs = append(cmdArgs, systemdRun, "--unit="+unitName, "--slice=runtime.slice", "--remain-after-exit", builder.GetKubeletServerBin()) } killCommand = exec.Command("systemctl", "kill", unitName) restartCommand = exec.Command("systemctl", "restart", unitName) e.logs["kubelet.log"] = LogFileData{ Name: "kubelet.log", JournalctlCommand: []string{"-u", unitName}, } kc.KubeletCgroups = "/kubelet.slice" kubeletConfigFlags = append(kubeletConfigFlags, "kubelet-cgroups") } else { cmdArgs = append(cmdArgs, builder.GetKubeletServerBin()) // TODO(random-liu): Get rid of this docker specific thing. cmdArgs = append(cmdArgs, "--runtime-cgroups=/docker-daemon") kc.KubeletCgroups = "/kubelet" kubeletConfigFlags = append(kubeletConfigFlags, "kubelet-cgroups") kc.SystemCgroups = "/system" kubeletConfigFlags = append(kubeletConfigFlags, "system-cgroups") } cmdArgs = append(cmdArgs, "--kubeconfig", kubeconfigPath, "--root-dir", KubeletRootDirectory, "--v", LOG_VERBOSITY_LEVEL, "--logtostderr", "--allow-privileged=true", ) // Apply test framework feature gates by default. This could also be overridden // by kubelet-flags. if len(framework.TestContext.FeatureGates) > 0 { cmdArgs = append(cmdArgs, "--feature-gates", cliflag.NewMapStringBool(&framework.TestContext.FeatureGates).String()) kc.FeatureGates = framework.TestContext.FeatureGates } if utilfeature.DefaultFeatureGate.Enabled(features.DynamicKubeletConfig) { // Enable dynamic config if the feature gate is enabled dynamicConfigDir, err := getDynamicConfigDir() if err != nil { return nil, err } cmdArgs = append(cmdArgs, "--dynamic-config-dir", dynamicConfigDir) } // Enable kubenet by default. cniBinDir, err := getCNIBinDirectory() if err != nil { return nil, err } cniConfDir, err := getCNIConfDirectory() if err != nil { return nil, err } cmdArgs = append(cmdArgs, "--network-plugin=kubenet", "--cni-bin-dir", cniBinDir, "--cni-conf-dir", cniConfDir) // Keep hostname override for convenience. if framework.TestContext.NodeName != "" { // If node name is specified, set hostname override. cmdArgs = append(cmdArgs, "--hostname-override", framework.TestContext.NodeName) } if framework.TestContext.ContainerRuntime != "" { cmdArgs = append(cmdArgs, "--container-runtime", framework.TestContext.ContainerRuntime) } if framework.TestContext.ContainerRuntimeEndpoint != "" { cmdArgs = append(cmdArgs, "--container-runtime-endpoint", framework.TestContext.ContainerRuntimeEndpoint) } if framework.TestContext.ImageServiceEndpoint != "" { cmdArgs = append(cmdArgs, "--image-service-endpoint", framework.TestContext.ImageServiceEndpoint) } // Write config file or flags, depending on whether --generate-kubelet-config-file was provided if genKubeletConfigFile { if err := writeKubeletConfigFile(kc, kubeletConfigPath); err != nil { return nil, err } // add the flag to load config from a file cmdArgs = append(cmdArgs, "--config", kubeletConfigPath) } else { // generate command line flags from the default config, since --generate-kubelet-config-file was not provided addKubeletConfigFlags(&cmdArgs, kc, kubeletConfigFlags) } // Override the default kubelet flags. cmdArgs = append(cmdArgs, kubeletArgs...) // Adjust the args if we are running kubelet with systemd. if isSystemd { adjustArgsForSystemd(cmdArgs) } cmd := exec.Command(cmdArgs[0], cmdArgs[1:]...) server := newServer( "kubelet", cmd, killCommand, restartCommand, []string{kubeletHealthCheckURL}, "kubelet.log", e.monitorParent, true /* restartOnExit */) return server, server.start() } // addKubeletConfigFlags adds the flags we care about from the provided kubelet configuration object func addKubeletConfigFlags(cmdArgs *[]string, kc *kubeletconfig.KubeletConfiguration, flags []string) { fs := pflag.NewFlagSet("kubelet", pflag.ExitOnError) options.AddKubeletConfigFlags(fs, kc) for _, name := range flags { *cmdArgs = append(*cmdArgs, fmt.Sprintf("--%s=%s", name, fs.Lookup(name).Value.String())) } } // writeKubeletConfigFile writes the kubelet config file based on the args and returns the filename func writeKubeletConfigFile(internal *kubeletconfig.KubeletConfiguration, path string) error { data, err := kubeletconfigcodec.EncodeKubeletConfig(internal, kubeletconfigv1beta1.SchemeGroupVersion) if err != nil { return err } // create the directory, if it does not exist dir := filepath.Dir(path) if err := os.MkdirAll(dir, 0755); err != nil { return err } // write the file if err := ioutil.WriteFile(path, data, 0755); err != nil { return err } return nil } // createPodDirectory creates pod directory. func createPodDirectory() (string, error) { cwd, err := os.Getwd() if err != nil { return "", fmt.Errorf("failed to get current working directory: %v", err) } path, err := ioutil.TempDir(cwd, "static-pods") if err != nil { return "", fmt.Errorf("failed to create static pod directory: %v", err) } return path, nil } // createKubeconfig creates a kubeconfig file at the fully qualified `path`. The parent dirs must exist. func createKubeconfig(path string) error { kubeconfig := []byte(`apiVersion: v1 kind: Config users: - name: kubelet clusters: - cluster: server: ` + getAPIServerClientURL() + ` insecure-skip-tls-verify: true name: local contexts: - context: cluster: local user: kubelet name: local-context current-context: local-context`) if err := ioutil.WriteFile(path, kubeconfig, 0666); err != nil { return err } return nil } func createRootDirectory(path string) error { if _, err := os.Stat(path); err != nil { if os.IsNotExist(err) { return os.MkdirAll(path, os.FileMode(0755)) } else { return err } } return nil } func kubeconfigCWDPath() (string, error) { cwd, err := os.Getwd() if err != nil { return "", fmt.Errorf("failed to get current working directory: %v", err) } return filepath.Join(cwd, "kubeconfig"), nil } func kubeletConfigCWDPath() (string, error) { cwd, err := os.Getwd() if err != nil { return "", fmt.Errorf("failed to get current working directory: %v", err) } // DO NOT name this file "kubelet" - you will overwrite the kubelet binary and be very confused :) return filepath.Join(cwd, "kubelet-config"), nil } // like createKubeconfig, but creates kubeconfig at current-working-directory/kubeconfig // returns a fully-qualified path to the kubeconfig file func createKubeconfigCWD() (string, error) { kubeconfigPath, err := kubeconfigCWDPath() if err != nil { return "", err } if err = createKubeconfig(kubeconfigPath); err != nil { return "", err } return kubeconfigPath, nil } // getCNIBinDirectory returns CNI directory. func getCNIBinDirectory() (string, error) { cwd, err := os.Getwd() if err != nil { return "", err } return filepath.Join(cwd, "cni", "bin"), nil } // getCNIConfDirectory returns CNI Configuration directory. func getCNIConfDirectory() (string, error) { cwd, err := os.Getwd() if err != nil { return "", err } return filepath.Join(cwd, "cni", "net.d"), nil } // getDynamicConfigDir returns the directory for dynamic Kubelet configuration func getDynamicConfigDir() (string, error) { cwd, err := os.Getwd() if err != nil { return "", err } return filepath.Join(cwd, "dynamic-kubelet-config"), nil } // adjustArgsForSystemd escape special characters in kubelet arguments for systemd. Systemd // may try to do auto expansion without escaping. func adjustArgsForSystemd(args []string) { for i := range args { args[i] = strings.Replace(args[i], "%", "%%", -1) args[i] = strings.Replace(args[i], "$", "$$", -1) } }