integration

Documentation

Overview

Package integration contains Tailscale integration tests.

This package is considered internal and the public API is subject to change without notice.

Index

• func BinaryDir(tb testing.TB) string
• func CleanupBinaries()
• func RunDERPAndSTUN(t testing.TB, logf logger.Logf, ipAddress string) (derpMap *tailcfg.DERPMap)
• func TailscaleBinary(tb testing.TB) string
• func TailscaledBinary(tb testing.TB) string
• type LogCatcher
  • func (lc *LogCatcher) Reset()
  • func (lc *LogCatcher) ServeHTTP(w http.ResponseWriter, r *http.Request)
  • func (lc *LogCatcher) StoreRawJSON()
  • func (lc *LogCatcher) UseLogf(fn logger.Logf)

Functions

func BinaryDir

func BinaryDir(tb testing.TB) string

BinaryDir returns a directory containing test tailscale and tailscaled binaries. If any test calls BinaryDir, there must be a TestMain function that calls CleanupBinaries after all tests are complete.

func CleanupBinaries

func CleanupBinaries()

CleanupBinaries cleans up any resources created by calls to BinaryDir, TailscaleBinary, or TailscaledBinary. It should be called from TestMain after all tests have completed.

func RunDERPAndSTUN

func RunDERPAndSTUN(t testing.TB, logf logger.Logf, ipAddress string) (derpMap *tailcfg.DERPMap)

RunDERPAndSTUN runs a local DERP and STUN server for tests, returning the derpMap that clients should use. This creates resources that must be cleaned up with the returned cleanup function.

func TailscaleBinary

func TailscaleBinary(tb testing.TB) string

TailscaleBinary returns the path to the test tailscale binary. If any test calls TailscaleBinary, there must be a TestMain function that calls CleanupBinaries after all tests are complete.

func TailscaledBinary

func TailscaledBinary(tb testing.TB) string

TailscaledBinary returns the path to the test tailscaled binary. If any test calls TailscaleBinary, there must be a TestMain function that calls CleanupBinaries after all tests are complete.

Types

type LogCatcher

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

LogCatcher is a minimal logcatcher for the logtail upload client.

func (*LogCatcher) Reset

func (lc *LogCatcher) Reset()

Reset clears the buffered logs from memory.

func (*LogCatcher) ServeHTTP

func (lc *LogCatcher) ServeHTTP(w http.ResponseWriter, r *http.Request)

func (*LogCatcher) StoreRawJSON

func (lc *LogCatcher) StoreRawJSON()

StoreRawJSON instructs lc to save the raw JSON uploads, rather than just the text.

func (*LogCatcher) UseLogf

func (lc *LogCatcher) UseLogf(fn logger.Logf)

UseLogf makes the logcatcher implementation use a given logf function to dump all logs to.