minikube/test/integration/functional_test_tunnel_test.go

436 lines
14 KiB
Go

//go:build integration
/*
Copyright 2018 The Kubernetes Authors All rights reserved.
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 integration
import (
"context"
"fmt"
"io"
"net"
"net/http"
"os/exec"
"path/filepath"
"runtime"
"strings"
"testing"
"time"
"k8s.io/apimachinery/pkg/util/wait"
"github.com/pkg/errors"
"k8s.io/minikube/pkg/kapi"
"k8s.io/minikube/pkg/minikube/config"
"k8s.io/minikube/pkg/minikube/detect"
"k8s.io/minikube/pkg/minikube/reason"
"k8s.io/minikube/pkg/util"
"k8s.io/minikube/pkg/util/retry"
)
var tunnelSession StartSession
var (
hostname = ""
domain = "nginx-svc.default.svc.cluster.local."
)
// validateTunnelCmd makes sure the minikube tunnel command works as expected
func validateTunnelCmd(ctx context.Context, t *testing.T, profile string) {
ctx, cancel := context.WithTimeout(ctx, Minutes(20))
type validateFunc func(context.Context, *testing.T, string)
defer cancel()
// Serial tests
t.Run("serial", func(t *testing.T) {
tests := []struct {
name string
validator validateFunc
}{
{"RunSecondTunnel", validateNoSecondTunnel}, // Ensure no two tunnels run simultaneously
{"StartTunnel", validateTunnelStart}, // Start tunnel
{"WaitService", validateServiceStable}, // Wait for service is stable
{"AccessDirect", validateAccessDirect}, // Access test for loadbalancer IP
{"DNSResolutionByDig", validateDNSDig}, // DNS forwarding test by dig
{"DNSResolutionByDscacheutil", validateDNSDscacheutil}, // DNS forwarding test by dscacheutil
{"AccessThroughDNS", validateAccessDNS}, // Access test for absolute dns name
{"DeleteTunnel", validateTunnelDelete}, // Stop tunnel and delete cluster
}
for _, tc := range tests {
tc := tc
if ctx.Err() == context.DeadlineExceeded {
t.Fatalf("Unable to run more tests (deadline exceeded)")
}
t.Run(tc.name, func(t *testing.T) {
tc.validator(ctx, t, profile)
})
}
})
}
// checkRoutePassword skips tunnel test if sudo password required for route
func checkRoutePassword(t *testing.T) {
if !KicDriver() && runtime.GOOS != "windows" {
if err := exec.Command("sudo", "-n", "ifconfig").Run(); err != nil {
t.Skipf("password required to execute 'route', skipping testTunnel: %v", err)
}
}
}
// checkDNSForward skips DNS forwarding test if runtime is not supported
func checkDNSForward(t *testing.T) {
// Not all platforms support DNS forwarding
if runtime.GOOS != "darwin" || KicDriver() {
t.Skip("DNS forwarding is only supported for Hyperkit on Darwin, skipping test DNS forwarding")
}
}
// getKubeDNSIP returns kube-dns ClusterIP
func getKubeDNSIP(t *testing.T, profile string) string {
// Load ClusterConfig
c, err := config.Load(profile)
if err != nil {
t.Errorf("failed to load cluster config: %v", err)
}
// Get ipNet
_, ipNet, err := net.ParseCIDR(c.KubernetesConfig.ServiceCIDR)
if err != nil {
t.Errorf("failed to parse service CIDR: %v", err)
}
// Get kube-dns ClusterIP
ip, err := util.GetDNSIP(ipNet.String())
if err != nil {
t.Errorf("failed to get kube-dns IP: %v", err)
}
return ip.String()
}
// validateTunnelStart starts `minikube tunnel`
func validateTunnelStart(ctx context.Context, t *testing.T, profile string) {
checkRoutePassword(t)
args := []string{"-p", profile, "tunnel", "--alsologtostderr"}
ss, err := Start(t, exec.CommandContext(ctx, Target(), args...))
if err != nil {
t.Errorf("failed to start a tunnel: args %q: %v", args, err)
}
tunnelSession = *ss
}
// validateNoSecondTunnel ensures only 1 tunnel can run simultaneously
func validateNoSecondTunnel(ctx context.Context, t *testing.T, profile string) {
checkRoutePassword(t)
type SessInfo struct {
Stdout string
Stderr string
ExitCode int
}
sessCh := make(chan SessInfo)
sessions := make([]*StartSession, 2)
var runTunnel = func(idx int) {
args := []string{"-p", profile, "tunnel", "--alsologtostderr"}
ctx2, cancel := context.WithTimeout(ctx, Seconds(15))
defer cancel()
session, err := Start(t, exec.CommandContext(ctx2, Target(), args...))
if err != nil {
t.Errorf("failed to start tunnel: %v", err)
}
sessions[idx] = session
stderr, err := io.ReadAll(session.Stderr)
if err != nil {
t.Logf("Failed to read stderr: %v", err)
}
stdout, err := io.ReadAll(session.Stdout)
if err != nil {
t.Logf("Failed to read stdout: %v", err)
}
exitCode := 0
err = session.cmd.Wait()
if err != nil {
if exErr, ok := err.(*exec.ExitError); !ok {
t.Logf("failed to coerce exit error: %v", err)
exitCode = -1
} else {
exitCode = exErr.ExitCode()
}
}
sessCh <- SessInfo{Stdout: string(stdout), Stderr: string(stderr), ExitCode: exitCode}
}
// One of the two processes must fail to acquire lock and die. This should be the first process to die.
go runTunnel(0)
go runTunnel(1)
sessInfo := <-sessCh
if sessInfo.ExitCode != reason.SvcTunnelAlreadyRunning.ExitCode {
t.Errorf("tunnel command failed with unexpected error: exit code %d. stderr: %s\n stdout: %s", sessInfo.ExitCode, sessInfo.Stderr, sessInfo.Stdout)
}
for _, sess := range sessions {
sess.Stop(t)
}
<-sessCh
}
// validateServiceStable starts nginx pod, nginx service and waits nginx having loadbalancer ingress IP
func validateServiceStable(ctx context.Context, t *testing.T, profile string) {
if detect.GithubActionRunner() && runtime.GOOS == "darwin" {
t.Skip("The test WaitService is broken on github actions in macos https://github.com/kubernetes/minikube/issues/8434")
}
checkRoutePassword(t)
setupSucceeded := t.Run("Setup", func(t *testing.T) {
client, err := kapi.Client(profile)
if err != nil {
t.Fatalf("failed to get Kubernetes client for %q: %v", profile, err)
}
// Start the "nginx" pod.
rr, err := Run(t, exec.CommandContext(ctx, "kubectl", "--context", profile, "apply", "-f", filepath.Join(*testdataDir, "testsvc.yaml")))
if err != nil {
t.Fatalf("%s failed: %v", rr.Command(), err)
}
if _, err := PodWait(ctx, t, profile, "default", "run=nginx-svc", Minutes(4)); err != nil {
t.Fatalf("wait: %v", err)
}
if err := kapi.WaitForService(client, "default", "nginx-svc", true, 1*time.Second, Minutes(2)); err != nil {
t.Fatal(errors.Wrap(err, "Error waiting for nginx service to be up"))
}
})
if !setupSucceeded {
t.Fatal("Failed setup")
}
t.Run("IngressIP", func(t *testing.T) {
if HyperVDriver() {
t.Skip("The test WaitService/IngressIP is broken on hyperv https://github.com/kubernetes/minikube/issues/8381")
}
// Wait until the nginx-svc has a loadbalancer ingress IP
err := wait.PollUntilContextTimeout(ctx, 5*time.Second, Minutes(3), true, func(ctx context.Context) (bool, error) {
rr, err := Run(t, exec.CommandContext(ctx, "kubectl", "--context", profile, "get", "svc", "nginx-svc", "-o", "jsonpath={.status.loadBalancer.ingress[0].ip}"))
if err != nil {
return false, err
}
if len(rr.Stdout.String()) > 0 {
hostname = rr.Stdout.String()
return true, nil
}
return false, nil
})
if err != nil {
t.Errorf("nginx-svc svc.status.loadBalancer.ingress never got an IP: %v", err)
rr, err := Run(t, exec.CommandContext(ctx, "kubectl", "--context", profile, "get", "svc", "nginx-svc"))
if err != nil {
t.Errorf("%s failed: %v", rr.Command(), err)
}
t.Logf("failed to kubectl get svc nginx-svc:\n%s", rr.Output())
}
})
}
// validateAccessDirect validates if the test service can be accessed with LoadBalancer IP from host
func validateAccessDirect(ctx context.Context, t *testing.T, profile string) {
if runtime.GOOS == "windows" {
t.Skip("skipping: access direct test is broken on windows: https://github.com/kubernetes/minikube/issues/8304")
}
if detect.GithubActionRunner() && runtime.GOOS == "darwin" {
t.Skip("skipping: access direct test is broken on github actions on macos https://github.com/kubernetes/minikube/issues/8434")
}
checkRoutePassword(t)
got := []byte{}
url := fmt.Sprintf("http://%s", hostname)
fetch := func() error {
h := &http.Client{Timeout: time.Second * 10}
resp, err := h.Get(url)
if err != nil {
return &retry.RetriableError{Err: err}
}
if resp.Body == nil {
return &retry.RetriableError{Err: fmt.Errorf("no body")}
}
defer resp.Body.Close()
got, err = io.ReadAll(resp.Body)
if err != nil {
return &retry.RetriableError{Err: err}
}
return nil
}
// Check if the nginx service can be accessed
if err := retry.Expo(fetch, 3*time.Second, Minutes(2), 13); err != nil {
t.Errorf("failed to hit nginx at %q: %v", url, err)
rr, err := Run(t, exec.CommandContext(ctx, "kubectl", "--context", profile, "get", "svc", "nginx-svc"))
if err != nil {
t.Errorf("%s failed: %v", rr.Command(), err)
}
t.Logf("failed to kubectl get svc nginx-svc:\n%s", rr.Stdout)
}
want := "Welcome to nginx!"
if strings.Contains(string(got), want) {
t.Logf("tunnel at %s is working!", url)
} else {
t.Errorf("expected body to contain %q, but got *%q*", want, got)
}
}
// validateDNSDig validates if the DNS forwarding works by dig command DNS lookup
// NOTE: DNS forwarding is experimental: https://minikube.sigs.k8s.io/docs/handbook/accessing/#dns-resolution-experimental
func validateDNSDig(ctx context.Context, t *testing.T, profile string) {
if detect.GithubActionRunner() && runtime.GOOS == "darwin" {
t.Skip("skipping: access direct test is broken on github actions on macos https://github.com/kubernetes/minikube/issues/8434")
}
checkRoutePassword(t)
checkDNSForward(t)
ip := getKubeDNSIP(t, profile)
dnsIP := fmt.Sprintf("@%s", ip)
// Check if the dig DNS lookup works toward kube-dns IP
rr, err := Run(t, exec.CommandContext(ctx, "dig", "+time=5", "+tries=3", dnsIP, domain, "A"))
// dig command returns its output for stdout only. So we don't check stderr output.
if err != nil {
t.Errorf("failed to resolve DNS name: %v", err)
}
want := "ANSWER: 1"
if strings.Contains(rr.Stdout.String(), want) {
t.Logf("DNS resolution by dig for %s is working!", domain)
} else {
t.Errorf("expected body to contain %q, but got *%q*", want, rr.Stdout.String())
// debug DNS configuration
rr, err := Run(t, exec.CommandContext(ctx, "scutil", "--dns"))
if err != nil {
t.Errorf("%s failed: %v", rr.Command(), err)
}
t.Logf("debug for DNS configuration:\n%s", rr.Stdout.String())
}
}
// validateDNSDscacheutil validates if the DNS forwarding works by dscacheutil command DNS lookup
// NOTE: DNS forwarding is experimental: https://minikube.sigs.k8s.io/docs/handbook/accessing/#dns-resolution-experimental
func validateDNSDscacheutil(ctx context.Context, t *testing.T, _ string) {
if detect.GithubActionRunner() && runtime.GOOS == "darwin" {
t.Skip("skipping: access direct test is broken on github actions on macos https://github.com/kubernetes/minikube/issues/8434")
}
checkRoutePassword(t)
checkDNSForward(t)
// Check if the dscacheutil DNS lookup works toward target domain
rr, err := Run(t, exec.CommandContext(ctx, "dscacheutil", "-q", "host", "-a", "name", domain))
// If dscacheutil cannot lookup dns record, it returns no output. So we don't check stderr output.
if err != nil {
t.Errorf("failed to resolve DNS name: %v", err)
}
want := hostname
if strings.Contains(rr.Stdout.String(), want) {
t.Logf("DNS resolution by dscacheutil for %s is working!", domain)
} else {
t.Errorf("expected body to contain %q, but got *%q*", want, rr.Stdout.String())
}
}
// validateAccessDNS validates if the test service can be accessed with DNS forwarding from host
// NOTE: DNS forwarding is experimental: https://minikube.sigs.k8s.io/docs/handbook/accessing/#dns-resolution-experimental
func validateAccessDNS(_ context.Context, t *testing.T, profile string) {
if detect.GithubActionRunner() && runtime.GOOS == "darwin" {
t.Skip("skipping: access direct test is broken on github actions on macos https://github.com/kubernetes/minikube/issues/8434")
}
checkRoutePassword(t)
checkDNSForward(t)
got := []byte{}
url := fmt.Sprintf("http://%s", domain)
ip := getKubeDNSIP(t, profile)
dnsIP := fmt.Sprintf("%s:53", ip)
// Set kube-dns dial
kubeDNSDial := func(ctx context.Context, network, address string) (net.Conn, error) {
d := net.Dialer{}
return d.DialContext(ctx, "udp", dnsIP)
}
// Set kube-dns resolver
r := net.Resolver{
PreferGo: true,
Dial: kubeDNSDial,
}
dialer := net.Dialer{Resolver: &r}
// Use kube-dns resolver
transport := &http.Transport{
Dial: dialer.Dial,
DialContext: dialer.DialContext,
}
fetch := func() error {
h := &http.Client{Timeout: time.Second * 10, Transport: transport}
resp, err := h.Get(url)
if err != nil {
return &retry.RetriableError{Err: err}
}
if resp.Body == nil {
return &retry.RetriableError{Err: fmt.Errorf("no body")}
}
defer resp.Body.Close()
got, err = io.ReadAll(resp.Body)
if err != nil {
return &retry.RetriableError{Err: err}
}
return nil
}
// Access nginx-svc through DNS resolution
if err := retry.Expo(fetch, 3*time.Second, Seconds(30), 10); err != nil {
t.Errorf("failed to hit nginx with DNS forwarded %q: %v", url, err)
}
want := "Welcome to nginx!"
if strings.Contains(string(got), want) {
t.Logf("tunnel at %s is working!", url)
} else {
t.Errorf("expected body to contain %q, but got *%q*", want, got)
}
}
// validateTunnelDelete stops `minikube tunnel`
func validateTunnelDelete(_ context.Context, t *testing.T, _ string) {
checkRoutePassword(t)
// Stop tunnel
tunnelSession.Stop(t)
}