kubernetes: k8s.io/kubernetes/test/e2e/framework Index | Files | Directories

package framework

import "k8s.io/kubernetes/test/e2e/framework"

Package framework contains provider-independent helper code for building and running E2E tests with Ginkgo. The actual Ginkgo test suites gets assembled by combining this framework, the optional provider support code and specific tests via a separate .go file like Kubernetes' test/e2e.go.


Package Files

cleanup.go exec_util.go expect.go flake_reporting_util.go framework.go log.go log_size_monitoring.go nodes_util.go pods.go ports.go provider.go psp.go resource_usage_gatherer.go size.go test_context.go util.go


const (
    // KubeletPort is the default port for the kubelet server on each host machine.
    // May be overridden by a flag at startup.
    KubeletPort = 10250
    // InsecureKubeControllerManagerPort is the default port for the controller manager status server.
    // May be overridden by a flag at startup.
    // Deprecated: use the secure KubeControllerManagerPort instead.
    InsecureKubeControllerManagerPort = 10252
const (
    // PodListTimeout is how long to wait for the pod to be listable.
    PodListTimeout = time.Minute
    // PodStartTimeout is how long to wait for the pod to be started.
    PodStartTimeout = 5 * time.Minute

    // PodStartShortTimeout is same as `PodStartTimeout` to wait for the pod to be started, but shorter.
    // Use it case by case when we are sure pod start will not be delayed.
    // minutes by slow docker pulls or something else.
    PodStartShortTimeout = 2 * time.Minute

    // PodDeleteTimeout is how long to wait for a pod to be deleted.
    PodDeleteTimeout = 5 * time.Minute

    // PodGetTimeout is how long to wait for a pod to be got.
    PodGetTimeout = 2 * time.Minute

    // PodEventTimeout is how much we wait for a pod event to occur.
    PodEventTimeout = 2 * time.Minute

    // ServiceStartTimeout is how long to wait for a service endpoint to be resolvable.
    ServiceStartTimeout = 3 * time.Minute

    // Poll is how often to Poll pods, nodes and claims.
    Poll = 2 * time.Second

    // PollShortTimeout is the short timeout value in polling.
    PollShortTimeout = 1 * time.Minute

    // ServiceAccountProvisionTimeout is how long to wait for a service account to be provisioned.
    // service accounts are provisioned after namespace creation
    // a service account is required to support pod creation in a namespace as part of admission control
    ServiceAccountProvisionTimeout = 2 * time.Minute

    // SingleCallTimeout is how long to try single API calls (like 'get' or 'list'). Used to prevent
    // transient failures from failing tests.
    SingleCallTimeout = 5 * time.Minute

    // NodeReadyInitialTimeout is how long nodes have to be "ready" when a test begins. They should already
    // be "ready" before the test starts, so this is small.
    NodeReadyInitialTimeout = 20 * time.Second

    // PodReadyBeforeTimeout is how long pods have to be "ready" when a test begins.
    PodReadyBeforeTimeout = 5 * time.Minute

    // ClaimProvisionShortTimeout is same as `ClaimProvisionTimeout` to wait for claim to be dynamically provisioned, but shorter.
    // Use it case by case when we are sure this timeout is enough.
    ClaimProvisionShortTimeout = 1 * time.Minute

    // ClaimProvisionTimeout is how long claims have to become dynamically provisioned.
    ClaimProvisionTimeout = 5 * time.Minute

    // RestartNodeReadyAgainTimeout is how long a node is allowed to become "Ready" after it is restarted before
    // the test is considered failed.
    RestartNodeReadyAgainTimeout = 5 * time.Minute

    // RestartPodReadyAgainTimeout is how long a pod is allowed to become "running" and "ready" after a node
    // restart before test is considered failed.
    RestartPodReadyAgainTimeout = 5 * time.Minute

    // SnapshotCreateTimeout is how long for snapshot to create snapshotContent.
    SnapshotCreateTimeout = 5 * time.Minute

    // SnapshotDeleteTimeout is how long for snapshot to delete snapshotContent.
    SnapshotDeleteTimeout = 5 * time.Minute

    // AllContainers specifies that all containers be visited
    // Copied from pkg/api/v1/pod to avoid pulling extra dependencies
    AllContainers = InitContainers | Containers | EphemeralContainers
const (
    // DefaultNamespaceDeletionTimeout is timeout duration for waiting for a namespace deletion.
    DefaultNamespaceDeletionTimeout = 5 * time.Minute
const (

    // DefaultNumNodes is the number of nodes. If not specified, then number of nodes is auto-detected
    DefaultNumNodes = -1
const (
    // DefaultPodDeletionTimeout is the default timeout for deleting pod
    DefaultPodDeletionTimeout = 3 * time.Minute


var (
    // BusyBoxImage is the image URI of BusyBox.
    BusyBoxImage = imageutils.GetE2EImage(imageutils.BusyBox)

    // ProvidersWithSSH are those providers where each node is accessible with SSH
    ProvidersWithSSH = []string{"gce", "gke", "aws", "local"}

    // ServeHostnameImage is a serve hostname image name.
    ServeHostnameImage = imageutils.GetE2EImage(imageutils.Agnhost)
var ImagePrePullList sets.String

ImagePrePullList is the images used in the current test suite. It should be initialized in test suite and the images in the list should be pre-pulled in the test suite. Currently, this is only used by node e2e test.

var RunID = uuid.NewUUID()

RunID is a unique identifier of the e2e run. Beware that this ID is not the same for all tests in the e2e run, because each Ginkgo node creates it separately.

func AddOrUpdateLabelOnNode Uses

func AddOrUpdateLabelOnNode(c clientset.Interface, nodeName string, labelKey, labelValue string)

AddOrUpdateLabelOnNode adds the given label key and value to the given node or updates value.

func AfterReadingAllFlags Uses

func AfterReadingAllFlags(t *TestContextType)

AfterReadingAllFlags makes changes to the context after all flags have been read.

func AllNodesReady Uses

func AllNodesReady(c clientset.Interface, timeout time.Duration) error

AllNodesReady checks whether all registered nodes are ready. TODO: we should change the AllNodesReady call in AfterEach to WaitForAllNodesHealthy, and figure out how to do it in a configurable way, as we can't expect all setups to run default test add-ons.

func AppendContainerCommandGroupIfNeeded Uses

func AppendContainerCommandGroupIfNeeded(args []string) []string

AppendContainerCommandGroupIfNeeded returns container command group parameter if necessary.

func CheckTestingNSDeletedExcept Uses

func CheckTestingNSDeletedExcept(c clientset.Interface, skip string) error

CheckTestingNSDeletedExcept checks whether all e2e based existing namespaces are in the Terminating state and waits until they are finally deleted. It ignores namespace skip.

func ConformanceIt Uses

func ConformanceIt(text string, body interface{}, timeout ...float64) bool

ConformanceIt is wrapper function for ginkgo It. Adds "[Conformance]" tag and makes static analysis easier.

func CoreDump Uses

func CoreDump(dir string)

CoreDump SSHs to the master and all nodes and dumps their logs into dir. It shells out to cluster/log-dump/log-dump.sh to accomplish this.

func CreateEmptyFileOnPod Uses

func CreateEmptyFileOnPod(namespace string, podName string, filePath string) error

CreateEmptyFileOnPod creates empty file at given path on the pod. TODO(alejandrox1): move to subpkg pod once kubectl methods have been refactored.

func CreatePrivilegedPSPBinding Uses

func CreatePrivilegedPSPBinding(kubeClient clientset.Interface, namespace string)

CreatePrivilegedPSPBinding creates the privileged PSP & role

func CreateTestingNS Uses

func CreateTestingNS(baseName string, c clientset.Interface, labels map[string]string) (*v1.Namespace, error)

CreateTestingNS should be used by every test, note that we append a common prefix to the provided test name. Please see NewFramework instead of using this directly.

func DeleteNamespaces Uses

func DeleteNamespaces(c clientset.Interface, deleteFilter, skipFilter []string) ([]string, error)

DeleteNamespaces deletes all namespaces that match the given delete and skip filters. Filter is by simple strings.Contains; first skip filter, then delete filter. Returns the list of deleted namespaces or an error.

func DumpAllNamespaceInfo Uses

func DumpAllNamespaceInfo(c clientset.Interface, namespace string)

DumpAllNamespaceInfo dumps events, pods and nodes information in the given namespace.

func DumpDebugInfo Uses

func DumpDebugInfo(c clientset.Interface, ns string)

DumpDebugInfo dumps debug info of tests.

func DumpNodeDebugInfo Uses

func DumpNodeDebugInfo(c clientset.Interface, nodeNames []string, logFunc func(fmt string, args ...interface{}))

DumpNodeDebugInfo dumps debug information of the given nodes.

func EnsureLoadBalancerResourcesDeleted Uses

func EnsureLoadBalancerResourcesDeleted(ip, portRange string) error

EnsureLoadBalancerResourcesDeleted ensures that cloud load balancer resources that were created are actually cleaned up. Currently only implemented for GCE/GKE.

func EtcdUpgrade Uses

func EtcdUpgrade(targetStorage, targetVersion string) error

EtcdUpgrade upgrades etcd on GCE.

func ExpectConsistOf Uses

func ExpectConsistOf(actual interface{}, extra interface{}, explain ...interface{})

ExpectConsistOf expects actual contains precisely the extra elements. The ordering of the elements does not matter.

func ExpectEmpty Uses

func ExpectEmpty(actual interface{}, explain ...interface{})

ExpectEmpty expects actual is empty

func ExpectEqual Uses

func ExpectEqual(actual interface{}, extra interface{}, explain ...interface{})

ExpectEqual expects the specified two are the same, otherwise an exception raises

func ExpectError Uses

func ExpectError(err error, explain ...interface{})

ExpectError expects an error happens, otherwise an exception raises

func ExpectHaveKey Uses

func ExpectHaveKey(actual interface{}, key interface{}, explain ...interface{})

ExpectHaveKey expects the actual map has the key in the keyset

func ExpectNoError Uses

func ExpectNoError(err error, explain ...interface{})

ExpectNoError checks if "err" is set, and if so, fails assertion while logging the error.

func ExpectNoErrorWithOffset Uses

func ExpectNoErrorWithOffset(offset int, err error, explain ...interface{})

ExpectNoErrorWithOffset checks if "err" is set, and if so, fails assertion while logging the error at "offset" levels above its caller (for example, for call chain f -> g -> ExpectNoErrorWithOffset(1, ...) error would be logged for "f").

func ExpectNodeHasLabel Uses

func ExpectNodeHasLabel(c clientset.Interface, nodeName string, labelKey string, labelValue string)

ExpectNodeHasLabel expects that the given node has the given label pair.

func ExpectNodeHasTaint Uses

func ExpectNodeHasTaint(c clientset.Interface, nodeName string, taint *v1.Taint)

ExpectNodeHasTaint expects that the node has the given taint.

func ExpectNotEqual Uses

func ExpectNotEqual(actual interface{}, extra interface{}, explain ...interface{})

ExpectNotEqual expects the specified two are not the same, otherwise an exception raises

func Fail Uses

func Fail(msg string, callerSkip ...int)

Fail is a replacement for ginkgo.Fail which logs the problem as it occurs together with a stack trace and then calls ginkgowrapper.Fail.

func Failf Uses

func Failf(format string, args ...interface{})

Failf logs the fail info, including a stack trace.

func FailfWithOffset Uses

func FailfWithOffset(offset int, format string, args ...interface{})

FailfWithOffset calls "Fail" and logs the error with a stack trace that starts at "offset" levels above its caller (for example, for call chain f -> g -> FailfWithOffset(1, ...) error would be logged for "f").

func GCEUpgradeScript Uses

func GCEUpgradeScript() string

GCEUpgradeScript returns path of script for upgrading on GCE.

func GetAllMasterAddresses Uses

func GetAllMasterAddresses(c clientset.Interface) []string

GetAllMasterAddresses returns all IP addresses on which the kubelet can reach the master. It may return internal and external IPs, even if we expect for e.g. internal IPs to be used (issue #56787), so that we can be sure to block the master fully during tests.

func GetGroupNodes Uses

func GetGroupNodes(group string) ([]string, error)

GetGroupNodes returns a node name for the specified node group

func GetMasterHost Uses

func GetMasterHost() string

GetMasterHost returns a hostname of a master.

func GetProviders Uses

func GetProviders() []string

GetProviders returns the names of all currently registered providers.

func GroupSize Uses

func GroupSize(group string) (int, error)

GroupSize returns the size of an instance group

func IsPodSecurityPolicyEnabled Uses

func IsPodSecurityPolicyEnabled(kubeClient clientset.Interface) bool

IsPodSecurityPolicyEnabled returns true if PodSecurityPolicy is enabled. Otherwise false.

func KubeDescribe Uses

func KubeDescribe(text string, body func()) bool

KubeDescribe is wrapper function for ginkgo describe. Adds namespacing. TODO: Support type safe tagging as well https://github.com/kubernetes/kubernetes/pull/22401.

func LoadClientset Uses

func LoadClientset() (*clientset.Clientset, error)

LoadClientset returns clientset for connecting to kubernetes clusters.

func LoadConfig Uses

func LoadConfig() (config *restclient.Config, err error)

LoadConfig returns a config for a rest client with the UserAgent set to include the current test name.

func LocationParamGKE Uses

func LocationParamGKE() string

LocationParamGKE returns parameter related to location for gcloud command.

func Logf Uses

func Logf(format string, args ...interface{})

Logf logs the info.

func LookForStringInLog Uses

func LookForStringInLog(ns, podName, container, expectedString string, timeout time.Duration) (result string, err error)

LookForStringInLog looks for the given string in the log of a specific pod container

func LookForStringInPodExec Uses

func LookForStringInPodExec(ns, podName string, command []string, expectedString string, timeout time.Duration) (result string, err error)

LookForStringInPodExec looks for the given string in the output of a command executed in a specific pod container. TODO(alejandrox1): move to pod/ subpkg once kubectl methods are refactored.

func MasterOSDistroIs Uses

func MasterOSDistroIs(supportedMasterOsDistros ...string) bool

MasterOSDistroIs returns true if the master OS distro is included in the supportedMasterOsDistros. Otherwise false.

func MasterUpgradeGKE Uses

func MasterUpgradeGKE(namespace string, v string) error

MasterUpgradeGKE upgrades master node to the specified version on GKE.

func NodeHasTaint Uses

func NodeHasTaint(c clientset.Interface, nodeName string, taint *v1.Taint) (bool, error)

NodeHasTaint returns true if the node has the given taint, else returns false.

func NodeOSArchIs Uses

func NodeOSArchIs(supportedNodeOsArchs ...string) bool

NodeOSArchIs returns true if the node OS arch is included in the supportedNodeOsArchs. Otherwise false.

func NodeOSDistroIs Uses

func NodeOSDistroIs(supportedNodeOsDistros ...string) bool

NodeOSDistroIs returns true if the node OS distro is included in the supportedNodeOsDistros. Otherwise false.

func PrettyPrintJSON Uses

func PrettyPrintJSON(metrics interface{}) string

PrettyPrintJSON converts metrics to JSON format.

func ProviderIs Uses

func ProviderIs(providers ...string) bool

ProviderIs returns true if the provider is included is the providers. Otherwise false.

func PrunedStack Uses

func PrunedStack(skip int) []byte

PrunedStack is a wrapper around debug.Stack() that removes information about the current goroutine and optionally skips some of the initial stack entries. With skip == 0, the returned stack will start with the caller of PruneStack. From the remaining entries it automatically filters out useless ones like entries coming from Ginkgo.

This is a modified copy of PruneStack in https://github.com/onsi/ginkgo/blob/f90f37d87fa6b1dd9625e2b1e83c23ffae3de228/internal/codelocation/code_location.go#L25: - simplified API and thus renamed (calls debug.Stack() instead of taking a parameter) - source code filtering updated to be specific to Kubernetes - optimized to use bytes and in-place slice filtering from


func RandomSuffix Uses

func RandomSuffix() string

RandomSuffix provides a random sequence to append to pods,services,rcs.

func RegisterClusterFlags Uses

func RegisterClusterFlags(flags *flag.FlagSet)

RegisterClusterFlags registers flags specific to the cluster e2e test suite.

func RegisterCommonFlags Uses

func RegisterCommonFlags(flags *flag.FlagSet)

RegisterCommonFlags registers flags common to all e2e test suites. The flag set can be flag.CommandLine (if desired) or a custom flag set that then gets passed to viperconfig.ViperizeFlags.

The other Register*Flags methods below can be used to add more test-specific flags. However, those settings then get added regardless whether the test is actually in the test suite.

For tests that have been converted to registering their options themselves, copy flags from test/e2e/framework/config as shown in HandleFlags.

func RegisterProvider Uses

func RegisterProvider(name string, factory Factory)

RegisterProvider is expected to be called during application init, typically by an init function in a provider package.

func RemoveCleanupAction Uses

func RemoveCleanupAction(p CleanupActionHandle)

RemoveCleanupAction removes a function that was installed by AddCleanupAction.

func RemoveLabelOffNode Uses

func RemoveLabelOffNode(c clientset.Interface, nodeName string, labelKey string)

RemoveLabelOffNode is for cleaning up labels temporarily added to node, won't fail if target label doesn't exist or has been removed.

func ResizeGroup Uses

func ResizeGroup(group string, size int32) error

ResizeGroup resizes an instance group

func RunCleanupActions Uses

func RunCleanupActions()

RunCleanupActions runs all functions installed by AddCleanupAction. It does not remove them (see RemoveCleanupAction) but it does run unlocked, so they may remove themselves.

func RunCmd Uses

func RunCmd(command string, args ...string) (string, string, error)

RunCmd runs cmd using args and returns its stdout and stderr. It also outputs cmd's stdout and stderr to their respective OS streams.

func RunCmdEnv Uses

func RunCmdEnv(env []string, command string, args ...string) (string, string, error)

RunCmdEnv runs cmd with the provided environment and args and returns its stdout and stderr. It also outputs cmd's stdout and stderr to their respective OS streams.

func RunHostCmd Uses

func RunHostCmd(ns, name, cmd string) (string, error)

RunHostCmd runs the given cmd in the context of the given pod using `kubectl exec` inside of a shell.

func RunHostCmdOrDie Uses

func RunHostCmdOrDie(ns, name, cmd string) string

RunHostCmdOrDie calls RunHostCmd and dies on error.

func RunHostCmdWithFullOutput Uses

func RunHostCmdWithFullOutput(ns, name, cmd string) (string, string, error)

RunHostCmdWithFullOutput runs the given cmd in the context of the given pod using `kubectl exec` inside of a shell. It will also return the command's stderr.

func RunHostCmdWithRetries Uses

func RunHostCmdWithRetries(ns, name, cmd string, interval, timeout time.Duration) (string, error)

RunHostCmdWithRetries calls RunHostCmd and retries all errors until it succeeds or the specified timeout expires. This can be used with idempotent commands to deflake transient Node issues.

func RunKubectl Uses

func RunKubectl(namespace string, args ...string) (string, error)

RunKubectl is a convenience wrapper over kubectlBuilder

func RunKubectlInput Uses

func RunKubectlInput(namespace string, data string, args ...string) (string, error)

RunKubectlInput is a convenience wrapper over kubectlBuilder that takes input to stdin

func RunKubectlOrDie Uses

func RunKubectlOrDie(namespace string, args ...string) string

RunKubectlOrDie is a convenience wrapper over kubectlBuilder

func RunKubectlOrDieInput Uses

func RunKubectlOrDieInput(namespace string, data string, args ...string) string

RunKubectlOrDieInput is a convenience wrapper over kubectlBuilder that takes input to stdin

func RunKubectlWithFullOutput Uses

func RunKubectlWithFullOutput(namespace string, args ...string) (string, string, error)

RunKubectlWithFullOutput is a convenience wrapper over kubectlBuilder It will also return the command's stderr.

func RunKubemciCmd Uses

func RunKubemciCmd(args ...string) (string, error)

RunKubemciCmd is a convenience wrapper over kubectlBuilder to run kubemci. It assumes that kubemci exists in PATH.

func RunKubemciWithKubeconfig Uses

func RunKubemciWithKubeconfig(args ...string) (string, error)

RunKubemciWithKubeconfig is a convenience wrapper over RunKubemciCmd

func StartCmdAndStreamOutput Uses

func StartCmdAndStreamOutput(cmd *exec.Cmd) (stdout, stderr io.ReadCloser, err error)

StartCmdAndStreamOutput returns stdout and stderr after starting the given cmd.

func TryKill Uses

func TryKill(cmd *exec.Cmd)

TryKill is rough equivalent of ctrl+c for cleaning up processes. Intended to be run in defer.

func WaitForAllNodesSchedulable Uses

func WaitForAllNodesSchedulable(c clientset.Interface, timeout time.Duration) error

WaitForAllNodesSchedulable waits up to timeout for all (but TestContext.AllowedNotReadyNodes) to become scheduable.

func WaitForDefaultServiceAccountInNamespace Uses

func WaitForDefaultServiceAccountInNamespace(c clientset.Interface, namespace string) error

WaitForDefaultServiceAccountInNamespace waits for the default service account to be provisioned the default service account is what is associated with pods when they do not specify a service account as a result, pods are not able to be provisioned in a namespace until the service account is provisioned

func WaitForGroupSize Uses

func WaitForGroupSize(group string, size int32) error

WaitForGroupSize waits for node instance group reached the desired size

func WaitForNamespacesDeleted Uses

func WaitForNamespacesDeleted(c clientset.Interface, namespaces []string, timeout time.Duration) error

WaitForNamespacesDeleted waits for the namespaces to be deleted.

func WaitForSSHTunnels Uses

func WaitForSSHTunnels(namespace string)

WaitForSSHTunnels waits for establishing SSH tunnel to busybox pod.

func WaitForServiceEndpointsNum Uses

func WaitForServiceEndpointsNum(c clientset.Interface, namespace, serviceName string, expectNum int, interval, timeout time.Duration) error

WaitForServiceEndpointsNum waits until the amount of endpoints that implement service to expectNum.

func WatchEventSequenceVerifier Uses

func WatchEventSequenceVerifier(ctx context.Context, dc dynamic.Interface, resourceType schema.GroupVersionResource, namespace string, resourceName string, listOptions metav1.ListOptions, expectedWatchEvents []watch.Event, scenario func(*watchtools.RetryWatcher) []watch.Event, retryCleanup func() error)

WatchEventSequenceVerifier ... manages a watch for a given resource, ensures that events take place in a given order, retries the test on failure

testContext         cancelation signal across API boundries, e.g: context.TODO()
dc                  sets up a client to the API
resourceType        specify the type of resource
namespace           select a namespace
resourceName        the name of the given resource
listOptions         options used to find the resource, recommended to use listOptions.labelSelector
expectedWatchEvents array of events which are expected to occur
scenario            the test itself
retryCleanup        a function to run which ensures that there are no dangling resources upon test failure

this tooling relies on the test to return the events as they occur the entire scenario must be run to ensure that the desired watch events arrive in order (allowing for interweaving of watch events)

if an expected watch event is missing we elect to clean up and run the entire scenario again

we try the scenario three times to allow the sequencing to fail a couple of times

type AfterEachActionFunc Uses

type AfterEachActionFunc func(f *Framework, failed bool)

AfterEachActionFunc is a function that can be called after each test

type CleanupActionHandle Uses

type CleanupActionHandle *int

CleanupActionHandle is an integer pointer type for handling cleanup action

func AddCleanupAction Uses

func AddCleanupAction(fn func()) CleanupActionHandle

AddCleanupAction installs a function that will be called in the event of the whole test being terminated. This allows arbitrary pieces of the overall test to hook into SynchronizedAfterSuite(). The hooks are called in last-in-first-out order.

type ClientConfigGetter Uses

type ClientConfigGetter func() (*restclient.Config, error)

ClientConfigGetter is a func that returns getter to return a config.

type CloudConfig Uses

type CloudConfig struct {
    APIEndpoint       string
    ProjectID         string
    Zone              string // for multizone tests, arbitrarily chosen zone
    Region            string
    MultiZone         bool
    MultiMaster       bool
    Cluster           string
    MasterName        string
    NodeInstanceGroup string // comma-delimited list of groups' names
    NumNodes          int
    ClusterIPRange    string
    ClusterTag        string
    Network           string
    ConfigFile        string // for azure and openstack
    NodeTag           string
    MasterTag         string

    Provider ProviderInterface

CloudConfig holds the cloud configuration for e2e test suites.

type ClusterVerification Uses

type ClusterVerification struct {
    // contains filtered or unexported fields

ClusterVerification is a struct for a verification of cluster state.

func (*ClusterVerification) ForEach Uses

func (cl *ClusterVerification) ForEach(podFunc func(v1.Pod)) error

ForEach runs a function against every verifiable pod. Be warned that this doesn't wait for "n" pods to verify, so it may return very quickly if you have strict pod state requirements.

For example, if you require at least 5 pods to be running before your test will pass, its smart to first call "clusterVerification.WaitFor(5)" before you call clusterVerification.ForEach.

func (*ClusterVerification) WaitFor Uses

func (cl *ClusterVerification) WaitFor(atLeast int, timeout time.Duration) ([]v1.Pod, error)

WaitFor waits for some minimum number of pods to be verified, according to the PodStateVerification definition.

func (*ClusterVerification) WaitForOrFail Uses

func (cl *ClusterVerification) WaitForOrFail(atLeast int, timeout time.Duration)

WaitForOrFail provides a shorthand WaitFor with failure as an option if anything goes wrong.

type ContainerResourceGatherer Uses

type ContainerResourceGatherer struct {
    // contains filtered or unexported fields

ContainerResourceGatherer is a struct for gathering container resource.

func NewResourceUsageGatherer Uses

func NewResourceUsageGatherer(c clientset.Interface, options ResourceGathererOptions, pods *v1.PodList) (*ContainerResourceGatherer, error)

NewResourceUsageGatherer returns a new ContainerResourceGatherer.

func (*ContainerResourceGatherer) StartGatheringData Uses

func (g *ContainerResourceGatherer) StartGatheringData()

StartGatheringData starts a stat gathering worker blocks for each node to track, and blocks until StopAndSummarize is called.

func (*ContainerResourceGatherer) StopAndSummarize Uses

func (g *ContainerResourceGatherer) StopAndSummarize(percentiles []int, constraints map[string]ResourceConstraint) (*ResourceUsageSummary, error)

StopAndSummarize stops stat gathering workers, processes the collected stats, generates resource summary for the passed-in percentiles, and returns the summary. It returns an error if the resource usage at any percentile is beyond the specified resource constraints.

type ContainerResourceUsage Uses

type ContainerResourceUsage struct {
    Name                    string
    Timestamp               time.Time
    CPUUsageInCores         float64
    MemoryUsageInBytes      uint64
    MemoryWorkingSetInBytes uint64
    MemoryRSSInBytes        uint64
    // The interval used to calculate CPUUsageInCores.
    CPUInterval time.Duration

ContainerResourceUsage is a structure for gathering container resource usage.

type ContainerType Uses

type ContainerType int

ContainerType signifies container type

const (
    // FeatureEphemeralContainers allows running an ephemeral container in pod namespaces to troubleshoot a running pod
    FeatureEphemeralContainers featuregate.Feature = "EphemeralContainers"
    // Containers is for normal containers
    Containers ContainerType = 1 << iota
    // InitContainers is for init containers
    // EphemeralContainers is for ephemeral containers

type ContainerVisitor Uses

type ContainerVisitor func(container *v1.Container, containerType ContainerType) (shouldContinue bool)

ContainerVisitor is called with each container spec, and returns true if visiting should continue. Copied from pkg/api/v1/pod to avoid pulling extra dependencies

type CreateTestingNSFn Uses

type CreateTestingNSFn func(baseName string, c clientset.Interface, labels map[string]string) (*v1.Namespace, error)

CreateTestingNSFn is a func that is responsible for creating namespace used for executing e2e tests.

type EventsLister Uses

type EventsLister func(opts metav1.ListOptions, ns string) (*v1.EventList, error)

EventsLister is a func that lists events.

type ExecOptions Uses

type ExecOptions struct {
    Command       []string
    Namespace     string
    PodName       string
    ContainerName string
    Stdin         io.Reader
    CaptureStdout bool
    CaptureStderr bool
    // If false, whitespace in std{err,out} will be removed.
    PreserveWhitespace bool

ExecOptions passed to ExecWithOptions

type Factory Uses

type Factory func() (ProviderInterface, error)

Factory is a func which operates provider specific behavior.

type FlakeReport Uses

type FlakeReport struct {
    Flakes     []string `json:"flakes"`
    FlakeCount int      `json:"flakeCount"`
    // contains filtered or unexported fields

FlakeReport is a struct for managing the flake report.

func NewFlakeReport Uses

func NewFlakeReport() *FlakeReport

NewFlakeReport returns a new flake report.

func (*FlakeReport) GetFlakeCount Uses

func (f *FlakeReport) GetFlakeCount() int

GetFlakeCount returns the flake count.

func (*FlakeReport) PrintHumanReadable Uses

func (f *FlakeReport) PrintHumanReadable() string

PrintHumanReadable returns string of flake report.

func (*FlakeReport) PrintJSON Uses

func (f *FlakeReport) PrintJSON() string

PrintJSON returns the summary of frake report with JSON format.

func (*FlakeReport) RecordFlakeIfError Uses

func (f *FlakeReport) RecordFlakeIfError(err error, optionalDescription ...interface{})

RecordFlakeIfError records the error (if non-nil) as a flake along with an optional description. This can be used as a replacement of framework.ExpectNoError() for non-critical errors that can be considered as 'flakes' to avoid causing failures in tests.

func (*FlakeReport) SummaryKind Uses

func (f *FlakeReport) SummaryKind() string

SummaryKind returns the summary of flake report.

type Framework Uses

type Framework struct {
    BaseName string

    // Set together with creating the ClientSet and the namespace.
    // Guaranteed to be unique in the cluster even when running the same
    // test multiple times in parallel.
    UniqueName string

    ClientSet                        clientset.Interface
    KubemarkExternalClusterClientSet clientset.Interface

    DynamicClient dynamic.Interface

    ScalesGetter scaleclient.ScalesGetter

    SkipNamespaceCreation bool          // Whether to skip creating a namespace
    Namespace             *v1.Namespace // Every test has at least one namespace unless creation is skipped

    NamespaceDeletionTimeout time.Duration
    SkipPrivilegedPSPBinding bool // Whether to skip creating a binding to the privileged PSP in the test namespace

    // Constraints that passed to a check which is executed after data is gathered to
    // see if 99% of results are within acceptable bounds. It has to be injected in the test,
    // as expectations vary greatly. Constraints are grouped by the container names.
    AddonResourceConstraints map[string]ResourceConstraint

    // configuration for framework's client
    Options Options

    // Place where various additional data is stored during test run to be printed to ReportDir,
    // or stdout if ReportDir is not set once test ends.
    TestSummaries []TestDataSummary
    // contains filtered or unexported fields

Framework supports common operations used by e2e tests; it will keep a client & a namespace for you. Eventual goal is to merge this with integration test framework.

func NewDefaultFramework Uses

func NewDefaultFramework(baseName string) *Framework

NewDefaultFramework makes a new framework and sets up a BeforeEach/AfterEach for you (you can write additional before/after each functions).

func NewFramework Uses

func NewFramework(baseName string, options Options, client clientset.Interface) *Framework

NewFramework creates a test framework.

func (*Framework) AddAfterEach Uses

func (f *Framework) AddAfterEach(name string, fn AfterEachActionFunc)

AddAfterEach is a way to add a function to be called after every test. The execution order is intentionally random to avoid growing dependencies. If you register the same name twice, it is a coding error and will panic.

func (*Framework) AddNamespacesToDelete Uses

func (f *Framework) AddNamespacesToDelete(namespaces ...*v1.Namespace)

AddNamespacesToDelete adds one or more namespaces to be deleted when the test completes.

func (*Framework) AfterEach Uses

func (f *Framework) AfterEach()

AfterEach deletes the namespace, after reading its events.

func (*Framework) BeforeEach Uses

func (f *Framework) BeforeEach()

BeforeEach gets a client and makes a namespace.

func (*Framework) ClientConfig Uses

func (f *Framework) ClientConfig() *rest.Config

ClientConfig an externally accessible method for reading the kube client config.

func (*Framework) CreateNamespace Uses

func (f *Framework) CreateNamespace(baseName string, labels map[string]string) (*v1.Namespace, error)

CreateNamespace creates a namespace for e2e testing.

func (*Framework) DeleteNamespace Uses

func (f *Framework) DeleteNamespace(name string)

DeleteNamespace can be used to delete a namespace. Additionally it can be used to dump namespace information so as it can be used as an alternative of framework deleting the namespace towards the end.

func (*Framework) ExecCommandInContainer Uses

func (f *Framework) ExecCommandInContainer(podName, containerName string, cmd ...string) string

ExecCommandInContainer executes a command in the specified container.

func (*Framework) ExecCommandInContainerWithFullOutput Uses

func (f *Framework) ExecCommandInContainerWithFullOutput(podName, containerName string, cmd ...string) (string, string, error)

ExecCommandInContainerWithFullOutput executes a command in the specified container and return stdout, stderr and error

func (*Framework) ExecShellInContainer Uses

func (f *Framework) ExecShellInContainer(podName, containerName string, cmd string) string

ExecShellInContainer executes the specified command on the pod's container.

func (*Framework) ExecShellInPod Uses

func (f *Framework) ExecShellInPod(podName string, cmd string) string

ExecShellInPod executes the specified command on the pod.

func (*Framework) ExecShellInPodWithFullOutput Uses

func (f *Framework) ExecShellInPodWithFullOutput(podName string, cmd string) (string, string, error)

ExecShellInPodWithFullOutput executes the specified command on the Pod and returns stdout, stderr and error.

func (*Framework) ExecWithOptions Uses

func (f *Framework) ExecWithOptions(options ExecOptions) (string, string, error)

ExecWithOptions executes a command in the specified container, returning stdout, stderr and error. `options` allowed for additional parameters to be passed.

func (*Framework) MatchContainerOutput Uses

func (f *Framework) MatchContainerOutput(
    pod *v1.Pod,
    containerName string,
    expectedOutput []string,
    matcher func(string, ...interface{}) gomegatypes.GomegaMatcher) error

MatchContainerOutput creates a pod and waits for all it's containers to exit with success. It then tests that the matcher with each expectedOutput matches the output of the specified container.

func (*Framework) NewClusterVerification Uses

func (f *Framework) NewClusterVerification(namespace *v1.Namespace, filter PodStateVerification) *ClusterVerification

NewClusterVerification creates a new cluster verification.

func (*Framework) PodClient Uses

func (f *Framework) PodClient() *PodClient

PodClient is a convenience method for getting a pod client interface in the framework's namespace, possibly applying test-suite specific transformations to the pod spec, e.g. for node e2e pod scheduling.

func (*Framework) PodClientNS Uses

func (f *Framework) PodClientNS(namespace string) *PodClient

PodClientNS is a convenience method for getting a pod client interface in an alternative namespace, possibly applying test-suite specific transformations to the pod spec, e.g. for node e2e pod scheduling.

func (*Framework) RecordFlakeIfError Uses

func (f *Framework) RecordFlakeIfError(err error, optionalDescription ...interface{})

RecordFlakeIfError records flakeness info if error happens. NOTE: This function is not used at any places yet, but we are in progress for https://github.com/kubernetes/kubernetes/issues/66239 which requires this. Please don't remove this.

func (*Framework) TestContainerOutput Uses

func (f *Framework) TestContainerOutput(scenarioName string, pod *v1.Pod, containerIndex int, expectedOutput []string)

TestContainerOutput runs the given pod in the given namespace and waits for all of the containers in the podSpec to move into the 'Success' status, and tests the specified container log against the given expected output using a substring matcher.

func (*Framework) TestContainerOutputRegexp Uses

func (f *Framework) TestContainerOutputRegexp(scenarioName string, pod *v1.Pod, containerIndex int, expectedOutput []string)

TestContainerOutputRegexp runs the given pod in the given namespace and waits for all of the containers in the podSpec to move into the 'Success' status, and tests the specified container log against the given expected output using a regexp matcher.

type KubeCluster Uses

type KubeCluster struct {
    Name    string `yaml:"name"`
    Cluster struct {
        CertificateAuthorityData string `yaml:"certificate-authority-data"`
        Server                   string `yaml:"server"`
    }   `yaml:"cluster"`

KubeCluster is a struct for managing kubernetes cluster info.

type KubeConfig Uses

type KubeConfig struct {
    Contexts []struct {
        Name    string `yaml:"name"`
        Context struct {
            Cluster string `yaml:"cluster"`
            User    string
        }   `yaml:"context"`
    }   `yaml:"contexts"`

    Clusters []KubeCluster `yaml:"clusters"`

    Users []KubeUser `yaml:"users"`

KubeConfig is a struct for managing kubernetes config.

func (*KubeConfig) FindCluster Uses

func (kc *KubeConfig) FindCluster(name string) *KubeCluster

FindCluster returns cluster info which is the specified cluster name.

func (*KubeConfig) FindUser Uses

func (kc *KubeConfig) FindUser(name string) *KubeUser

FindUser returns user info which is the specified user name.

type KubeUser Uses

type KubeUser struct {
    Name string `yaml:"name"`
    User struct {
        Username string `yaml:"username"`
        Password string `yaml:"password"`
        Token    string `yaml:"token"`
    }   `yaml:"user"`

KubeUser is a struct for managing kubernetes user info.

type KubectlBuilder Uses

type KubectlBuilder struct {
    // contains filtered or unexported fields

KubectlBuilder is used to build, customize and execute a kubectl Command. Add more functions to customize the builder as needed.

func NewKubectlCommand Uses

func NewKubectlCommand(namespace string, args ...string) *KubectlBuilder

NewKubectlCommand returns a KubectlBuilder for running kubectl.

func (KubectlBuilder) Exec Uses

func (b KubectlBuilder) Exec() (string, error)

Exec runs the kubectl executable.

func (KubectlBuilder) ExecOrDie Uses

func (b KubectlBuilder) ExecOrDie(namespace string) string

ExecOrDie runs the kubectl executable or dies if error occurs.

func (KubectlBuilder) ExecWithFullOutput Uses

func (b KubectlBuilder) ExecWithFullOutput() (string, string, error)

ExecWithFullOutput runs the kubectl executable, and returns the stdout and stderr.

func (*KubectlBuilder) WithEnv Uses

func (b *KubectlBuilder) WithEnv(env []string) *KubectlBuilder

WithEnv sets the given environment and returns itself.

func (KubectlBuilder) WithStdinData Uses

func (b KubectlBuilder) WithStdinData(data string) *KubectlBuilder

WithStdinData sets the given data to stdin and returns itself.

func (KubectlBuilder) WithStdinReader Uses

func (b KubectlBuilder) WithStdinReader(reader io.Reader) *KubectlBuilder

WithStdinReader sets the given reader and returns itself.

func (*KubectlBuilder) WithTimeout Uses

func (b *KubectlBuilder) WithTimeout(t <-chan time.Time) *KubectlBuilder

WithTimeout sets the given timeout and returns itself.

type LogSizeDataTimeseries Uses

type LogSizeDataTimeseries map[string]map[string][]TimestampedSize

LogSizeDataTimeseries is map of timestamped size.

type LogSizeGatherer Uses

type LogSizeGatherer struct {
    // contains filtered or unexported fields

LogSizeGatherer is a worker which grabs a WorkItem from the channel and does assigned work.

func (*LogSizeGatherer) Run Uses

func (g *LogSizeGatherer) Run()

Run starts log size gathering.

func (*LogSizeGatherer) Work Uses

func (g *LogSizeGatherer) Work() bool

Work does a single unit of work: tries to take out a WorkItem from the queue, ssh-es into a given machine, gathers data, writes it to the shared <data> map, and creates a gorouting which reinserts work item into the queue with a <pollingPeriod> delay. Returns false if worker should exit.

type LogsSizeData Uses

type LogsSizeData struct {
    // contains filtered or unexported fields

LogsSizeData is a structure for handling timeseries of log size data and lock.

type LogsSizeDataSummary Uses

type LogsSizeDataSummary map[string]map[string]SingleLogSummary

LogsSizeDataSummary is map of log summary. node -> file -> data

func (*LogsSizeDataSummary) PrintHumanReadable Uses

func (s *LogsSizeDataSummary) PrintHumanReadable() string

PrintHumanReadable returns string of log size data summary. TODO: make sure that we don't need locking here

func (*LogsSizeDataSummary) PrintJSON Uses

func (s *LogsSizeDataSummary) PrintJSON() string

PrintJSON returns the summary of log size data with JSON format.

func (*LogsSizeDataSummary) SummaryKind Uses

func (s *LogsSizeDataSummary) SummaryKind() string

SummaryKind returns the summary of log size data summary.

type LogsSizeVerifier Uses

type LogsSizeVerifier struct {
    // contains filtered or unexported fields

LogsSizeVerifier gathers data about log files sizes from master and node machines. It oversees a <workersNo> workers which do the gathering.

func NewLogsVerifier Uses

func NewLogsVerifier(c clientset.Interface, stopChannel chan bool) *LogsSizeVerifier

NewLogsVerifier creates a new LogsSizeVerifier which will stop when stopChannel is closed

func (*LogsSizeVerifier) GetSummary Uses

func (s *LogsSizeVerifier) GetSummary() *LogsSizeDataSummary

GetSummary returns a summary (average generation rate and number of probes) of the data gathered by LogSizeVerifier

func (*LogsSizeVerifier) Run Uses

func (s *LogsSizeVerifier) Run()

Run starts log size gathering. It starts a gorouting for every worker and then blocks until stopChannel is closed

type NodeKiller Uses

type NodeKiller struct {
    // contains filtered or unexported fields

NodeKiller is a utility to simulate node failures.

func NewNodeKiller Uses

func NewNodeKiller(config NodeKillerConfig, client clientset.Interface, provider string) *NodeKiller

NewNodeKiller creates new NodeKiller.

func (*NodeKiller) Run Uses

func (k *NodeKiller) Run(stopCh <-chan struct{})

Run starts NodeKiller until stopCh is closed.

type NodeKillerConfig Uses

type NodeKillerConfig struct {
    // Enabled determines whether NodeKill should do anything at all.
    // All other options below are ignored if Enabled = false.
    Enabled bool
    // FailureRatio is a percentage of all nodes that could fail simultinously.
    FailureRatio float64
    // Interval is time between node failures.
    Interval time.Duration
    // JitterFactor is factor used to jitter node failures.
    // Node will be killed between [Interval, Interval + (1.0 + JitterFactor)].
    JitterFactor float64
    // SimulatedDowntime is a duration between node is killed and recreated.
    SimulatedDowntime time.Duration
    // NodeKillerStopCh is a channel that is used to notify NodeKiller to stop killing nodes.
    NodeKillerStopCh chan struct{}

NodeKillerConfig describes configuration of NodeKiller -- a utility to simulate node failures.

type NodeTestContextType Uses

type NodeTestContextType struct {
    // NodeE2E indicates whether it is running node e2e.
    NodeE2E bool
    // Name of the node to run tests on.
    NodeName string
    // NodeConformance indicates whether the test is running in node conformance mode.
    NodeConformance bool
    // PrepullImages indicates whether node e2e framework should prepull images.
    PrepullImages bool
    // KubeletConfig is the kubelet configuration the test is running against.
    KubeletConfig kubeletconfig.KubeletConfiguration
    // ImageDescription is the description of the image on which the test is running.
    ImageDescription string
    // SystemSpecName is the name of the system spec (e.g., gke) that's used in
    // the node e2e test. If empty, the default one (system.DefaultSpec) is
    // used. The system specs are in test/e2e_node/system/specs/.
    SystemSpecName string
    // ExtraEnvs is a map of environment names to values.
    ExtraEnvs map[string]string

NodeTestContextType is part of TestContextType, it is shared by all node e2e test.

type NodesSet Uses

type NodesSet int

NodesSet is a value of nodes set.

const (
    // AllNodes means all containers on all nodes.
    AllNodes NodesSet = 0
    // MasterNodes means all containers on Master nodes only.
    MasterNodes NodesSet = 1
    // MasterAndDNSNodes means all containers on Master nodes and DNS containers on other nodes.
    MasterAndDNSNodes NodesSet = 2

type NullProvider Uses

type NullProvider struct{}

NullProvider is the default implementation of the ProviderInterface which doesn't do anything.

func (NullProvider) CleanupServiceResources Uses

func (n NullProvider) CleanupServiceResources(c clientset.Interface, loadBalancerName, region, zone string)

CleanupServiceResources is a base implementation which cleans up service resources.

func (NullProvider) CreatePD Uses

func (n NullProvider) CreatePD(zone string) (string, error)

CreatePD is a base implementation which creates PD.

func (NullProvider) CreatePVSource Uses

func (n NullProvider) CreatePVSource(zone, diskName string) (*v1.PersistentVolumeSource, error)

CreatePVSource is a base implementation which creates PV source.

func (NullProvider) DeleteNode Uses

func (n NullProvider) DeleteNode(node *v1.Node) error

DeleteNode is a base implementation which deletes a node.

func (NullProvider) DeletePD Uses

func (n NullProvider) DeletePD(pdName string) error

DeletePD is a base implementation which deletes PD.

func (NullProvider) DeletePVSource Uses

func (n NullProvider) DeletePVSource(pvSource *v1.PersistentVolumeSource) error

DeletePVSource is a base implementation which deletes PV source.

func (NullProvider) EnableAndDisableInternalLB Uses

func (n NullProvider) EnableAndDisableInternalLB() (enable, disable func(svc *v1.Service))

EnableAndDisableInternalLB is a base implementation which returns functions for enabling/disabling an internal LB.

func (NullProvider) EnsureLoadBalancerResourcesDeleted Uses

func (n NullProvider) EnsureLoadBalancerResourcesDeleted(ip, portRange string) error

EnsureLoadBalancerResourcesDeleted is a base implementation which ensures load balancer is deleted.

func (NullProvider) FrameworkAfterEach Uses

func (n NullProvider) FrameworkAfterEach(f *Framework)

FrameworkAfterEach is a base implementation which does AfterEach.

func (NullProvider) FrameworkBeforeEach Uses

func (n NullProvider) FrameworkBeforeEach(f *Framework)

FrameworkBeforeEach is a base implementation which does BeforeEach.

func (NullProvider) GetGroupNodes Uses

func (n NullProvider) GetGroupNodes(group string) ([]string, error)

GetGroupNodes is a base implementation which returns group nodes.

func (NullProvider) GroupSize Uses

func (n NullProvider) GroupSize(group string) (int, error)

GroupSize returns the size of an instance group

func (NullProvider) LoadBalancerSrcRanges Uses

func (n NullProvider) LoadBalancerSrcRanges() []string

LoadBalancerSrcRanges is a base implementation which returns the ranges of ips used by load balancers.

func (NullProvider) ResizeGroup Uses

func (n NullProvider) ResizeGroup(string, int32) error

ResizeGroup is a base implementation which resizes group.

type Options Uses

type Options struct {
    ClientQPS    float32
    ClientBurst  int
    GroupVersion *schema.GroupVersion

Options is a struct for managing test framework options.

type PodClient Uses

type PodClient struct {
    // contains filtered or unexported fields

PodClient is a struct for pod client.

func (*PodClient) Create Uses

func (c *PodClient) Create(pod *v1.Pod) *v1.Pod

Create creates a new pod according to the framework specifications (don't wait for it to start).

func (*PodClient) CreateBatch Uses

func (c *PodClient) CreateBatch(pods []*v1.Pod) []*v1.Pod

CreateBatch create a batch of pods. All pods are created before waiting.

func (*PodClient) CreateSync Uses

func (c *PodClient) CreateSync(pod *v1.Pod) *v1.Pod

CreateSync creates a new pod according to the framework specifications, and wait for it to start.

func (*PodClient) DeleteSync Uses

func (c *PodClient) DeleteSync(name string, options metav1.DeleteOptions, timeout time.Duration)

DeleteSync deletes the pod and wait for the pod to disappear for `timeout`. If the pod doesn't disappear before the timeout, it will fail the test.

func (*PodClient) MatchContainerOutput Uses

func (c *PodClient) MatchContainerOutput(name string, containerName string, expectedRegexp string) error

MatchContainerOutput gets output of a container and match expected regexp in the output.

func (*PodClient) PodIsReady Uses

func (c *PodClient) PodIsReady(name string) bool

PodIsReady returns true if the specified pod is ready. Otherwise false.

func (*PodClient) Update Uses

func (c *PodClient) Update(name string, updateFn func(pod *v1.Pod))

Update updates the pod object. It retries if there is a conflict, throw out error if there is any other apierrors. name is the pod name, updateFn is the function updating the pod object.

func (*PodClient) WaitForErrorEventOrSuccess Uses

func (c *PodClient) WaitForErrorEventOrSuccess(pod *v1.Pod) (*v1.Event, error)

WaitForErrorEventOrSuccess waits for pod to succeed or an error event for that pod.

func (*PodClient) WaitForFinish Uses

func (c *PodClient) WaitForFinish(name string, timeout time.Duration)

WaitForFinish waits for pod to finish running, regardless of success or failure.

func (*PodClient) WaitForSuccess Uses

func (c *PodClient) WaitForSuccess(name string, timeout time.Duration)

WaitForSuccess waits for pod to succeed. TODO(random-liu): Move pod wait function into this file

type PodStateVerification Uses

type PodStateVerification struct {
    // Optional: only pods that have k=v labels will pass this filter.
    Selectors map[string]string

    // Required: The phases which are valid for your pod.
    ValidPhases []v1.PodPhase

    // Optional: only pods passing this function will pass the filter
    // Verify a pod.
    // As an optimization, in addition to specifying filter (boolean),
    // this function allows specifying an error as well.
    // The error indicates that the polling of the pod spectrum should stop.
    Verify func(v1.Pod) (bool, error)

    // Optional: only pods with this name will pass the filter.
    PodName string

PodStateVerification represents a verification of pod state. Any time you have a set of pods that you want to operate against or query, this struct can be used to declaratively identify those pods.

type ProviderInterface Uses

type ProviderInterface interface {
    FrameworkBeforeEach(f *Framework)
    FrameworkAfterEach(f *Framework)

    ResizeGroup(group string, size int32) error
    GetGroupNodes(group string) ([]string, error)
    GroupSize(group string) (int, error)

    DeleteNode(node *v1.Node) error

    CreatePD(zone string) (string, error)
    DeletePD(pdName string) error
    CreatePVSource(zone, diskName string) (*v1.PersistentVolumeSource, error)
    DeletePVSource(pvSource *v1.PersistentVolumeSource) error

    CleanupServiceResources(c clientset.Interface, loadBalancerName, region, zone string)

    EnsureLoadBalancerResourcesDeleted(ip, portRange string) error
    LoadBalancerSrcRanges() []string
    EnableAndDisableInternalLB() (enable, disable func(svc *v1.Service))

ProviderInterface contains the implementation for certain provider-specific functionality.

func SetupProviderConfig Uses

func SetupProviderConfig(providerName string) (ProviderInterface, error)

SetupProviderConfig validates the chosen provider and creates an interface instance for it.

type ResourceConstraint Uses

type ResourceConstraint struct {
    CPUConstraint    float64
    MemoryConstraint uint64

ResourceConstraint is a struct to hold constraints.

type ResourceGathererOptions Uses

type ResourceGathererOptions struct {
    InKubemark                  bool
    Nodes                       NodesSet
    ResourceDataGatheringPeriod time.Duration
    ProbeDuration               time.Duration
    PrintVerboseLogs            bool

ResourceGathererOptions is a struct to hold options for resource.

type ResourceUsagePerContainer Uses

type ResourceUsagePerContainer map[string]*ContainerResourceUsage

ResourceUsagePerContainer is map of ContainerResourceUsage

type ResourceUsageSummary Uses

type ResourceUsageSummary map[string][]SingleContainerSummary

ResourceUsageSummary is a struct to hold resource usage summary. we can't have int here, as JSON does not accept integer keys.

func (*ResourceUsageSummary) PrintHumanReadable Uses

func (s *ResourceUsageSummary) PrintHumanReadable() string

PrintHumanReadable prints resource usage summary in human readable.

func (*ResourceUsageSummary) PrintJSON Uses

func (s *ResourceUsageSummary) PrintJSON() string

PrintJSON prints resource usage summary in JSON.

func (*ResourceUsageSummary) SummaryKind Uses

func (s *ResourceUsageSummary) SummaryKind() string

SummaryKind returns string of ResourceUsageSummary

type SingleContainerSummary Uses

type SingleContainerSummary struct {
    Name string
    CPU  float64
    Mem  uint64

SingleContainerSummary is a struct to hold single container summary.

type SingleLogSummary Uses

type SingleLogSummary struct {
    AverageGenerationRate int
    NumberOfProbes        int

SingleLogSummary is a structure for handling average generation rate and number of probes.

type TestContextType Uses

type TestContextType struct {
    KubeConfig         string
    KubeContext        string
    KubeAPIContentType string
    KubeVolumeDir      string
    CertDir            string
    Host               string
    // TODO: Deprecating this over time... instead just use gobindata_util.go , see #23987.
    RepoRoot                string
    DockershimCheckpointDir string
    // ListImages will list off all images that are used then quit
    ListImages bool

    // ListConformanceTests will list off all conformance tests that are available then quit
    ListConformanceTests bool

    // Provider identifies the infrastructure provider (gce, gke, aws)
    Provider string

    // Tooling is the tooling in use (e.g. kops, gke).  Provider is the cloud provider and might not uniquely identify the tooling.
    Tooling string

    CloudConfig    CloudConfig
    KubectlPath    string
    OutputDir      string
    ReportDir      string
    ReportPrefix   string
    Prefix         string
    MinStartupPods int
    // Timeout for waiting for system pods to be running
    SystemPodsStartupTimeout    time.Duration
    EtcdUpgradeStorage          string
    EtcdUpgradeVersion          string
    GCEUpgradeScript            string
    ContainerRuntime            string
    ContainerRuntimeEndpoint    string
    ContainerRuntimeProcessName string
    ContainerRuntimePidFile     string
    // SystemdServices are comma separated list of systemd services the test framework
    // will dump logs for.
    SystemdServices string
    // DumpSystemdJournal controls whether to dump the full systemd journal.
    DumpSystemdJournal       bool
    ImageServiceEndpoint     string
    MasterOSDistro           string
    NodeOSDistro             string
    NodeOSArch               string
    VerifyServiceAccount     bool
    DeleteNamespace          bool
    DeleteNamespaceOnFailure bool
    AllowedNotReadyNodes     int
    CleanStart               bool
    // If set to 'true' or 'all' framework will start a goroutine monitoring resource usage of system add-ons.
    // It will read the data every 30 seconds from all Nodes and print summary during afterEach. If set to 'master'
    // only master Node will be monitored.
    GatherKubeSystemResourceUsageData string
    GatherLogsSizes                   bool
    GatherMetricsAfterTest            string
    GatherSuiteMetricsAfterTest       bool
    MaxNodesToGather                  int
    AllowGatheringProfiles            bool
    // If set to 'true' framework will gather ClusterAutoscaler metrics when gathering them for other components.
    IncludeClusterAutoscalerMetrics bool
    // Currently supported values are 'hr' for human-readable and 'json'. It's a comma separated list.
    OutputPrintType string
    // NodeSchedulableTimeout is the timeout for waiting for all nodes to be schedulable.
    NodeSchedulableTimeout time.Duration
    // SystemDaemonsetStartupTimeout is the timeout for waiting for all system daemonsets to be ready.
    SystemDaemonsetStartupTimeout time.Duration
    // CreateTestingNS is responsible for creating namespace used for executing e2e tests.
    // It accepts namespace base name, which will be prepended with e2e prefix, kube client
    // and labels to be applied to a namespace.
    CreateTestingNS CreateTestingNSFn
    // If set to true test will dump data about the namespace in which test was running.
    DumpLogsOnFailure bool
    // Disables dumping cluster log from master and nodes after all tests.
    DisableLogDump bool
    // Path to the GCS artifacts directory to dump logs from nodes. Logexporter gets enabled if this is non-empty.
    LogexporterGCSPath string
    // featureGates is a map of feature names to bools that enable or disable alpha/experimental features.
    FeatureGates map[string]bool
    // Node e2e specific test context

    // The DNS Domain of the cluster.
    ClusterDNSDomain string

    // The configuration of NodeKiller.
    NodeKiller NodeKillerConfig

    // The Default IP Family of the cluster ("ipv4" or "ipv6")
    IPFamily string

    // NonblockingTaints is the comma-delimeted string given by the user to specify taints which should not stop the test framework from running tests.
    NonblockingTaints string

    // ProgressReportURL is the URL which progress updates will be posted to as tests complete. If empty, no updates are sent.
    ProgressReportURL string

    // SriovdpConfigMapFile is the path to the ConfigMap to configure the SRIOV device plugin on this host.
    SriovdpConfigMapFile string

    // SpecSummaryOutput is the file to write ginkgo.SpecSummary objects to as tests complete. Useful for debugging and test introspection.
    SpecSummaryOutput string

    // DockerConfigFile is a file that contains credentials which can be used to pull images from certain private registries, needed for a test.
    DockerConfigFile string

TestContextType contains test settings and global state. Due to historic reasons, it is a mixture of items managed by the test framework itself, cloud providers and individual tests. The goal is to move anything not required by the framework into the code which uses the settings.

The recommendation for those settings is: - They are stored in their own context structure or local


- The standard `flag` package is used to register them.

The flag name should follow the pattern <part1>.<part2>....<partn>
where the prefix is unlikely to conflict with other tests or
standard packages and each part is in lower camel case. For
example, test/e2e/storage/csi/context.go could define

- framework/config can be used to simplify the registration of

multiple options with a single function call:
var storageCSI {
    NumIterations `default:"1" usage:"number of iterations"`
_ config.AddOptions(&storageCSI, "storage.csi")

- The direct use Viper in tests is possible, but discouraged because

it only works in test suites which use Viper (which is not
required) and the supported options cannot be
discovered by a test suite user.

Test suite authors can use framework/viper to make all command line parameters also configurable via a configuration file.

var TestContext TestContextType

TestContext should be used by all tests to access common context data.

func (TestContextType) ClusterIsIPv6 Uses

func (tc TestContextType) ClusterIsIPv6() bool

ClusterIsIPv6 returns true if the cluster is IPv6

type TestDataSummary Uses

type TestDataSummary interface {
    SummaryKind() string
    PrintHumanReadable() string
    PrintJSON() string

TestDataSummary is an interface for managing test data.

type TimestampedSize Uses

type TimestampedSize struct {
    // contains filtered or unexported fields

TimestampedSize contains a size together with a time of measurement.

type WorkItem Uses

type WorkItem struct {
    // contains filtered or unexported fields

WorkItem is a command for a worker that contains an IP of machine from which we want to gather data and paths to all files we're interested in.


configPackage config simplifies the declaration of configuration options.
ginkgowrapperPackage ginkgowrapper wraps Ginkgo Fail and Skip functions to panic with structured data instead of a constant string.
logPackage log will be removed after switching to use core framework log.
testfilesPackage testfiles provides a wrapper around various optional ways of retrieving additional files needed during a test run: - builtin bindata - filesystem access

Package framework imports 75 packages (graph) and is imported by 3681 packages. Updated 2020-09-26. Refresh now. Tools for package owners.