common

package
v0.8.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 18, 2019 License: Apache-2.0 Imports: 30 Imported by: 0

Documentation

Index

Constants

View Source 
const DefaultChannel = resources.InMemoryChannelKind

DefaultChannel is the default channel we will run tests against.

Variables

View Source 
var ApiServerSourceTypeMeta = SourcesTypeMeta(resources.ApiServerSourceKind)

ApiServerSourceTypeMeta is the TypeMeta ref for ApiServerSource.

View Source 
var BrokerTypeMeta = EventingTypeMeta(resources.BrokerKind)

BrokerTypeMeta is the TypeMeta ref for Broker.

View Source 
var ChoiceTypeMeta = MessagingTypeMeta(resources.ChoiceKind)

ChoiceTypeMeta is the TypeMeta ref for Choice.

View Source 
var ContainerSourceTypeMeta = SourcesTypeMeta(resources.ContainerSourceKind)

ContainerSourceTypeMeta is the TypeMeta ref for ContainerSource.

View Source 
var CronJobSourceTypeMeta = SourcesTypeMeta(resources.CronJobSourceKind)

CronJobSourceTypeMeta is the TypeMeta ref for CronJobSource.

View Source 
var InMemoryChannelTypeMeta = MessagingTypeMeta(resources.InMemoryChannelKind)

InMemoryChannelTypeMeta is the TypeMeta ref for InMemoryChannel.

View Source 
var NatssChannelTypeMeta = MessagingTypeMeta(resources.NatssChannelKind)

NatssChannelTypeMeta is the TypeMeta ref for NatssChannel.

View Source 
var SequenceTypeMeta = MessagingTypeMeta(resources.SequenceKind)

SequenceTypeMeta is the TypeMeta ref for Sequence.

View Source 
var SubscriptionTypeMeta = EventingTypeMeta(resources.SubscriptionKind)

SubscriptionTypeMeta is the TypeMeta ref for Subscription.

View Source 
var TriggerTypeMeta = EventingTypeMeta(resources.TriggerKind)

TriggerTypeMeta is the TypeMeta ref for Trigger.

View Source 
var ValidChannelsMap = map[string]ChannelConfig{
	resources.InMemoryChannelKind: {
		Features: []Feature{FeatureBasic},
	},
	resources.NatssChannelKind: {
		Features: []Feature{FeatureBasic, FeatureRedelivery, FeaturePersistence},
	},
}

ValidChannelsMap saves the channel-features mapping. Each pair means the channel support the list of features.

Functions

func CheckerContains 

func CheckerContains(content string) func(string) bool

CheckerContains returns a checker function to check if the log contains the given content.

func CheckerContainsAll 

func CheckerContainsAll(contents []string) func(string) bool

CheckerContainsAll returns a checker function to check if the log contains all the given contents.

func CheckerContainsAtLeast 

func CheckerContainsAtLeast(content string, count int) func(string) bool

CheckerContainsAtLeast returns a checker function to check if the log contains at least the count number of given content.

func CheckerContainsCount 

func CheckerContainsCount(content string, count int) func(string) bool

CheckerContainsCount returns a checker function to check if the log contains the count number of given content.

func CreateNamespaceIfNeeded 

func CreateNamespaceIfNeeded(t *testing.T, client *Client, namespace string)

CreateNamespaceIfNeeded creates a new namespace if it does not exist.

func DeleteNameSpace 

func DeleteNameSpace(client *Client) error

DeleteNameSpace deletes the namespace that has the given name.

func EventingTypeMeta 

func EventingTypeMeta(kind string) *metav1.TypeMeta

EventingTypeMeta returns the TypeMeta ref for an eventing resource.

func GetChannelTypeMeta 

func GetChannelTypeMeta(channelName string) *metav1.TypeMeta

GetChannelTypeMeta gets the actual typemeta of the channel.

func LogPodLogsForDebugging 

func LogPodLogsForDebugging(client *Client, podName, containerName string)

LogPodLogsForDebugging add the pod logs in the testing log for further debugging.

func MessagingTypeMeta 

func MessagingTypeMeta(kind string) *metav1.TypeMeta

MessagingTypeMeta returns the TypeMeta ref for an eventing messaing resource.

func RunTests 

func RunTests(
	t *testing.T,
	channels []string,
	feature Feature,
	testFunc func(st *testing.T, channel string),
)

RunTests will use all channels that support the given feature, to run a test for the testFunc.

func SourcesTypeMeta 

func SourcesTypeMeta(kind string) *metav1.TypeMeta

SourcesTypeMeta returns the TypeMeta ref for an eventing sources resource.

func TearDown 

func TearDown(client *Client)

TearDown will delete created names using clients.

func WithService 

func WithService(name string) func(*corev1.Pod, *Client) error

WithService returns an option that creates a Service binded with the given pod.

