integration

README

This document has moved to https://minikube.sigs.k8s.io/docs/contrib/testing/#integration-tests

Documentation

Index

• func CanCleanup() bool
• func Cleanup(t *testing.T, profile string, cancel context.CancelFunc)
• func CleanupWithLogs(t *testing.T, profile string, cancel context.CancelFunc)
• func DockerDriver() bool
• func HyperVDriver() bool
• func KicDriver() bool
• func MaybeParallel(t *testing.T)
• func Minutes(n int) time.Duration
• func NeedsPortForward() bool
• func NoneDriver() bool
• func PodWait(ctx context.Context, t *testing.T, profile string, ns string, selector string, ...) ([]string, error)
• func PodmanDriver() bool
• func ReadLineWithTimeout(b *bufio.Reader, timeout time.Duration) (string, error)
• func Seconds(n int) time.Duration
• func StartArgs() []string
• func Status(ctx context.Context, t *testing.T, path string, profile string, key string) string
• func Target() string
• func TestMain(m *testing.M)
• func UniqueProfileName(prefix string) string
• type RunResult
  • func Run(t *testing.T, cmd *exec.Cmd) (*RunResult, error)
  • func (rr RunResult) Command() string
  • func (rr RunResult) Output() string
• type StartSession
  • func Start(t *testing.T, cmd *exec.Cmd) (*StartSession, error)
  • func (ss *StartSession) Stop(t *testing.T)

Functions

func CanCleanup

func CanCleanup() bool

CanCleanup returns if cleanup is allowed

func Cleanup

func Cleanup(t *testing.T, profile string, cancel context.CancelFunc)

Cleanup cleans up after a test run

func CleanupWithLogs

func CleanupWithLogs(t *testing.T, profile string, cancel context.CancelFunc)

CleanupWithLogs cleans up after a test run, fetching logs and deleting the profile

func DockerDriver

func DockerDriver() bool

DockerDriver returns whether or not this test is using the docker or podman driver

func HyperVDriver

func HyperVDriver() bool

HyperVDriver returns whether or not this test is using the Hyper-V driver

func KicDriver

func KicDriver() bool

KicDriver returns whether or not this test is using the docker or podman driver

func MaybeParallel

func MaybeParallel(t *testing.T)

MaybeParallel sets that the test should run in parallel

func Minutes

func Minutes(n int) time.Duration

Minutes will return timeout in minutes based on how slow the machine is

func NeedsPortForward

func NeedsPortForward() bool

NeedsPortForward returns access to endpoints with this driver needs port forwarding (Docker on non-Linux platforms requires ports to be forwarded to 127.0.0.1)

func NoneDriver

func NoneDriver() bool

NoneDriver returns whether or not this test is using the none driver

func PodWait

func PodWait(ctx context.Context, t *testing.T, profile string, ns string, selector string, timeout time.Duration) ([]string, error)

PodWait waits for pods to achieve a running state.

func PodmanDriver

func PodmanDriver() bool

PodmanDriver returns whether or not this test is using the docker or podman driver

func ReadLineWithTimeout

func ReadLineWithTimeout(b *bufio.Reader, timeout time.Duration) (string, error)

ReadLineWithTimeout reads a line of text from a buffer with a timeout

func Seconds

func Seconds(n int) time.Duration

Seconds will return timeout in minutes based on how slow the machine is

func StartArgs

func StartArgs() []string

StartArgs returns the arguments normally used for starting minikube

func Status

func Status(ctx context.Context, t *testing.T, path string, profile string, key string) string

Status returns a minikube component status as a string

func Target

func Target() string

Target returns where the minikube binary can be found

func TestMain

func TestMain(m *testing.M)

TestMain is the test main

func UniqueProfileName

func UniqueProfileName(prefix string) string

UniqueProfileName returns a reasonably unique profile name

Types

type RunResult

type RunResult struct {
	Stdout   *bytes.Buffer
	Stderr   *bytes.Buffer
	ExitCode int
	Args     []string
}

RunResult stores the result of an cmd.Run call

func Run

func Run(t *testing.T, cmd *exec.Cmd) (*RunResult, error)

Run is a test helper to log a command being executed \_(ツ)_/¯

func (RunResult) Command

func (rr RunResult) Command() string

Command returns a human readable command string that does not induce eye fatigue

func (RunResult) Output

func (rr RunResult) Output() string

Output returns human-readable output for an execution result

type StartSession

type StartSession struct {
	Stdout *bufio.Reader
	Stderr *bufio.Reader
	// contains filtered or unexported fields
}

StartSession stores the result of an cmd.Start call

func Start

func Start(t *testing.T, cmd *exec.Cmd) (*StartSession, error)

Start starts a process in the background, streaming output

func (*StartSession) Stop

func (ss *StartSession) Stop(t *testing.T)

Stop stops the started process