windows

Documentation

Overview

Package windows contains the code to run the e2e tests on Windows

Package windows contains helpers for Windows E2E tests

Index

• func CreateIISSite(host *components.RemoteHost, site []IISSiteDefinition) error
• func InstallIIS(host *components.RemoteHost) error
• type BaseAgentInstallerSuite
  • func (b *BaseAgentInstallerSuite[Env]) BeforeTest(suiteName, testName string)
  • func (b *BaseAgentInstallerSuite[Env]) InstallAgent(host *components.RemoteHost, options ...windowsAgent.InstallAgentOption) (string, error)
  • func (b *BaseAgentInstallerSuite[Env]) NewTestClientForHost(host *components.RemoteHost) *platformCommon.TestClient
  • func (b *BaseAgentInstallerSuite[Env]) SetupSuite()
• type IISApplicationDefinition
• type IISSiteDefinition
• type RemoteExecutable
  • func NewRemoteExecutable(vm *components.RemoteHost, t *testing.T, filespec string, basepath string) *RemoteExecutable
  • func (rs *RemoteExecutable) CopyFiles() error
  • func (rs *RemoteExecutable) CreateRemotePaths() error
  • func (rs *RemoteExecutable) FindTestPrograms() error
  • func (rs *RemoteExecutable) RunTests(timeoutarg string) error

Functions

func CreateIISSite

func CreateIISSite(host *components.RemoteHost, site []IISSiteDefinition) error

CreateIISSite creates an IIS site on the target machine

func InstallIIS

func InstallIIS(host *components.RemoteHost) error

InstallIIS installs IIS on the target machine

Types

type BaseAgentInstallerSuite

type BaseAgentInstallerSuite[Env any] struct {
	e2e.BaseSuite[Env]

	AgentPackage *windowsAgent.Package
	OutputDir    string
}

BaseAgentInstallerSuite is a base class for the Windows Agent installer suites

func (*BaseAgentInstallerSuite[Env]) BeforeTest

func (b *BaseAgentInstallerSuite[Env]) BeforeTest(suiteName, testName string)

BeforeTest overrides the base BeforeTest to perform some additional per-test setup like configuring the output directory.

func (*BaseAgentInstallerSuite[Env]) InstallAgent

func (b *BaseAgentInstallerSuite[Env]) InstallAgent(host *components.RemoteHost, options ...windowsAgent.InstallAgentOption) (string, error)

InstallAgent installs the Agent on a given Windows host. It will pass all the parameters to the MSI installer.

func (*BaseAgentInstallerSuite[Env]) NewTestClientForHost

func (b *BaseAgentInstallerSuite[Env]) NewTestClientForHost(host *components.RemoteHost) *platformCommon.TestClient

NewTestClientForHost creates a new TestClient for a given host.

func (*BaseAgentInstallerSuite[Env]) SetupSuite

func (b *BaseAgentInstallerSuite[Env]) SetupSuite()

SetupSuite overrides the base SetupSuite to perform some additional setups like setting the package to install.

type IISApplicationDefinition

type IISApplicationDefinition struct {
	Name string // name of the application.  this will also be the path
	// e.g. app1/dir2
	PhysicalPath string // physical path to the application

}

IISApplicationDefinition represents an IIS application definition

type IISSiteDefinition

type IISSiteDefinition struct {
	Name        string //  name of the site
	BindingPort string // port to bind to, of the form '*:8081'
	SiteDir     string // directory to create for the site
	// can be empty for default.
	AssetsDir    string // directory to copy for assets
	Applications []IISApplicationDefinition
}

IISSiteDefinition represents an IIS site definition

type RemoteExecutable

type RemoteExecutable struct {
	// contains filtered or unexported fields
}

RemoteExecutable is a helper struct to run tests on a remote host

func NewRemoteExecutable

func NewRemoteExecutable(vm *components.RemoteHost, t *testing.T, filespec string, basepath string) *RemoteExecutable

NewRemoteExecutable creates a new RemoteExecutable

func (*RemoteExecutable) CopyFiles

func (rs *RemoteExecutable) CopyFiles() error

CopyFiles copies the test programs to the remote host.

CopyFiles also assumes that if there's a "testdata" directory in the same directory as the test program, that that should be copied too.

func (*RemoteExecutable) CreateRemotePaths

func (rs *RemoteExecutable) CreateRemotePaths() error

CreateRemotePaths creates the remote paths for the test programs

Takes the path to the test programs, and creates an identical directory tree on the remote host.

func (*RemoteExecutable) FindTestPrograms

func (rs *RemoteExecutable) FindTestPrograms() error

FindTestPrograms finds the locally available test programs.

it walks the root directory (provided at initialization), looking for any file that matches the provided filespec (usually `testsuite.exe`). If it finds that, it stores the full path for future copying.

func (*RemoteExecutable) RunTests

func (rs *RemoteExecutable) RunTests(timeoutarg string) error

RunTests iterates through all of the tests that were copied and executes them one by one. it captures the output, and logs it.