kola

Documentation

Index

• Variables
• func CleanOutputDir(outputDir string) (string, error)
• func MakeConfigs(url, cfg string, csize int) []string
• func RegisterTestOption(name, option string)
• func RunTest(t *register.Test, pltfrm, outputDir string) (err error)
• func RunTests(pattern, pltfrm, outputDir string) error
• type NativeRunner

Variables

var (
	Options     = platform.Options{}
	QEMUOptions = qemu.Options{Options: &Options}      // glue to set platform options from main
	GCEOptions  = gcloudapi.Options{Options: &Options} // glue to set platform options from main
	AWSOptions  = awsapi.Options{Options: &Options}    // glue to set platform options from main

	TestParallelism int    //glue var to set test parallelism from main
	TAPFile         string // if not "", write TAP results here

)

Functions

func CleanOutputDir

func CleanOutputDir(outputDir string) (string, error)

CleanOutputDir creates an empty directory, any existing data will be wiped!

func MakeConfigs

func MakeConfigs(url, cfg string, csize int) []string

replaces $discovery with discover url in etcd cloud config and replaces $name with a unique name

func RegisterTestOption

func RegisterTestOption(name, option string)

RegisterTestOption registers any options that need visibility inside a Test. Panics if existing option is already registered. Each test has global view of options.

func RunTest

func RunTest(t *register.Test, pltfrm, outputDir string) (err error)

RunTest is a harness for running a single test. It is used by RunTests but can also be used directly by binaries that aim to run a single test. Using RunTest directly means that TestCluster flags used to filter out tests such as 'Platforms' or 'MinVersion' are not respected. outputDir is where various test logs and data will be written for analysis after the test run. It should already exist.

func RunTests

func RunTests(pattern, pltfrm, outputDir string) error

RunTests is a harness for running multiple tests in parallel. Filters tests based on a glob pattern and by platform. Has access to all tests either registered in this package or by imported packages that register tests in their init() function. outputDir is where various test logs and data will be written for analysis after the test run. If it already exists it will be erased!

Types

type NativeRunner

type NativeRunner func(funcName string, m platform.Machine) error

NativeRunner is a closure passed to all kola test functions and used to run native go functions directly on kola machines. It is necessary glue until kola does introspection.