framework

Documentation

Index

• Constants
• Variables
• func CertManagerDescribe(text string, body func()) bool
• func CreateCertificateCRD(c apiextcs.Interface) error
• func CreateClusterIssuerCRD(c apiextcs.Interface) error
• func CreateIssuerCRD(c apiextcs.Interface) error
• func CreateKubeNamespace(baseName string, c kubernetes.Interface) (*v1.Namespace, error)
• func DeleteCertificateCRD(c apiextcs.Interface) error
• func DeleteClusterIssuerCRD(c apiextcs.Interface) error
• func DeleteIssuerCRD(c apiextcs.Interface) error
• func DeleteKubeNamespace(c kubernetes.Interface, namespace string) error
• func ExpectNoError(err error, explain ...interface{})
• func Failf(format string, args ...interface{})
• func LoadConfig(config, context string) (*rest.Config, error)
• func Logf(format string, args ...interface{})
• func RegisterCommonFlags()
• func RegisterParseFlags()
• func RemoveCleanupAction(p CleanupActionHandle)
• func RestclientConfig(config, context string) (*api.Config, error)
• func RunCleanupActions()
• func Skipf(format string, args ...interface{})
• func WaitForKubeNamespaceNotExist(c kubernetes.Interface, namespace string) error
• func WaitForPodRunningInNamespace(c kubernetes.Interface, pod *v1.Pod) error
• type CleanupActionHandle
  • func AddCleanupAction(fn func()) CleanupActionHandle
• type ClientConfigGetter
• type Framework
  • func NewDefaultFramework(baseName string) *Framework
  • func (f *Framework) AfterEach()
  • func (f *Framework) BeforeEach()
• type TestContextType

Constants

const (
	// How often to poll for conditions
	Poll = 2 * time.Second
)

const (
	RecommendedConfigPathEnvVar = "CERTMANAGERCONFIG"
)

Variables

var RunId = uuid.NewUUID()

unique identifier of the e2e run

Functions

func CertManagerDescribe

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

Wrapper function for ginkgo describe. Adds namespacing.

func CreateCertificateCRD

func CreateCertificateCRD(c apiextcs.Interface) error

func CreateClusterIssuerCRD

func CreateClusterIssuerCRD(c apiextcs.Interface) error

func CreateIssuerCRD

func CreateIssuerCRD(c apiextcs.Interface) error

func CreateKubeNamespace

func CreateKubeNamespace(baseName string, c kubernetes.Interface) (*v1.Namespace, error)

func DeleteCertificateCRD

func DeleteCertificateCRD(c apiextcs.Interface) error

func DeleteClusterIssuerCRD

func DeleteClusterIssuerCRD(c apiextcs.Interface) error

func DeleteIssuerCRD

func DeleteIssuerCRD(c apiextcs.Interface) error

func DeleteKubeNamespace

func DeleteKubeNamespace(c kubernetes.Interface, namespace string) error

func ExpectNoError

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

func Failf

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

func LoadConfig

func LoadConfig(config, context string) (*rest.Config, error)

func Logf

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

func RegisterCommonFlags

func RegisterCommonFlags()

Register flags common to all e2e test suites.

func RegisterParseFlags

func RegisterParseFlags()

func RemoveCleanupAction

func RemoveCleanupAction(p CleanupActionHandle)

RemoveCleanupAction removes a function that was installed by AddCleanupAction.

func RestclientConfig

func RestclientConfig(config, context string) (*api.Config, error)

func RunCleanupActions

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 Skipf

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

func WaitForKubeNamespaceNotExist

func WaitForKubeNamespaceNotExist(c kubernetes.Interface, namespace string) error

func WaitForPodRunningInNamespace

func WaitForPodRunningInNamespace(c kubernetes.Interface, pod *v1.Pod) error

Waits default amount of time (PodStartTimeout) for the specified pod to become running. Returns an error if timeout occurs first, or pod goes in to failed state.

Types

type CleanupActionHandle

type CleanupActionHandle *int

func AddCleanupAction

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().

type ClientConfigGetter

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

type Framework

type Framework struct {
	BaseName string

	// A Kubernetes and Service Catalog client
	KubeClientSet          kubernetes.Interface
	CertManagerClientSet   clientset.Interface
	APIExtensionsClientSet apiextcs.Interface

	ACMEURL string

	// Namespace in which all test resources should reside
	Namespace *v1.Namespace
	// contains filtered or unexported fields
}

Framework supports common operations used by e2e tests; it will keep a client & a namespace for you.

func NewDefaultFramework

func NewDefaultFramework(baseName string) *Framework

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

func (*Framework) AfterEach

func (f *Framework) AfterEach()

AfterEach deletes the namespace, after reading its events.

func (*Framework) BeforeEach

func (f *Framework) BeforeEach()

BeforeEach gets a client and makes a namespace.

type TestContextType

type TestContextType struct {
	KubeHost    string
	KubeConfig  string
	KubeContext string

	CertManagerHost    string
	CertManagerConfig  string
	CertManagerContext string

	BoulderImageRepo string
	BoulderImageTag  string
	ACMEURL          string
}

var TestContext TestContextType