register

Documentation

Index

• Variables
• func Register(t *Test)
• type Flag
• type Test
  • func (t *Test) HasFlag(flag Flag) bool

Variables

var (
	// platforms that have no Internet access
	PlatformsNoInternet = []string{
		"qemu",
		"qemu-unpriv",
	}
)

var Tests = map[string]*Test{}

Registered tests live here. Mapping of names to tests.

Functions

func Register

func Register(t *Test)

Register is usually called in init() functions and is how kola test harnesses knows which tests it can choose from. Panics if existing name is registered

Types

type Flag

type Flag int

const (
	NoSSHKeyInUserData     Flag = iota // don't inject SSH key into Ignition/cloud-config
	NoSSHKeyInMetadata                 // don't add SSH key to platform metadata
	NoEmergencyShellCheck              // don't check console output for emergency shell invocation
	NoEnableSelinux                    // don't enable selinux when starting or rebooting a machine
	RequiresInternetAccess             // run the test only if the platform supports Internet access
)

type Test

type Test struct {
	Name             string // should be unique
	Run              func(cluster.TestCluster)
	NativeFuncs      map[string]func() error
	UserData         *conf.UserData
	UserDataV3       *conf.UserData
	ClusterSize      int
	Platforms        []string // whitelist of platforms to run test against -- defaults to all
	ExcludePlatforms []string // blacklist of platforms to ignore -- defaults to none
	Distros          []string // whitelist of distributions to run test against -- defaults to all
	ExcludeDistros   []string // blacklist of distributions to ignore -- defaults to none
	Architectures    []string // whitelist of machine architectures supported -- defaults to all
	Flags            []Flag   // special-case options for this test

	// FailFast skips any sub-test that occurs after a sub-test has
	// failed.
	FailFast bool

	// MinVersion prevents the test from executing on CoreOS machines
	// less than MinVersion. This will be ignored if the name fully
	// matches without globbing.
	MinVersion semver.Version

	// EndVersion prevents the test from executing on CoreOS machines
	// greater than or equal to EndVersion. This will be ignored if
	// the name fully matches without globbing.
	EndVersion semver.Version
}

Test provides the main test abstraction for kola. The run function is the actual testing function while the other fields provide ways to statically declare state of the platform.TestCluster before the test function is run.

func (*Test) HasFlag

func (t *Test) HasFlag(flag Flag) bool