e2e

Documentation

Overview

Package e2e implements end to end testing.

Index

• Constants
• func Byf(format string, a ...interface{})
• func ClusterUpgradeConformanceSpec(ctx context.Context, inputGetter func() ClusterUpgradeConformanceSpecInput)
• func ClusterctlUpgradeSpec(ctx context.Context, inputGetter func() ClusterctlUpgradeSpecInput)
• func HaveControllerRef(kind string, owner metav1.Object) types.GomegaMatcher
• func HaveValidVersion(version string) types.GomegaMatcher
• func K8SConformanceSpec(ctx context.Context, inputGetter func() K8SConformanceSpecInput)
• func KCPAdoptionSpec(ctx context.Context, inputGetter func() KCPAdoptionSpecInput)
• func KCPUpgradeSpec(ctx context.Context, inputGetter func() KCPUpgradeSpecInput)
• func MachineDeploymentScaleSpec(ctx context.Context, inputGetter func() MachineDeploymentScaleSpecInput)
• func MachineDeploymentUpgradesSpec(ctx context.Context, inputGetter func() MachineDeploymentUpgradesSpecInput)
• func MachineRemediationSpec(ctx context.Context, inputGetter func() MachineRemediationSpecInput)
• func NodeDrainTimeoutSpec(ctx context.Context, inputGetter func() NodeDrainTimeoutSpecInput)
• func QuickStartSpec(ctx context.Context, inputGetter func() QuickStartSpecInput)
• func SelfHostedSpec(ctx context.Context, inputGetter func() SelfHostedSpecInput)
• type ClusterProxy
• type ClusterUpgradeConformanceSpecInput
• type ClusterctlUpgradeSpecInput
• type K8SConformanceSpecInput
• type KCPAdoptionSpecInput
• type KCPUpgradeSpecInput
• type MachineDeploymentScaleSpecInput
• type MachineDeploymentUpgradesSpecInput
• type MachineRemediationSpecInput
• type NodeDrainTimeoutSpecInput
• type QuickStartSpecInput
• type SelfHostedSpecInput

Constants

const (
	KubernetesVersion            = "KUBERNETES_VERSION"
	CNIPath                      = "CNI"
	CNIResources                 = "CNI_RESOURCES"
	KubernetesVersionUpgradeFrom = "KUBERNETES_VERSION_UPGRADE_FROM"
	KubernetesVersionUpgradeTo   = "KUBERNETES_VERSION_UPGRADE_TO"
	EtcdVersionUpgradeTo         = "ETCD_VERSION_UPGRADE_TO"
	CoreDNSVersionUpgradeTo      = "COREDNS_VERSION_UPGRADE_TO"
	IPFamily                     = "IP_FAMILY"
)

Test suite constants for e2e config variables.

Functions

func Byf

func Byf(format string, a ...interface{})

func ClusterUpgradeConformanceSpec

func ClusterUpgradeConformanceSpec(ctx context.Context, inputGetter func() ClusterUpgradeConformanceSpecInput)

ClusterUpgradeConformanceSpec implements a spec that upgrades a cluster and runs the Kubernetes conformance suite. Upgrading a cluster refers to upgrading the control-plane and worker nodes (managed by MD and machine pools).

func ClusterctlUpgradeSpec

func ClusterctlUpgradeSpec(ctx context.Context, inputGetter func() ClusterctlUpgradeSpecInput)

ClusterctlUpgradeSpec implements a test that verifies clusterctl upgrade of a management cluster.

NOTE: this test is designed to test v1alpha3 --> v1alpha4 upgrades.

func HaveControllerRef

func HaveControllerRef(kind string, owner metav1.Object) types.GomegaMatcher

func HaveValidVersion

func HaveValidVersion(version string) types.GomegaMatcher

HaveValidVersion succeeds if version is a valid semver version.

func K8SConformanceSpec

func K8SConformanceSpec(ctx context.Context, inputGetter func() K8SConformanceSpecInput)

K8SConformanceSpec implements a spec that creates a cluster and runs Kubernetes conformance suite.

func KCPAdoptionSpec

func KCPAdoptionSpec(ctx context.Context, inputGetter func() KCPAdoptionSpecInput)