Types

type ChannelConfig 

type ChannelConfig struct {
	Features []Feature
}

ChannelConfig includes general configuration for a channel.

type Client 

type Client struct {
	Kube     *test.KubeClient
	Eventing *eventing.Clientset
	Dynamic  dynamic.Interface
	Natss    *natsschannel.Clientset

	Namespace string
	T         *testing.T
	Tracker   *Tracker
}

Client holds instances of interfaces for making requests to Knative.

func NewClient 

func NewClient(configPath string, clusterName string, namespace string, t *testing.T) (*Client, error)

NewClient instantiates and returns several clientsets required for making request to the cluster specified by the combination of clusterName and configPath.

func Setup 

func Setup(t *testing.T, runInParallel bool) *Client

Setup creates the client objects needed in the e2e tests, and does other setups, like creating namespaces, set the test case to run in parallel, etc.

func (*Client) CheckLog 

func (client *Client) CheckLog(podName string, checker func(string) bool) error

CheckLog waits until logs for the logger Pod satisfy the checker. If the checker does not pass within timeout it returns error.

func (*Client) CreateApiServerSourceOrFail 

func (client *Client) CreateApiServerSourceOrFail(
	name string,
	apiServerSourceResources []sourcesv1alpha1.ApiServerResource,
	mode string,
	options ...resources.ApiServerSourceOption,
)

CreateApiServerSourceOrFail will create an ApiServerSource

func (*Client) CreateBrokerOrFail 

func (client *Client) CreateBrokerOrFail(name string, channelTypeMeta *metav1.TypeMeta)

CreateBrokerOrFail will create a Broker or fail the test if there is an error.

func (*Client) CreateBrokersOrFail 

func (client *Client) CreateBrokersOrFail(names []string, channelTypeMeta *metav1.TypeMeta)

CreateBrokersOrFail will create a list of Brokers.

func (*Client) CreateChannelOrFail 

func (client *Client) CreateChannelOrFail(name string, channelTypeMeta *metav1.TypeMeta)

CreateChannelOrFail will create a Channel Resource in Eventing.

func (*Client) CreateChannelsOrFail 

func (client *Client) CreateChannelsOrFail(names []string, channelTypeMeta *metav1.TypeMeta)

CreateChannelsOrFail will create a list of Channel Resources in Eventing.

func (*Client) CreateChoiceOrFail added in v0.8.0 

func (client *Client) CreateChoiceOrFail(choice *messagingv1alpha1.Choice)

CreateChoiceOrFail will create a Choice or fail the test if there is an error.

func (*Client) CreateClusterRoleBindingOrFail 

func (client *Client) CreateClusterRoleBindingOrFail(saName, crName, crbName string)

CreateClusterRoleBindingOrFail will create a ClusterRoleBinding or fail the test if there is an error.

func (*Client) CreateClusterRoleOrFail 

func (client *Client) CreateClusterRoleOrFail(cr *rbacv1.ClusterRole)

CreateClusterRoleOrFail creates the given ClusterRole or fail the test if there is an error.

func (*Client) CreateContainerSourceOrFail 

func (client *Client) CreateContainerSourceOrFail(
	name string,
	options ...resources.ContainerSourceOption,
)

CreateContainerSourceOrFail will create a ContainerSource or fail the test if there is an error.

func (*Client) CreateCronJobSourceOrFail 

func (client *Client) CreateCronJobSourceOrFail(
	name,
	schedule,
	data string,
	options ...resources.CronJobSourceOption,
)

CreateCronJobSourceOrFail will create a CronJobSource or fail the test if there is an error.

func (*Client) CreatePodOrFail 

func (client *Client) CreatePodOrFail(pod *corev1.Pod, options ...func(*corev1.Pod, *Client) error)

CreatePodOrFail will create a Pod or fail the test if there is an error.

func (*Client) CreateRBACResourcesForBrokers 

func (client *Client) CreateRBACResourcesForBrokers()

CreateRBACResourcesForBrokers creates required RBAC resources for creating Brokers, see https://github.com/knative/docs/blob/master/docs/eventing/broker-trigger.md - Manual Setup.

func (*Client) CreateRoleBindingOrFail 

func (client *Client) CreateRoleBindingOrFail(saName, crName, rbName, rbNamespace string)

CreateRoleBindingOrFail will create a RoleBinding or fail the test if there is an error.

func (*Client) CreateSequenceOrFail added in v0.8.0 

func (client *Client) CreateSequenceOrFail(
	name string,
	steps []eventingv1alpha1.SubscriberSpec,
	channelTemplate *eventingduckv1alpha1.ChannelTemplateSpec,
	options ...resources.SequenceOption,
)

CreateSequenceOrFail will create a Sequence or fail the test if there is an error.

func (*Client) CreateServiceAccountOrFail 

