kubetest

Documentation

Index

• func NewClientFromKubeconfig(path string) (kubernetes.Interface, error)
• func PodsAreGone(client kubernetes.Interface, labels string) func(*ScenarioContext) error
• func PodsAreReady(client kubernetes.Interface, replicas int, labels string) func(*ScenarioContext) error
• func ServiceIsReady(client kubernetes.Interface, service string) func(*ScenarioContext) error
• type Action
  • func Actions(ss ...Action) Action
  • func ClientFails(client kubernetes.Interface, command string, opts *RunOptions) Action
  • func ClientSucceeds(client kubernetes.Interface, command string, opts *RunOptions) Action
  • func CreatedManifests(client kubernetes.Interface, paths ...string) Action
  • func RunFails(client kubernetes.Interface, image string, name string, command []string, ...) Action
  • func RunSucceeds(client kubernetes.Interface, image string, name string, command []string, ...) Action
• type CleanUp
• type RunOptions
• type Scenario
  • func (s Scenario) Run(t *testing.T) bool
• type ScenarioContext
  • func (ctx *ScenarioContext) AddCleanUp(f CleanUp)
• type TestSuite

Functions

func NewClientFromKubeconfig

func NewClientFromKubeconfig(path string) (kubernetes.Interface, error)

func PodsAreGone

func PodsAreGone(client kubernetes.Interface, labels string) func(*ScenarioContext) error

PodsAreGone waits for pods being gone for the given labels. Returns a func directly (not Setup or Conditions) as it can be used in Given and When steps

func PodsAreReady

func PodsAreReady(client kubernetes.Interface, replicas int, labels string) func(*ScenarioContext) error

PodsAreReady waits for a number if replicas matching the given labels to be ready. Returns a func directly (not Setup or Conditions) as it can be used in Given and When steps

func ServiceIsReady

func ServiceIsReady(client kubernetes.Interface, service string) func(*ScenarioContext) error

ServiceIsReady waits for given service to exist and have at least 1 endpoint. Returns a func directly (not Setup or Conditions) as it can be used in Given and When steps

Types

type Action

type Action func(ctx *ScenarioContext) error

func Actions

func Actions(ss ...Action) Action

func ClientFails

func ClientFails(client kubernetes.Interface, command string, opts *RunOptions) Action

func ClientSucceeds

func ClientSucceeds(client kubernetes.Interface, command string, opts *RunOptions) Action

func CreatedManifests

func CreatedManifests(client kubernetes.Interface, paths ...string) Action

func RunFails

func RunFails(client kubernetes.Interface, image string, name string, command []string, opts *RunOptions) Action

func RunSucceeds

func RunSucceeds(client kubernetes.Interface, image string, name string, command []string, opts *RunOptions) Action

type CleanUp

type CleanUp func() error

type RunOptions

type RunOptions struct {
	ServiceAccount     string
	TokenAudience      string
	ClientCertificates bool
}

type Scenario

type Scenario struct {
	KubeClient kubernetes.Interface

	Name        string
	Description string

	Given Action
	When  Action
	Then  Action
}

func (Scenario) Run

func (s Scenario) Run(t *testing.T) bool

type ScenarioContext

type ScenarioContext struct {
	Namespace string
	CleanUp   []CleanUp
}

func (*ScenarioContext) AddCleanUp

func (ctx *ScenarioContext) AddCleanUp(f CleanUp)

type TestSuite

type TestSuite func(t *testing.T)