KCPAdoptionSpec implements a test that verifies KCP to properly adopt existing control plane Machines.

func KCPUpgradeSpec

func KCPUpgradeSpec(ctx context.Context, inputGetter func() KCPUpgradeSpecInput)

KCPUpgradeSpec implements a test that verifies KCP to properly upgrade a control plane with 3 machines.

func MachineDeploymentScaleSpec

func MachineDeploymentScaleSpec(ctx context.Context, inputGetter func() MachineDeploymentScaleSpecInput)

MachineDeploymentScaleSpec implements a test that verifies that MachineDeployment scale operations are successful.

func MachineDeploymentUpgradesSpec

func MachineDeploymentUpgradesSpec(ctx context.Context, inputGetter func() MachineDeploymentUpgradesSpecInput)

MachineDeploymentUpgradesSpec implements a test that verifies that MachineDeployment upgrades are successful.

func MachineRemediationSpec

func MachineRemediationSpec(ctx context.Context, inputGetter func() MachineRemediationSpecInput)

MachineRemediationSpec implements a test that verifies that Machines are remediated by MHC during unhealthy conditions.

func NodeDrainTimeoutSpec

func NodeDrainTimeoutSpec(ctx context.Context, inputGetter func() NodeDrainTimeoutSpecInput)

func QuickStartSpec

func QuickStartSpec(ctx context.Context, inputGetter func() QuickStartSpecInput)

QuickStartSpec implements a spec that mimics the operation described in the Cluster API quick start, that is creating a workload cluster. This test is meant to provide a first, fast signal to detect regression; it is recommended to use it as a PR blocker test.

func SelfHostedSpec

func SelfHostedSpec(ctx context.Context, inputGetter func() SelfHostedSpecInput)

SelfHostedSpec implements a test that verifies Cluster API creating a cluster, pivoting to a self-hosted cluster.

Types

type ClusterProxy

type ClusterProxy interface {
	framework.ClusterProxy

	ApplyWithArgs(context.Context, []byte, ...string) error
}

type ClusterUpgradeConformanceSpecInput

type ClusterUpgradeConformanceSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

ClusterUpgradeConformanceSpecInput is the input for ClusterUpgradeConformanceSpec.

type ClusterctlUpgradeSpecInput

type ClusterctlUpgradeSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

ClusterctlUpgradeSpecInput is the input for ClusterctlUpgradeSpec.

type K8SConformanceSpecInput

type K8SConformanceSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

K8SConformanceSpecInput is the input for K8SConformanceSpec.

type KCPAdoptionSpecInput

type KCPAdoptionSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

KCPAdoptionSpecInput is the input for KCPAdoptionSpec.

type KCPUpgradeSpecInput

type KCPUpgradeSpecInput struct {
	E2EConfig                *clusterctl.E2EConfig
	ClusterctlConfigPath     string
	BootstrapClusterProxy    framework.ClusterProxy
	ArtifactFolder           string
	SkipCleanup              bool
	ControlPlaneMachineCount int64
	Flavor                   string
}

KCPUpgradeSpecInput is the input for KCPUpgradeSpec.

type MachineDeploymentScaleSpecInput

type MachineDeploymentScaleSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

MachineDeploymentScaleSpecInput is the input for MachineDeploymentScaleSpec.

type MachineDeploymentUpgradesSpecInput

type MachineDeploymentUpgradesSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

MachineDeploymentUpgradesSpecInput is the input for MachineDeploymentUpgradesSpec.

type MachineRemediationSpecInput

type MachineRemediationSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

MachineRemediationSpecInput is the input for MachineRemediationSpec.

type NodeDrainTimeoutSpecInput

type NodeDrainTimeoutSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

NodeDrainTimeoutSpecInput is the input for NodeDrainTimeoutSpec.

type QuickStartSpecInput

type QuickStartSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

QuickStartSpecInput is the input for QuickStartSpec.

type SelfHostedSpecInput

type SelfHostedSpecInput struct {
	E2EConfig             *clusterctl.E2EConfig
	ClusterctlConfigPath  string
	BootstrapClusterProxy framework.ClusterProxy
	ArtifactFolder        string
	SkipCleanup           bool
}

SelfHostedSpecInput is the input for SelfHostedSpec.