func (client *Client) CreateServiceAccountOrFail(saName string)

CreateServiceAccountOrFail will create a ServiceAccount or fail the test if there is an error.

func (*Client) CreateSubscriptionOrFail 

func (client *Client) CreateSubscriptionOrFail(
	name, channelName string,
	channelTypeMeta *metav1.TypeMeta,
	options ...resources.SubscriptionOption,
)

CreateSubscriptionOrFail will create a Subscription or fail the test if there is an error.

func (*Client) CreateSubscriptionsOrFail 

func (client *Client) CreateSubscriptionsOrFail(
	names []string,
	channelName string,
	channelTypeMeta *metav1.TypeMeta,
	options ...resources.SubscriptionOption,
)

CreateSubscriptionsOrFail will create a list of Subscriptions with the same configuration except the name.

func (*Client) CreateTriggerOrFail 

func (client *Client) CreateTriggerOrFail(name string, options ...resources.TriggerOption)

CreateTriggerOrFail will create a Trigger or fail the test if there is an error.

func (*Client) FindAnyLogContents 

func (client *Client) FindAnyLogContents(podName string, contents []string) (bool, error)

FindAnyLogContents attempts to find logs for given Pod/Container that has 'any' of the given contents. It returns an error if it couldn't retrieve the logs. In case 'any' of the contents are there, it returns true.

func (*Client) GetAddressableURI 

func (client *Client) GetAddressableURI(addressableName string, typemeta *metav1.TypeMeta) (string, error)

GetAddressableURI returns the URI of the addressable resource. To use this function, the given resource must have implemented the Addressable duck-type.

func (*Client) LabelNamespace 

func (client *Client) LabelNamespace(labels map[string]string) error

LabelNamespace labels the given namespace with the labels map.

func (*Client) SendFakeEventToAddressable 

func (client *Client) SendFakeEventToAddressable(
	senderName,
	addressableName string,
	typemeta *metav1.TypeMeta,
	event *resources.CloudEvent,
) error

SendFakeEventToAddressable will send the given event to the given Addressable.

func (*Client) WaitForAllTestResourcesReady 

func (client *Client) WaitForAllTestResourcesReady() error

WaitForAllTestResourcesReady waits until all test resources in the namespace are Ready.

func (*Client) WaitForResourceReady 

func (client *Client) WaitForResourceReady(name string, typemeta *metav1.TypeMeta) error

WaitForResourceReady waits for the resource to become ready. To use this function, the given resource must have implemented the Status duck-type.

func (*Client) WaitForResourcesReady 

func (client *Client) WaitForResourcesReady(typemeta *metav1.TypeMeta) error

WaitForResourcesReady waits for resources of the given type in the namespace to become ready. To use this function, the given resource must have implemented the Status duck-type.

type Feature 

type Feature string

Feature is the feature supported by the channel. 

const (
	// FeatureBasic is the feature that should be supported by all channels.
	FeatureBasic Feature = "basic"
	// FeatureRedelivery means if downstream rejects an event, that request will be attempted again.
	FeatureRedelivery Feature = "redelivery"
	// FeaturePersistence means if channel's Pod goes down, all events already ACKed by the channel
	// will persist and be retransmitted when the Pod restarts.
	FeaturePersistence Feature = "persistence"
)

type ResourceDeleter 

type ResourceDeleter struct {
	Resource dynamic.ResourceInterface
	Name     string
}

ResourceDeleter holds the resource interface and name of resource to be cleaned

type Tracker 

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

Tracker holds resources that need to be tracked during test execution. It includes: 1. KResources that need to check their Ready status; 2. All Kubernetes resources that need to be cleaned after test is done.

func NewTracker 

func NewTracker(log logging.FormatLogger, client dynamic.Interface) *Tracker

NewTracker creates a new Tracker

func (*Tracker) Add 

func (t *Tracker) Add(group string, version string, resource string, namespace string, name string)

Add will register a resource to be cleaned by the Clean function This function is generic enough so as to be able to register any resources Each resource is identified by: * group (e.g. serving.knative.dev) * version (e.g. v1alpha1) * resource's plural (e.g. routes) * namespace (use "" if the resource is not tied to any namespace) * actual name of the resource (e.g. myroute)

func (*Tracker) AddObj 

func (t *Tracker) AddObj(obj kmeta.OwnerRefable)

AddObj will register a resource that implements OwnerRefable interface to be cleaned by the Clean function. It also register the resource for checking if its status is Ready. Note this function assumes all resources that implement kmeta.OwnerRefable are KResources.

func (*Tracker) Clean 

func (t *Tracker) Clean(awaitDeletion bool) error

Clean will delete all registered resources

func (*Tracker) WaitForKResourcesReady 

func (t *Tracker) WaitForKResourcesReady() error

WaitForKResourcesReady will wait for all registered KResources to become ready.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.