dind

Documentation

Overview

Package dind implements dind-specific kubetest code.

Package dind implements dind specific kubetest code.

Index

• func GetDockerVersion() (string, error)
• type Builder
  • func NewBuilder(kubeRoot, toolRoot string, control *process.Control) *Builder
  • func (b *Builder) Build() error
• type Deployer
  • func NewDeployer(kubecfg, image string, control *process.Control) (*Deployer, error)
  • func (d *Deployer) BuildTester(o *e2e.BuildTesterOptions) (e2e.Tester, error)
  • func (d *Deployer) Down() error
  • func (d *Deployer) DumpClusterLogs(localPath, gcsPath string) error
  • func (d *Deployer) GetClusterCreated(gcpProject string) (time.Time, error)
  • func (d *Deployer) IsUp() error
  • func (d *Deployer) TestSetup() error
  • func (d *Deployer) Up() error

Functions

func GetDockerVersion

func GetDockerVersion() (string, error)

GetDockerVersion reads the stable-status.txt file from bazel to get the docker artifact version.

Types

type Builder

type Builder struct {
	KubeRoot string
	ToolRoot string
	// contains filtered or unexported fields
}

Builder is capable of building the appropriate artifacts for the dind deployment.

func NewBuilder

func NewBuilder(kubeRoot, toolRoot string, control *process.Control) *Builder

NewBuilder returns an object capable of building the required k8s artifacts for dind.

func (*Builder) Build

func (b *Builder) Build() error

Build creates the k8s artifacts for dind.

type Deployer

type Deployer struct {
	RealKubecfg string
	// contains filtered or unexported fields
}

Deployer stores information necessary to deploy a cluster inside a docker container.

func NewDeployer

func NewDeployer(kubecfg, image string, control *process.Control) (*Deployer, error)

NewDeployer instantiates a new Deployer struct with specified args.

kubecfg: path to a ~/.kube/config type file that authenticates to the cluster image: name of the dind image to use, will choose a default if empty control: used for creating subprocesses.

func (*Deployer) BuildTester

func (d *Deployer) BuildTester(o *e2e.BuildTesterOptions) (e2e.Tester, error)

BuildTester returns an object that knows how to test the cluster it deployed.

func (*Deployer) Down

func (d *Deployer) Down() error

Down stops and removes the cluster container.

func (*Deployer) DumpClusterLogs

func (d *Deployer) DumpClusterLogs(localPath, gcsPath string) error

DumpClusterLogs is a no-op.

func (*Deployer) GetClusterCreated

func (d *Deployer) GetClusterCreated(gcpProject string) (time.Time, error)

GetClusterCreated returns the start time of the cluster container. If the container doesn't exist, has no start time, or has a malformed start time, then an error is returned.

func (*Deployer) IsUp

func (d *Deployer) IsUp() error

IsUp returns nil if the apiserver is running, or the error received while checking.

func (*Deployer) TestSetup

func (d *Deployer) TestSetup() error

TestSetup is a no-op.

func (*Deployer) Up

func (d *Deployer) Up() error

Up synchronously starts a cluster, or times out.